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

Objectif de cet article

Découvrez les questions fréquemment posées sur les objets personnalisés dans Klaviyo. Si vous ne trouvez pas votre question dans les ressources ci-dessous, veuillez communiquer auprès de notre communauté forum.

Questions générales sur les objets

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

Oui, ces fonctionnalités dépendent de l'utilisation de l'API pour envoyer des données sources et finalement créer des objets.

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

Klaviyo demande actuellement aux comptes de créer 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 de plusieurs à un entre la catégorie que votre objet personnalisé représente et votre profil. Par exemple, si vous souhaitez conserver des informations sur les animaux de compagnie de vos clients, et que ceux-ci peuvent en avoir plusieurs, il est préférable de les représenter sous la forme d'un objet personnalisé plutôt que sous la forme de propriétés de profil ou d'événements.

Pour tracking des éléments tels qu'un statut de membre, où un profil ne peut avoir qu'un seul statut à la fois, les propriétés de profil conviennent mieux. Toutefois, si vous souhaitez également obtenir d'autres informations sur l'appartenance à un profil, un objet peut s'avérer plus efficace. 

Pour tracking, nous vous recommandons d'utiliser des événements lorsque vous souhaitez obtenir des informations générales, comme le nombre de fois qu'un destinataire a ouvert un courrier électronique.

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, lisez la section relative à la mise à jour d'un objet personnalisé. 

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

Les événements sont destinés à déclencher rapidement des flux, ce qui vous permet d'envoyer des messages pertinents en temps voulu. Lorsque l'état 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 modèle avec les informations sur l'objet dans le flux déclenché par l'événement. Il y a deux façons d'y parvenir : 

1. Utilisez l'outil {{ event }} tag pour ajouter des propriétés pertinentes dans les métadonnées de votre événement afin de les utiliser dans votre modèle. Cette méthode fonctionne bien lorsqu'il est important de respecter les délais.
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 {% customobject id={{ event.pet_id }} as pet %}. Toutefois, la mise à jour des propriétés de l'objet peut prendre un certain temps, de sorte qu'il est possible que le flux ait déclenché l'envoi d'un message avant la mise à jour de l'objet.

Questions sur l'envoi de données relatives aux objets 

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 les enregistrements de votre source de données à Klaviyo via l'API.
4. Créez votre objet personnalisé.
5. Créez la relation entre votre objet personnalisé et votre profil.

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 demande API. Cela permet à Klaviyo d'identifier les sources de données, en particulier dans les cas où un compte a plusieurs sources de données (par exemple, 1 pour chaque intégration personnalisée, entrepôt de données, ou intégrations personnalisées de tiers sur lesquelles la marque s'appuie pour ses activités).

Avec cet identifiant unique, votre développeur peut alors créer des enregistrements de sources de données via l'API de Klaviyo.

Comment dois-je formater mes données ?

Votre développeur devra envoyer des données formatées 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 segmentation et l'opérateur "contains" de filtre de flux pour filtrer les valeurs de cette chaîne séparée par des virgules. Pour plus d'informations sur le filtrage, reportez-vous à la référence des conditions desegment .  

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

• Texte
• Entier
• Décimale
• Date - Toutes les dates sont converties en UTC dans notre système. Par exemple, si vous téléchargez "2025-04-03", il est converti en "2025-04-03 00:00:00". Pour les clients dont le fuseau horaire est avancé de trois heures, la date sera "2025-04-02 21:00:00".
• Booléen

Le type de données "liste" n'est pas pris en charge actuellement. Pour un exemple de charge utile pour l'enregistrement de source de données API, voir 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 télécharger un maximum de 2 Ko par propriété et de 8 Ko par enregistrement total.

Puis-je cartographier 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 profondément imbriquées ou utilisent une liste, vous devrez saisir manuellement le chemin JSON dans le gestionnaire d'objets. Dans le cas d'une liste, vous ne pouvez associer 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 deux ou plusieurs identifiants de profil (par exemple, l'adresse électronique et le numéro de téléphone) pour associer vos enregistrements d'objets personnalisés à un profil, assurez-vous d'inclure ces deux propriétés dans chaque synchronisation, même si la valeur de l'une d'entre elles est nulle.  

Questions sur l'utilisation d'objets avec des flux 

Puis-je utiliser le fractionnement de déclenchement ou le filtrage de déclenchement pour le flux déclenché par la date ?

Pour l'instant, il n'est pas possible de créer un fractionnement et un filtrage des déclencheurs pour les flux déclenchés par la date.

Si mon objet n'a pas déclenché de flux et que je n'ai pas d'objet id provenant d'un événement, puis-je quand même personnaliser mon message ?

Oui, vous pouvez utiliser le filtre d'objets pour trouver le bon objet lors de la personnalisation de votre messagerie. 

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

Pour l'instant, il n'est pas possible d'utiliser la fonction de prévisualisation dans l'application pour visualiser un message lorsque vous utilisez la balise {{ object }} tag.

Pour tester un message de flux :

1. Créez un flux déclenché par une date et mettez-le en ligne.
2. Créez un profil avec un objet dont la date se déclenchera dans au moins 24 heures.

Puis-je mettre à jour mes objets en utilisant des actions de flux comme le webhook et le code Klaviyo?

Pour l'instant, nous vous conseillons de mettre à jour votre source de données originale d'abord et d'envoyer ensuite l'objet révisé retour à Klaviyo dans le format autorisé. Si ces deux systèmes ne sont pas synchronisés, vous risquez d'envoyer un retour d'enregistrement périmé à Klaviyo à partir de votre système, ce qui le ramènerait à sa valeur initiale.