API JavaScript
Le guide suivant vous aidera à configurer et à utiliser l'API JavaScript. Si vous envisagez une intégration complète du commerce électronique, veuillez consulter ce guide.
Note
Pour utiliser les snippets Klaviyo fournis ci-dessous, vous devrez mettre à jour l'espace réservé à API_KEY avec votre clé d'API publique, qui peut être trouvée ici.
Ajouter le snippet Klaviyo
Pour commencer à suivre les personnes, ajoutez l'extrait ci-dessous à droite dans le modèle principal de votre site web afin qu'il soit automatiquement ajouté à chaque page de votre site web. Si vous avez un développeur qui ajoutera ce script à votre site web, vous pouvez lui envoyer un lien vers ce guide.
Vous devez apporter une modification à l'extrait. Si vous êtes une entreprise de commerce électronique, supprimez les quatre lignes contenant l'appel "identifier". Si vous êtes un site web ou une application web à laquelle les gens se connectent, remplacez l'espace réservé {{ email }} par la variable de modèle appropriée qui contient l'adresse électronique de l'utilisateur connecté.
Nous vous suggérons de placer le code Klaviyo au bas ou près du bas de votre modèle de site. Si vous utilisez Google Analytics ou d'autres services tiers, vous pouvez placer le code Klaviyo directement au-dessus ou en dessous.
Vous vous demandez peut-être : "Comment l'utilisation de Klaviyo affecte-t-elle les performances de mon site ?" La réponse est que Klaviyo n'affecte en rien les performances de votre site web. Notre code ne se charge qu'une fois que le reste de votre site web a fini de se charger. En outre, Klaviyo demande aux navigateurs de mettre en cache notre JavaScript, de sorte que vos visiteurs n'ont souvent pas besoin de télécharger notre JavaScript chaque fois qu'ils changent de page.
Vérifiez votre script
Une fois que vous avez ajouté le JavaScript à votre site web, vous pouvez vérifier qu'il est correctement configuré en saisissant l'URL de votre site web à droite.
Une fois le script installé sur votre site web, Klaviyo commencera à suivre les visites et les sessions sur votre site web en temps réel.
Principes de base de l'API
Pour faire des appels à l'API Klaviyo et stocker des informations sur les personnes, vous utiliserez l'objet _learnq qui est automatiquement ajouté par le script Klaviyo.
Pour effectuer un appel API, Klaviyo utilise une syntaxe spéciale qui permet à vos appels API de fonctionner même si notre script n'a pas encore été chargé sur la page. Vous allez créer un tableau dont la première valeur est le nom de la méthode que vous voulez appeler et les valeurs suivantes sont des arguments à passer à cette méthode.
Identifier les personnes
La méthode d'identification vous permet d'identifier et de définir les propriétés d'un individu. Cette méthode accepte un dictionnaire ou un hachage de propriétés. Lorsque vous identifiez quelqu'un, vous devez inclure soit son adresse électronique, avec la clé $email, soit un identifiant unique tel que son numéro d'utilisateur, avec la clé $id.
Une fois que vous avez inclus au moins un de ces identifiants, vous êtes libre d'ajouter les propriétés personnalisées que vous souhaitez. Les propriétés personnalisées sont utiles pour suivre les faits concernant les individus. Dans Klaviyo, vous pouvez ensuite créer des segments de personnes sur la base de ces propriétés. Par exemple, vous pourriez vouloir suivre le type de régime ou la date d'inscription d'un individu. Klaviyo comprendra également les différents types de données que vous utilisez, alors n'hésitez pas à utiliser des nombres, des booléens et des dates.
Klaviyo possède quelques propriétés spéciales qui sont utilisées pour afficher des informations sur les personnes. Il s'agit des éléments suivants : $first_name, $last_name, $phone_number, $title et $organization.
En plus des propriétés que vous suivez, Klaviyo déterminera automatiquement le site web à partir duquel chaque personne a été référencée pour le suivi de l'attribution et l'emplacement d'une personne en fonction de l'endroit où elle a accédé à votre site web.
Exemple de code :
Suivi des événements et des actions
La méthode de suivi vous permet d'enregistrer les événements et les actions des internautes sur votre site web. Cette méthode accepte une chaîne de caractères qui est le nom que vous donnez à cet événement. Cette méthode accepte également un dictionnaire ou un hachage facultatif de propriétés associées à cet événement.
Par exemple, vous pouvez suivre l'achat d'un article par une personne et inclure des informations sur le prix d'achat et les articles achetés. Si vous avez une application où les gens ont des profils, vous pouvez suivre le moment où quelqu'un remplit son profil. Si vous envisagez une intégration complète du commerce électronique, veuillez consulter ce guide.
Les fonctions de suivi des événements et d'analyse de Klaviyo sont très souples, ce qui vous permet de les personnaliser pour suivre ce qui est important pour votre entreprise. Notre méthode de suivi comprend également différents types de données. Vous pouvez donc utiliser des nombres, des booléens et des dates et nous créerons des diagrammes et des graphiques intelligents basés sur les données que vous envoyez.
Exemple de code :