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 ?

Oui, cette fonctionnalité dépend de l’utilisation d’ API pour envoyer des sources de données et, à terme, créer des objets.

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

Klaviyo exige actuellement que les comptes créent de nouveaux objets personnalisés en nous envoyant des données via l’API.

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, les propriétés de profil sont plus adaptées. Cependant, si vous souhaitez également stocker d’autres détails sur l’appartenance d’un profil, un objet peut mieux convenir.

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 toujours ajouter des propriétés supplémentaires non obligatoires à votre objet personnalisé. 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. Utilisez le tag {{ event }} pour ajouter des propriétés pertinentes dans les métadonnées de votre événement, afin de les utiliser dans votre modèle. Cela fonctionne bien lorsque le timing est important.
2. Incluez l’ID de l’objet dans les métadonnées de l’événement, ce qui vous permet d’obtenir l’objet dans le modèle avec le {% customobject id={{ event.pet_id }} as pet %}. Cependant, la mise à jour de l’objet avec les dernières propriétés peut prendre un certain temps. Il est donc possible que le flux ait déclenché l’envoi d’un message avant que l’objet ne soit mis à jour.

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 (voir l’exemple JSON).
3. Envoyez vos enregistrements de sources de données vers Klaviyo via l’ API.
4. Créer votre objet personnalisé.
5. Créez la relation entre votre objet personnalisé et vos profils.

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

Après avoir créé une nouvelle source de données, Klaviyo renverra un identifiant unique dans le cadre de la réponse à votre requête API. Cela permet à Klaviyo d’identifier les sources de données, en particulier dans les cas où un compte comporte plusieurs sources de données (par exemple, 1 pour chaque intégrations personnalisée, entrepôt de données ou intégrations personnalisée d’un tiers 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. Nous vous recommandons d’envoyer vos données sous forme de texte avec une liste séparée par des virgules. Vous pourrez utiliser l’opérateur « contains » de la segmentation et du filtre de flux pour filtrer les valeurs de cette chaîne séparée par des virgules. Consultez la référence sur les conditions de segment pour en savoir plus sur le filtrage. 

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

• Message texte
• Entier
• Décimale
• Date - Dans notre système, toutes les dates et heures sont converties en UTC. Par exemple, si vous importez « 2025-04-03 », la date est convertie en « 2025-04-03 00:00:00 ». Pour les clients ayant un fuseau horaire avec trois heures d’avance, la date et l’heure s’afficheraient comme suit : « 2025-04-02 21:00:00 ».
• Booléen

Le type de données Liste n’est actuellement pas pris en charge. 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 ?

Vous pouvez importer un maximum de 2 KB par propriété et de 8 KB par enregistrement total.

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é. Si vos données sources sont fortement imbriquées ou utilisent une liste, vous devrez saisir manuellement le chemin JSON dans le gestionnaire d’objets. Pour les listes, vous ne pouvez mapper une propriété qu’à une position dans cette liste (par exemple, la première ou la deuxième valeur).

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 ?

Pour le moment, il n’est pas possible d’utiliser la fonction d’aperçu dans l’application pour afficher un message lorsque vous utilisez le tag {{ object }}.

Pour tester un message de flux :

1. Créez un flux déclenché par date et définissez-le comme actif.
2. Créez un profil avec un objet qui contient une date qui se déclenchera dans au moins 24 heures.

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.