Questions fréquemment posées sur les objets personnalisés

Objectif de cet article

Découvrez les questions fréquemment posées concernant les objets personnalisés dans Klaviyo. Si vous ne trouvez pas de réponse à votre question dans la ressource ci-dessous, veuillez nous contacter sur notre forum de la Communauté.

Questions d’ordre général sur les objets

Ai-je besoin d’un développeur pour créer un objet ?

Vous avez besoin d’un développeur pour envoyer des données personnalisées via des API. Vous pouvez créer la source de données et configurer l’objet dans Klaviyo.

Puis-je créer des objets personnalisés à l’aide des formulaires Klaviyo ou de chargements CSV ?

Les formulaires Klaviyo et les importations CSV n’envoient pas d’enregistrements d’objets personnalisés. Utilisez l’API pour envoyer vos données personnalisées, puis associez-les à un objet dans Klaviyo.

Quand dois-je utiliser un objet personnalisé plutôt qu’une propriété de profil ou un évènement ?

Vous devez utiliser des objets personnalisés lorsque vous avez une relation plusieurs-à-un entre la catégorie que représente votre objet personnalisé et vos profils. Par exemple, si vous souhaitez conserver des informations sur les animaux de compagnie de votre client et que votre client peut avoir plusieurs animaux, les représenter sous forme d’objet personnalisé fonctionne bien mieux que les propriétés de profil ou les événements.

Lors du tracking d’éléments tels qu’un statut d’adhésion, où un profil ne peut avoir qu’un seul statut à la fois, une propriété de profil est plus adaptée. Cependant, si vous souhaitez également stocker d’autres informations sur l’adhésion d’un profil, un objet peut être plus adapté.

Lorsque vous effectuez un tracking sur un élément général, par exemple le nombre de fois qu’un destinataire a ouvert un e-mail, nous vous recommandons d’utiliser des événements.

Puis-je mettre à jour mon objet personnalisé après sa création ?

Oui, vous pouvez ajouter des propriétés non obligatoires jusqu’à la limite de propriétés d’objets de votre compte. Pour en savoir plus, consultez la mise à jour d’un objet personnalisé.

Quand dois-je émettre un événement plutôt que mettre à jour les propriétés de l’objet personnalisé ?

Les événements sont conçus pour déclencher rapidement des flux, ce qui vous permet d’envoyer des messages opportuns et pertinents. Lorsque le statut d’un objet change et que vous souhaitez déclencher un message en conséquence, vous devez mettre à jour l’objet avec les nouvelles informations et nous envoyer un événement pour déclencher le flux.

Vous pouvez personnaliser des modèles avec les informations de l’objet dans le flux déclenché par un événement. Il existe deux façons de procéder :

1. Incluez les propriétés dont vous avez besoin dans les données d’événement, puis référencez-les dans votre modèle. Par exemple, si l’événement inclut une propriété pet_name, utilisez {{ event.pet_name }}. Cela fonctionne bien lorsque la rapidité est importante.
2. Incluez l’ID de l’objet dans les données de l’événement, puis récupérez l’objet dans le modèle. Pour un objet nommé Pet, avec une propriété Name et une propriété d’événement nommée pet_id, utilisez {% customobject event.pet_id object_type_title="Pet" as pet %}{{ pet.Name }}{% endcustomobject %}. Remplacez ces noms par les noms de votre propre objet, propriété et champ d’événement. Les mises à jour d’objets peuvent mettre du temps à devenir disponibles, donc un message de flux peut être envoyé avant que l’objet n’ait les dernières valeurs.

Questions sur l’envoi des données d’objet

Comment puis-je commencer à envoyer mes données pour les objets personnalisés ?

1. Créez une nouvelle source de données à l’aide de notre API.
2. Définissez votre structure de données à l’aide de l’exemple de fichier JSON dans Créer en masse des enregistrements de source de données.
3. Envoyez vos enregistrements de sources de données vers Klaviyo via l’ API.
4. Créer votre objet personnalisé à l’aide de cette source de données. Choisissez un ID d’objet unique et mappez les propriétés que vous souhaitez utiliser.
5. Créez la relation entre votre objet personnalisé et vos profils en associant les identifiants de profil dans vos données, comme l’e-mail ou le numéro de téléphone.
6. Vérifiez vos mappages, cliquez sur Créer un objet, puis cliquez à nouveau sur Créer un objet pour confirmer.

Comment les sources de données sont-elles créées et utilisées ?

Lorsque vous créez une source de données via l’API, Klaviyo renvoie un identifiant unique dans la réponse à votre requête API. Cela permet à Klaviyo d’identifier des sources de données, en particulier dans les cas où un compte possède plusieurs sources de données (par exemple, 1 pour chaque intégration personnalisée, entrepôt de données ou intégration personnalisée tierce sur laquelle la marque s’appuie pour son activité).

Grâce à cet identifiant unique, votre développeur peut ensuite créer des enregistrements de source de données via l’API de Klaviyo.

Comment dois-je formater mes données ?

Votre développeur devra envoyer des données au format JSON à Klaviyo. Pour une propriété avec plusieurs valeurs de texte, envoyez un tableau de chaînes de caractères et associez-le à List (Text). Vous pouvez filtrer ces valeurs dans les segments et les flux. Consultez la référence des conditions de segment pour plus d’informations sur le filtrage.

Types de données pris en charge dans les objets personnalisés :

• Message texte
• Nombre (entier)
• Nombre (décimal)
• Horodatage: les dates et les heures sont stockées en UTC. Une valeur sans fuseau horaire, telle que 2025-04-03, est traitée comme 2025-04-03 00:00:00 UTC. Une valeur avec un décalage, telle que 2025-04-03T00:00:00+03:00, est convertie en 2025-04-02 21:00:00 UTC.
• Booléen
• Liste (texte)

List (Text) prend en charge les tableaux de chaînes, tels que ["dog", "cat"]. Il ne prend pas en charge les tableaux de nombres, les listes imbriquées ou les objets. Pour un exemple de charge utile pour l’API d’enregistrement de source de données, consultez Création en masse d’enregistrements de source de données.

Quelles sont les limites de données pour les objets personnalisés ?

Chaque propriété d’objet personnalisé mappée peut contenir jusqu’à 2 KB, et chaque enregistrement d’objet personnalisé mappé peut contenir jusqu’à 8 KB.

Puis-je effectuer un mappage avec des données imbriquées ?

Nous vous recommandons de définir votre objet JSON sans imbriquer les propriétés que vous souhaitez utiliser pour votre objet personnalisé. Pour les données imbriquées, sélectionnez une propriété dans le menu déroulant Propriété de la source de données, ou saisissez son chemin JSON manuellement. Pour une liste de valeurs textuelles, mappez la liste elle-même comme Liste (Texte). Pour mapper un seul élément d’un tableau, utilisez sa position, par exemple [0] pour le 1er élément ou [1] pour le 2e.

Puis-je associer plusieurs identifiants à un profil ?

Oui, si vous souhaitez utiliser 2 identifiants de profil ou plus (p. ex., l’e-mail et le numéro de téléphone) pour associer vos enregistrements d’objets personnalisés à un profil, veillez à inclure ces deux propriétés dans chaque synchronisation, même si la valeur de l’une d’elles est nulle. 

Questions sur l’utilisation d’objets avec les flux

Si mon objet n’a pas déclenché de flux et que je n’ai pas d’ID d’objet à partir d’un événement, puis-je tout de même personnaliser mes messages ?

Oui, vous pouvez utiliser des filtres d’objet pour trouver le bon objet lors de la personnalisation de votre messagerie.

Puis-je prévisualiser les messages d’un flux lorsqu’un objet déclenche un flux ?

Oui. Vous pouvez prévisualiser les messages qui utilisent les données {{ object }} dans un flux déclenché à une date, basé sur un objet personnalisé, avant de mettre le flux en ligne.

Pour prévisualiser un e-mail :

1. Ouvrez un e-mail dans un flux déclenché par une date basé sur un objet personnalisé, puis cliquez sur Aperçu dans l’éditeur d’e-mail.
2. Sélectionnez un profil associé à un enregistrement pour cet objet, puis examinez le message personnalisé.

L’aperçu utilise un objet d’exemple associé au profil sélectionné. Si aucun n’est disponible, il utilise un enregistrement d’exemple du même type d’objet. Vérifiez les valeurs affichées : l’aperçu ne confirme pas quel enregistrement déclenchera le flux. Si aucun enregistrement n’est disponible, il n’y a aucune donnée d’objet à prévisualiser.

Puis-je mettre à jour mes objets à l’aide d’actions de flux comme des webhook et du code Klaviyo ?

À ce stade, nous vous conseillons de mettre à jour d’abord votre source de données d’origine, puis de renvoyer l’objet révisé à Klaviyo dans le format autorisé. Si ces deux systèmes ne sont plus synchronisés, vous risquez de renvoyer à Klaviyo depuis votre système un enregistrement obsolète, ce qui le rétablira à sa valeur d’origine.