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 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 limites d'objets pour votre compte dépendent des limites de profil de votre compte et du fait que vous ayez ou non un abonnement Advanced Klaviyo Data Platform. Au minimum, l'accès à ces fonctionnalités nécessite un abonnement e-mail payant ou une version d'essai de Klaviyo Data Platform, que vous pouvez demander par l'intermédiaire de votre CSM. Si vous opérez au sein d'une famille de comptes, vos limites refléteront celles d'un abonnement Advanced Klaviyo Data Platform. Pour en savoir plus sur la facturation, voyez comment fonctionne la facturation partagée dans Klaviyo.
Les objets personnalisés ont 3 ensembles de limites de compte :
-
Limite d’objet
Nombre total d’objets qu’un compte peut contenir. -
Limites des propriétés de l’objet
Le nombre de propriétés qu’un compte peut avoir par objet.
-
Limites d’enregistrement 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.
Si vous êtes abonné à la plateforme de données avancée Klaviyo, le multiplicateur d'enregistrements d'objets sera basé sur le nombre total de profils sur votre compte. Si vous n'avez qu'un abonnement par e-mail, ce multiplicateur sera basé sur la limite de profil actif de votre compte.
| Profils | Abonnement KDP avancé | Nombre d’objets | Nombre de propriétés d’objet | Multiplicateur d’enregistrement d’objet |
| Abonnement gratuit | Aucun | 0 | 0 | s/o |
| 250 - 400 000 | Aucun | 1 | 15 | x 10 |
| payant | 5 | 30 | x 10 | |
| Plus de 400 000 | Aucun | x 10 | ||
| payant | x 10 |
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, sélectionnez 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 de données
Source de données à partir de laquelle obtenir des données d’objet. Au moins 1 enregistrement doit être envoyé à Klaviyo à l'aide de l'objet personnalisé API pour qu'il apparaisse comme une option dans le menu déroulant.Â
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'identifiant d'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 carte cadeau, vous pouvez utiliser quelque chose comme le code de réduction unique comme identifiant d’objet. Il 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 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’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.
Lorsque vous envoyez des numéros de téléphone, ils doivent être au format E.164. Lorsque vous envoyez des dates, elles doivent être dans l’un de nos formats d’horodatage acceptés.
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.
Seules les données affichées dans l'instance particulière de la source de données en cours de prévisualisation sont disponibles dans la liste déroulante. Vous pouvez parcourir les instances de la source de données à l'aide du bouton Nouvel échantillon de données .
Cependant, nous vous recommandons d’envoyer les données relatives aux objets via l’API d’ingestion d’objets 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 lui attribuer une valeur nulle.
Pour mapper les propriétés d'un objet :
- 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.
- 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.
- Dans la colonne type de données, sélectionnez le type de données approprié pour votre propriété source de données.
- Dans la colonne Requis, cochez la case si vous souhaitez que cette propriété soit requise dans l'objet.
- Sélectionnez le bouton Ajouter un mappage si vous avez besoin de mapper des propriétés d'objets supplémentaires.
Si une propriété d'objet est définie comme requise, elle doit exister dans la source de données et ne peut pas avoir une valeur nulle. Si la propriété requise n'est pas présente, l'enregistrement de l'objet ne sera pas créé.
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 »: « data-source-record », « attributes »: { « record »: { « child »: { « child_id »: « d64b8458 », « name »: {
"first": "Theodore",
"last": "Customer"
}, « birth_date »: « 2022-04-12 », « email »: « jon.customer@klaviyo.com »,
« numéros_de_téléphone » : [ « +11234567899 », « +13456789123 » ] } } } }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
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 (e-mail, numéro de téléphone, etc.). Il 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 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 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 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
Toute modification apportée à un objet personnalisé entraîne une modification de l'objet personnalisé actif.
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 :
- Cliquez sur Content > Objects dans la barre latérale de Klaviyo.
- Sélectionnez le nom de l'objet que vous souhaitez modifier.
- Cliquez sur Suivant dans le coin supérieur droit.
-
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.
- 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.
- 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.
-
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.
- Cliquez sur Suivant dans le coin supérieur droit.
- Cliquez sur Suivant dans le coin supérieur droit. Vous n'aurez pas à modifier vos relations.
- 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
Une fois que vous avez supprimé un objet, il est impossible de le récupérer ou de l'annuler. Tout segment, flux, modèle ou campagne utilisant ces objets personnalisés ne fonctionnera plus comme prévu.
Pour supprimer un objet :
- Cliquez sur Content > Objects dans la barre latérale de Klaviyo.
- Dans le menu à droite de votre objet, cliquez sur Supprimer.
- Cliquez à nouveau sur Supprimer pour confirmer la suppression de l'objet.
- 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