Démarrer avec les objets personnalisés

Objectif de cet article

Découvrez les objets personnalisés, comment configurer un objet et comment les utiliser dans Klaviyo.

Avant de commencer

Vous devez avoir accès aux objets personnalisés pour utiliser cette fonctionnalité. 

Qu’est-ce qu’un objet personnalisé ?

Les objets personnalisés sont un type de structure de données dans Klaviyo qui vous permettent de mapper divers concepts de données multirelationnels qui ne peuvent pas être stockés à l’aide de propriétés de profil. Par exemple, supposons que vous souhaitiez stocker dans Klaviyo des données sur les animaux de compagnie de vos clients. Chaque animal de compagnie a un certain nombre de attributs (par exemple, le nom, l’âge, la race, le nom, l’âge, la race, etc.). etc.), ce qui rend difficile le stockage de ces informations avec les propriétés de profil lorsque ce profil a plusieurs animaux de compagnie. 

Vous pouvez ensuite utiliser ces données d’objet dans les flux, les modèles et les segments de Klaviyo pour mieux personnaliser vos communications marketing. 

Exemples de cas d’utilisation

Vous trouverez ci-dessous quelques exemples qui illustrent la flexibilité des objets personnalisés dans les données que vous pouvez stocker dans Klaviyo. 

Rendez-vous

Si vous êtes une entreprise où les clients peuvent planifier des rendez-vous, vous pouvez utiliser un objet Rendez-vous pour stocker les données de rendez-vous des profils.  

Dans chaque enregistrement d’objet pour l’objet Rendez-vous, voici quelques exemples de données que vous pouvez inclure :

• Identifiant de rendez-vous 
• Date de rendez-vous
• Personne de rendez-vous (par exemple, un spécialiste de la formation, un spécialiste, etc.)
• Lieu de rendez-vous
• Type de rendez-vous 

Les profils peuvent avoir plusieurs enregistrements d’objets s’ils ont plusieurs rendez-vous, et vous pouvez utiliser les données de ces objets pour créer des segments et envoyer des messages et des flux personnalisés. 

abonnement 

Si vous êtes une entreprise où les clients peuvent s’inscrire à un abonnement, vous pouvez utiliser un objet Abonnement pour stocker les données d’abonnement des profils.  

Dans chaque enregistrement d’objet pour l’objet Abonnement, vous trouverez quelques exemples de données que vous pouvez inclure :

• Identifiant de l’abonnement 
• Produit d’abonnement
• Prix de l’abonnement
• Statut de l’abonnement 
• Prochaine date de facturation

Les profils peuvent avoir plusieurs enregistrements d’objets s’ils ont plusieurs abonnements, et vous pouvez utiliser les données de ces objets pour créer des segments et envoyer des messages et des flux personnalisés. 

Réservation

Si vous êtes une entreprise où les clients peuvent réserver des réservations, vous pouvez utiliser un objet Réservation pour stocker les données de réservation pour les profils.  

Dans chaque enregistrement d’objet pour l’objet Réservation, voici quelques exemples de données que vous pouvez inclure :

• Identifiant de la réservation
• Date de réservation
• Lieu de réservation
• Événement de réservation 
• Nombre d’invités sur réservation 

Les profils peuvent avoir plusieurs enregistrements d’objets s’ils ont plusieurs réservations, et vous pouvez utiliser les données de ces objets pour créer des segments et envoyer des messages et des flux personnalisés. 

animal de compagnie

Si vous utilisez une entreprise pour gérer des animaux de compagnie, vous pouvez utiliser un objet Pet pour stocker les données sur les animaux des profils.  

Dans chaque enregistrement d’objet pour l’objet Pet, vous trouverez quelques exemples de données que vous pouvez inclure :

• Identifiant de microchip pour animaux de compagnie
• Nom de l’animal de compagnie 
• Type d’animal de compagnie (par exemple, chien ou chat)
• Aucune race d’animal de compagnie
• Anniversaire pour animaux de compagnie 

Les profils peuvent avoir plusieurs enregistrements d’objets s’ils ont plusieurs animaux de compagnie, et vous pouvez utiliser les données de ces objets pour créer des segments et envoyer des messages et des flux personnalisés. 

Limites du compte 

Les objets personnalisés ont 3 ensembles de limites de compte : 

• Limite d'objets
  Nombre total d'objets qu'un compte peut avoir.
• Limites des propriétés d’objets 
  Le nombre de propriétés qu’un compte peut avoir par objet.
  
• Limites d'enregistrements d'objets
  Nombre d'enregistrements d'objets autorisés pour un compte.

Le nombre d'objets et d'enregistrements d'objets disponibles est basé sur le nombre total de profils actifs dans tous vos comptes. Les limites d'enregistrement sont communes à tous les comptes, tandis que les limites d'objet s'appliquent à chaque compte séparément. 

Par exemple, si vous avez une famille de comptes avec 5 comptes enfants où chaque compte a 100 000 profil actif, votre total de profil actif est égal à 500 000. Comme le montre le graphique ci-dessous, les comptes avec plus de 400 000 profils ont un multiplicateur d'enregistrements d'objets de 10. Par conséquent, ces comptes ne peuvent pas contenir plus de 5 millions d'enregistrements (500 000 x 10). Cela signifie que vous pouvez avoir un compte avec 3 millions d'enregistrements tant que les 4 autres comptes ont moins de 2 millions d'enregistrements d'objets combinés. En ce qui concerne le nombre d'objets par compte, étant donné que le nombre de profils combinés est supérieur à 400 000, chaque compte peut avoir jusqu'à 5 objets.

En outre, tous les comptes ont les limites suivantes : 

• Maximisez 500 enregistrements par profil par objet.
• Chaque objet personnalisé ne doit pas dépasser 8 Ko.
• Chaque enregistrement d'objet personnalisé ne doit pas dépasser 2 Ko.

Créer un objet 

Pour commencer à créer un objet dans Klaviyo, naviguez vers Content > Objects. 

Suivez les étapes pour créer et synchroniser une source de données pour votre objet personnalisé. Une fois ces étapes terminées, cliquez sur le bouton Créer un objet personnalisé pour créer l'objet. 

À partir de là, vous pouvez soit créer un objet à partir de zéro, soit sélectionner un modèle d'objet recommandé. Pour créer un objet à partir de zéro, sélectionnez le bouton Construire votre propre objet.

La première partie de la création d'un objet flux de travail consiste à définir les informations suivantes pour votre objet :

• Nom
  Un nom pour identifier votre objet
• Description (facultatif)
  Une description des données que votre objet représente
• source des données
  La source de données à partir de laquelle les données de l'objet doivent être obtenues. Au moins un enregistrement doit être envoyé à Klaviyo à l'aide de l'API de l'objet personnalisé pour qu'il apparaisse en tant qu'option dans la liste déroulante. 

Définir l'ID de l'objet

Une fois que vous avez donné un nom à votre objet et choisi la source de données, l'étape suivante consiste à définir un identifiant d'objet et à mapper les propriétés souhaitées de l'objet. Au cours de cette étape, vous pourrez prévisualiser les données associées à la source de données qui ont été envoyées à Klaviyo par l'intermédiaire de l'API des objets personnalisés.

La définition de l'ID de l'objet est nécessaire pour distinguer les enregistrements d'objets les uns des autres. Vous devrez spécifier une propriété de la source de données à utiliser pour l'identifiant unique de l'objet. 

L'ID de l'objet doit être une propriété unique de la source de données qui peut être utilisée pour identifier des instances spécifiques d'un enregistrement d'objet. Par exemple, dans le cas d'un objet carte cadeau, vous pouvez utiliser un code de réduction unique comme identifiant de l'objet. Il est unique pour chaque instance de la source de données et existe pour chaque enregistrement d'objet. 

Chaque fois que Klaviyo reçoit des données de votre source de données avec le même ID d'objet, l'enregistrement de l'objet associé sera mis à jour. C'est pourquoi il est important que l'identifiant de l'objet soit unique afin que l'enregistrement approprié soit mis à jour.

Envoyer les données de l'objet

Lorsque vous mettez à jour un enregistrement d'objet existant, l'objet entier est remplacé. Il est donc essentiel d'envoyer l'objet complet à chaque fois, même si vous ne souhaitez mettre à jour qu'un seul enregistrement. 

Par exemple, supposons que vous souhaitiez mettre à jour un seul des cinq enregistrements d'un objet. Si vous envoyez des données de mise à jour avec l'ID et seulement l'enregistrement que vous voulez mettre à jour, les 4 autres enregistrements seront mis à zéro. Si l'un des champs devenus nuls était utilisé dans votre relation avec un profil (par exemple, un identifiant de profil tel qu'une adresse électronique), l'objet ne sera plus lié à ce profil.

Propriétés de l'objet carte 

En mappant les propriétés des objets, vous pouvez sélectionner les informations de la source de données qui seront disponibles dans un objet dans Klaviyo.

Cependant, pour cette raison, nous recommandons d'envoyer les données des objets via l'API d'ingestion d'objets dans des formats standardisés. Si la valeur d'une propriété spécifique n'est pas connue, vous pouvez lui attribuer une valeur nulle.

Pour mapper les propriétés d'un objet :

1. Dans la colonne de la propriété source des données, sélectionnez la propriété source des données que vous souhaitez inclure dans votre objet. 
2. Dans la colonne Propriété mappée , saisissez le nom que vous souhaitez donner à la propriété de la source de données dans l'objet. 
3. Dans la colonne type de données, sélectionnez le type de données approprié pour votre propriété source de données.
4. Dans la colonne Requis, cochez la case si vous souhaitez que cette propriété soit requise dans l'objet.
5. Sélectionnez le bouton Ajouter un mappage si vous avez besoin de mapper des propriétés d'objets supplémentaires. 

Données imbriquées dans la cartographie

Par défaut, l'interface du gestionnaire d'objets assiste 1 niveau d'imbrication. Pour accéder à des données plus approfondies, vous devez saisir manuellement le chemin d'accès de votre choix.

A titre d'exemple, regardez la source de données ci-dessous. 

{
   "type" : "données-source-record",
   "attributes" : {
   "record" : {
    "child_id" : "d64b8458",
    "enfant" : { 
     "nom" : {
      “first”: “Theodore”,
      “last”: “Customer”
     }
    }
    "date_de_naissance" : "2022-04-12",
    "e-mail" : "jon.customer@klaviyo.com",
    "phone_numbers" : [
     "+11234567899",
     "+13456789123"
    ]
   }
  }
 }
]

Pour accéder aux données relatives au prénom d'un enfant, vous pouvez saisir le chemin d'accès suivant, car les données sont sinon trop imbriquées pour être accessibles avec l'interface.

Si vous disposez d'un tableau dans vos données sources, vous pouvez trouver les propriétés à cartographier par position. Par exemple, vous pouvez extraire le premier numéro de téléphone du tableau phone_numbers en incluant [0] à la fin de votre chemin. 

Ajouter une relation 

Après avoir défini un identifiant d'objet et mis en correspondance les propriétés de votre objet, l'étape suivante consiste à ajouter une relation à votre objet. 

Les relations relient votre objet à des profils pertinents. Définissez les informations suivantes pour établir une relation : 

• Nom de la relation
  Définissez un nom pour votre relation. Par exemple, si vous avez un objet "animal de compagnie", vous pouvez définir le nom de la relation comme "Propriétaire de l'animal". 
• Source données
  Sélectionnez les propriétés de la source de données que vous souhaitez associer à un profil. 
• identifiant du profil
  Définissez l'identifiant du profil (c'est-à-dire l'adresse électronique, le numéro de téléphone, etc.) Cet identifiant doit figurer dans la source de données pour qu'un objet puisse être associé à un profil. Utilisez le bouton Lier une autre propriété pour ajouter des paires de propriétés et d'identifiants supplémentaires.

Confirmer les mappages et créer un objet

Une fois que vous avez terminé le mappage des propriétés de l'objet et la définition de la relation, confirmez les mappages dans la fenêtre modale de confirmation et cliquez sur le bouton Créer un objet. Notez que les correspondances existantes ne peuvent pas être modifiées une fois que l'objet est créé, et les données commenceront à être synchronisées immédiatement. 

Vous verrez votre objet listé sur la page Objets de Klaviyo, avec les informations suivantes : 

• Nom de l’objet
• Date de création
• Date de la dernière mise à jour
• Statut.

États de statut des objets personnalisés

 La publication d’objets personnalisés comporte trois états : 

• Brouillon
  L’objet est toujours modifiable et n’est ni publié ni actif. 
• Publication
  L’objet crée des enregistrements d’objets personnalisés à partir des données que vous avez envoyées à votre source de données.  Si vous avez envoyé quelques milliers d’enregistrements à partir de votre source de données, votre objet sera publié instantanément. Si vous avez envoyé quelques millions d’enregistrements, leur publication peut prendre des heures. Une fois l’opération terminée, le statut passera à Actif.
• Actif
  L’objet est publié et actif. Tous les enregistrements d’objets personnalisés ont été créés en fonction des données envoyées depuis votre source de données. Toute nouvelle donnée envoyée pour cet objet générera des enregistrements d’objets personnalisés supplémentaires liés à vos profils.

Objets sur les pages de profil

Les objets pertinents apparaîtront également sur une page de profil afin que vous puissiez visualiser les enregistrements d’objets qui se rapportent à un profil. Pour afficher les enregistrements d’objets, accédez à l’onglet Objets d’une page de profil. Vous pouvez passer d’un objet à l’autre en utilisant le menu déroulant situé au-dessus des cartes d’objets. 

Pour afficher un enregistrement complet de l’objet, sélectionnez le menu à trois points et cliquez sur Voir. Un panneau latéral s’affiche avec l’enregistrement complet de l’objet. 

mise à jour d'un objet 

Si vous souhaitez commencer à envoyer de nouvelles données pour un objet, ajoutez les propriétés d'objet supplémentaires à votre source de données, puis modifiez votre mappage d'objet pour inclure cette nouvelle propriété. Tous les objets créés précédemment renverront une valeur nulle pour cette propriété puisque ces données ne sont pas disponibles, mais à l'avenir, les objets seront créés et mis à jour avec cette propriété.

Si vous envoyez de nouvelles propriétés d'objet qui n'ont pas encore été associées à un objet, vous pouvez mettre à jour votre objet personnalisé pour l'inclure. Tous les enregistrements d'objets personnalisés sont ensuite retraités pour inclure ces données.

Mettre à jour un objet :

1. Cliquez sur Content > Objects dans la barre latérale de Klaviyo.
2. Sélectionnez le nom de l'objet que vous souhaitez modifier. 
3. Cliquez sur Suivant dans le coin supérieur droit.
4. Dans la section Propriétés de l'objet de la carte , cliquez sur Ajouter un mappage.

   Cette option n'est disponible que si votre objet possède des propriétés supplémentaires qui peuvent être ajoutées.

5. Dans la colonne de la propriété source des données, sélectionnez la propriété source des données que vous souhaitez inclure dans votre objet. 
6. Dans la colonne Propriété mappée , saisissez le nom que vous souhaitez donner à la propriété de la source de données dans l'objet. 
7. Dans la colonne type de données, sélectionnez le type de données approprié pour votre propriété source de données.

   Les propriétés nouvellement cartographiées ne peuvent pas être marquées comme obligatoires.

   
8. Cliquez sur Suivant dans le coin supérieur droit. 
9. Cliquez sur Suivant dans le coin supérieur droit. Vous n'aurez pas à modifier vos relations.
10. Cliquez sur Publier les modifications.

Une fois ce processus terminé, tous les enregistrements de votre source de données seront retraités et les enregistrements d'objets personnalisés existants seront mis à jour en conséquence. 

Supprimer un objet 

Pour supprimer un objet : 

1. Cliquez sur Content > Objects dans la barre latérale de Klaviyo.
2. Dans le menu à droite de votre objet, cliquez sur Supprimer. 
   
3. Cliquez à nouveau sur Supprimer pour confirmer la suppression de l'objet. 
4. L'objet et tous les enregistrements d'objets personnalisés associés sont supprimés. 

Si vous créez un nouvel objet personnalisé en utilisant la source de données d'un objet précédent, de nouveaux enregistrements d'objets personnalisés seront générés en utilisant les données que vous avez déjà synchronisées. Bien qu'il utilise les mêmes données, il est considéré comme un nouvel objet avec de nouveaux enregistrements, de sorte que tous les segments, flux, modèles et campagnes doivent être mis à jour pour utiliser ce nouvel objet.

Ressources complémentaires 

Comment utiliser les objets personnalisés dans les modèles

Comment utiliser les objets personnalisés dans les segments

Comment utiliser les objets personnalisés dans les flux

Vue d'ensemble de l'API des objets personnalisés