Démarrer avec les objets personnalisés

Découvrez les objets personnalisés, qui vous permettent de stocker et d’associer plusieurs propriétés à un seul « objet ».  Les objets personnalisés vous permettent de mapper divers concepts de données multirelationnelles dans Klaviyo, qui ne peuvent pas être stockés à l’aide de propriétés de profil. Vous pouvez ensuite utiliser des objets personnalisés dans vos messages, segments et plus encore.

En quoi les objets personnalisés sont-ils différents des propriétés de profil ?

Les propriétés de profil sont un excellent moyen de stocker des informations simples. Par exemple, si vous avez une propriété de couleur préférée, vous pouvez stocker la couleur préférée de chaque client.

Mais que faire si vous souhaitez avoir besoin de plus de données ou de plusieurs versions de cette propriété ? Un bon exemple est pour les animaux de compagnie. Vous pouvez utiliser les propriétés de profil pour stocker des éléments tels que le nom, l’âge et la race, mais elles ne peuvent être utilisées qu’une seule fois par profil.

Si quelqu’un a plusieurs animaux de compagnie, vous pouvez utiliser des objets personnalisés. De cette façon, Fluffy le Grand Danois a sa propre carte d'identité digitale pour son nom, son âge, son poids, etc., et Cheeks le hamster a les mêmes informations, mais avec des réponses (très) différentes. 

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 programmer 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 de l’objet Rendez-vous, voici quelques exemples de données que vous pouvez inclure :

• Identifiant du rendez-vous
• Date du rendez-vous
• Rendez-vous (par exemple, un médecin, un instructeur, etc.)
• Lieu du rendez-vous
• Type de rendez-vous

Les profils peuvent avoir plusieurs enregistrements d’objet s’ils ont plusieurs rendez-vous. Vous pouvez utiliser ces données d’objet 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. 

Voici quelques exemples de données que vous pouvez inclure dans chaque enregistrement d’objet de l’objet Abonnement :

• Identifiant d’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. Vous pouvez utiliser ces données d’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, vous pouvez utiliser un objet Réservation pour stocker les données de réservation des profils. 

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

• Identifiant de réservation
• Date de réservation
• Lieu de réservation
• Occasion de réservation
• Nombre d’invités sur la réservation

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

Animal de compagnie

Si vous êtes une entreprise au service des propriétaires d’animaux de compagnie, vous pouvez utiliser un objet Pet pour stocker des données sur les animaux de compagnie des profils. 

Voici quelques exemples de données que vous pouvez inclure dans chaque enregistrement d’objet pour l’objet Pet :

• Identifiant de la puce pour animaux
• Nom de l’animal
• Type d’animal (par exemple, chien ou chat)
• Race pour animaux de compagnie
• Anniversaire de l’animal

Les profils peuvent avoir plusieurs enregistrements d’objets s’ils ont plusieurs animaux de compagnie. Vous pouvez utiliser ces données d’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 de l’objet
  Le nombre de propriétés qu’un compte peut avoir par objet.
• Limites d’enregistrement des 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 sur l’ensemble de vos comptes. Les limites d’enregistrement sont partagées entre tous les comptes, tandis que les limites d’objet s’appliquent séparément à chaque compte.

Par exemple, si vous avez un groupe de comptes avec 5 comptes enfants dont chaque compte compte compte compte compte 100 000 profils actifs, le nombre total de vos profils actifs est égal à 500 000. Comme le montre le graphique ci-dessous, les comptes comportant plus de 400 000 profils ont un multiplicateur d’enregistrement d’objet de 10. Par conséquent, ces comptes peuvent stocker un maximum combiné de 5 millions d’enregistrements (500 000 x 10). Cela signifie que vous pouvez avoir 1 compte avec 3 millions d’enregistrements, à condition que les 4 comptes restants aient moins de 2 millions d’enregistrements d’objets combinés. En ce qui concerne le nombre d’objets par compte, comme le nombre combiné de profils est supérieur à 400 000, chaque compte peut comporter jusqu’à 5 objets.

En outre, tous les comptes ont les limites suivantes :

• Maximum de 500 enregistrements par profil et 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éez un objet

Pour commencer à créer un objet dans Klaviyo, accédez à Contenu > Objets. et cliquez sur Créer un objet.

Vous pouvez alors soit créer un objet de A à Z, soit sélectionner un modèle d’objet recommandé. Pour créer un objet de A à Z, sélectionnez le bouton Créer votre propre objet.

La première partie du flux de travail de création d’objet nécessite de 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 de données
  La source de données où vivent vos données d’objet.

Pour créer une source de données, cliquez sur le menu déroulant Sélectionner une source de données, puis sélectionnez Créer une source de données.

Pour créer une source de données, vous devez définir les informations suivantes :

• Nom
  Un nom unique pour identifier la source de vos données d’objet.
• Description (facultatif)
  Une description de votre source de données.

Définissez l’identifiant de l’objet.

Une fois que vous avez défini un nom pour votre objet et sélectionné la source de données, l’étape suivante consiste à définir un ID d’objet et à mapper les propriétés d’objet souhaitées. 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 via l’ API d’objet personnalisé.

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

L’identifiant de l’objet doit être une propriété de source de données unique qui peut être utilisée pour identifier des instances spécifiques d’un enregistrement d’objet. Par exemple, avec un objet de carte-cadeau, vous pouvez utiliser quelque chose comme le code de réduction unique comme identifiant d’objet. Cette valeur est unique pour chaque instance de la source de données et existera pour chaque enregistrement d’objet.

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

Envoyer des données d’objet

Lorsque vous mettez à jour un enregistrement d’objet existant, l’enregistrement entier est remplacé. Par conséquent, il est essentiel d’envoyer l’ensemble de l’enregistrement d’objet, même si vous ne souhaitez mettre à jour qu’une seule propriété.

Par exemple, supposons que vous ne souhaitiez mettre à jour qu’une seule propriété sur cinq dans un enregistrement. Si vous envoyez des données mises à jour avec l’identifiant et uniquement la propriété que vous souhaitez mettre à jour, les 4 autres propriétés seront définies sur Null. Si l’un des nouveaux champs null a été utilisé dans votre relation de profil (par exemple, un identifiant de profil tel qu’une adresse e-mail), l’objet ne sera plus lié à ce profil.

Mapper des propriétés d’objet

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

Cependant, pour cette raison, nous vous recommandons d’envoyer les données d’objet via l’API d’ingestion d’objet dans des formats de date et d’horodatage standardisés. Si la valeur d’une propriété spécifique n’est pas connue, vous pouvez définir une valeur nulle pour celle-ci.

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

1. Dans la colonne Propriété de source de données, sélectionnez la propriété de source de 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 source de données dans l’objet.
3. Dans la colonne Type de données, sélectionnez le type de données approprié de la propriété de votre source de données.
4. Dans la colonne Obligatoire, cochez la case si vous souhaitez que cette propriété soit obligatoire dans l’objet.
5. Sélectionnez le bouton Ajouter un mappage si vous devez mapper des propriétés d’objet supplémentaires.

Données imbriquées dans le mappage

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

À titre d’exemple, consultez la source de données ci-dessous.

text Copy

{
  "type": "data-source-record",
  "attributes": {
    "record": {
      "child": {
        "child_id": "d64b8458",
        "name": {
          "first": "Theodore",
          "last": "Customer"
        },
        "birth_date": "2022-04-12",
        "email": "jon.customer@klaviyo.com",
        "phone_numbers": [
              "+11234567899",
              "+13456789123"
        ]
      }
    }      
  }
}

Pour accéder aux données sur le prénom d’un enfant, vous pouvez saisir le chemin suivant, car les données sont autrement imbriquées trop loin pour être accessibles avec l’interface.

Si vous avez un tableau dans vos données source, vous pouvez trouver des propriétés à mapper par position. Par exemple, vous pouvez extraire le premier numéro de téléphone du tableau numéros_de_téléphone en incluant [0] à la fin de votre chemin.

Ajouter une relation

Après avoir défini un identifiant d’objet et mappé vos propriétés d’objet, l’étape suivante consiste à ajouter une relation à votre objet.

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

• Nom de la relation
  Donnez un nom à votre relation. Par exemple, si vous avez un objet pour animaux de compagnie, vous pouvez définir le nom de la relation comme « Propriétaire d’un animal de compagnie ».
• Données source
  Sélectionnez les propriétés de source de données que vous souhaitez associer à un profil.
• Identifiant du profil
  Définissez l’ identifiant du profil (c’est-à-dire e-mail, numéro de téléphone, etc.). Cela doit être inclus dans la source de données pour qu’un objet soit associé à un profil. Utilisez le bouton Lier une autre propriété pour ajouter d’autres paires propriété/identifiant.

Confirmer les mappages et créer un objet

Une fois que vous avez terminé de mapper les propriétés de l’objet et de définir la relation, confirmez les mappages dans la fenêtre modale de confirmation et sélectionnez le bouton Créer un objet. Notez que les mappages existants ne peuvent pas être modifiés une fois l’objet créé, et que la synchronisation des données commencera immédiatement.

Vous verrez votre objet répertorié sur la page Objets dans Klaviyo, avec les informations suivantes :

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

États du statut de l’objet personnalisé

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

• Brouillon
  L’objet est toujours modifiable et n’est pas publié ou 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 depuis 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 cette étape 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 voir les enregistrements d’objets qui se rapportent à un profil. Pour afficher les enregistrements d’objets, accédez à l’onglet Objets sur une page de profil. Vous pouvez passer d’un objet à l’autre à l’aide du menu déroulant situé au-dessus des cartes d’objet.

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

Mettre à jour 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 y inclure cette nouvelle propriété. Tous les objets précédemment créés renverront une valeur Null pour cette propriété, car ces données ne sont pas disponibles. Toutefois, 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é mappé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.

Pour mettre à jour un objet :

1. Cliquez sur Contenu > Objets 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 Mapper les propriétés de l’objet , cliquez sur Ajouter un mappage.

1. Dans la colonne Propriété de source de données, sélectionnez la propriété de source de 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 source de données dans l’objet.
3. Dans la colonne Type de données, sélectionnez le type de données approprié pour la propriété de votre source de données.

1. Cliquez sur Suivant dans le coin supérieur droit.
2. Cliquez sur Suivant dans le coin supérieur droit. Vous n’aurez pas à modifier vos relations.
3. 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 Contenu > Objets 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 objet personnalisé à l’aide de la source de données d’un objet précédent, de nouveaux enregistrements d’objets personnalisés seront générés à l’aide des 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. Par conséquent, tous les segments, flux, modèles et campagnes doivent être mis à jour pour utiliser ce nouvel objet.

Ressources supplémentaires