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

Objectif de cet article

Découvrez comment utiliser des objets personnalisés dans les modèles, afin de pouvoir utiliser les données d’objet dans les envois de flux et de campagne.

Vous devez créer un objet avant de pouvoir utiliser des données d’objet personnalisé dans les modèles. Pour le menu de personnalisation, les filtres d’objet, et les listes d’enregistrements de destinataires, utilisez un objet avec une relation de profil. Ses enregistrements doivent être liés au destinataire pour apparaître dans son message.

Accéder aux données d’objet via le menu de personnalisation

Vous pouvez personnaliser des blocs de texte dans l’éditeur de modèles par glisser-déposer en utilisant les propriétés d’un objet personnalisé, ou le nombre d’enregistrements pour un objet.

Découvrez comment utiliser l’éditeur de modèle Klaviyo.

Si vous commencez avec un modèle HTML, vous pouvez d’abord créer une copie par glisser-déposer :

1. Accédez à Contenu > Modèles, puis ouvrez E-mail: enregistrés. Ouvrez le menu à 3 points de votre modèle HTML, puis sélectionnez Cloner vers l’éditeur glisser-déposer.
2. Ouvrez Modèles convertis pour vérifier sa progression. Lorsque le statut est Prêt à être utilisé, cliquez sur le nom du modèle converti pour l’ouvrir.
3. Vérifiez la mise en page du texte et le contenu personnalisé avant de l’utiliser. Le modèle HTML d’origine est inchangé.

Pour commencer à ajouter des données d’objet dans vos modèles :

1. Ajoutez un nouveau bloc de texte ou sélectionnez un bloc de texte existant.
2. Double-cliquez dans le bloc de texte, puis placez votre curseur à l’endroit où vous souhaitez insérer votre propriété dynamique.
3. Sélectionnez le bouton Personalization dans la barre d’outils de texte.

4. Dans la modale de personnalisation, sélectionnez Objets dans la liste déroulante Tous les types .

5. Dans Objets, vous verrez tous les objets de votre compte que vous pouvez utiliser pour extraire des données dans le modèle. Sélectionnez l’objet qui contient les données que vous souhaitez utiliser dans le modèle.
6. Sélectionnez une propriété à afficher ou Nombre d’objets pour afficher un décompte. Ensuite, sélectionnez un filtre d’objet. Vous pouvez également créer un nouveau filtre d’objet ici.
7. Cliquez sur Insérer après avoir sélectionné un filtre existant. Si vous créez un nouveau filtre, son tag est inséré lorsque vous terminez de le créer.
8. Appliquez les styles de texte dont vous avez besoin. Pour une valeur de propriété, ajoutez du texte par défaut en modifiant son tag pour inclure |default:'value'. Remplacez value par le texte que vous souhaitez afficher lorsque la propriété est vide.

Pour spécifier les règles de capitalisation des données d’objet, vous devrez définir manuellement la règle dans le tag de personnalisation. Par exemple, ces tags utilisent l’objet qui a déclenché un flux déclenché par date :

• {{ object.full_name|title|default:'value' }}
  John Doe
• {{ object.full_name|upper|default:'value' }}
  JOHN DOE
• {{ object.full_name|lower|default:'value' }}
  john doe

En savoir plus sur la modification des valeurs avec les filtres Django.

Accéder aux données d’objet avec des tags de personnalisation

Vous pouvez utiliser des tags de personnalisation dans les e-mails (y compris dans l’objet de l’e-mail), les messages SMS/MMS, les notifications push et le Klaviyo Customer Hub pour afficher des données d’objet.

Découvrez comment utiliser les tags de personnalisation dans Klaviyo.

Référence des tags de personnalisation d’objet

Vous pouvez utiliser les tags de personnalisation suivants avec des objets.

Utilisation de l’objet qui a déclenché un flux

Ces exemples utilisent ce qui suit :

• Objet appelé Pet qui est référencé avec le tag object dans le modèle. 
• Propriété de l’objet appelée Nom

Récupération d’un objet par identifiant

Ces exemples utilisent ce qui suit :

• Objet appelé Pet
• Propriété de l’objet appelée Nom
• Événement qui a déclenché le flux avec une propriété d’objet appelée pet_id. Ce champ est identique à l’ID d’objet de l’objet Pet.

Renvoyer un seul objet à partir d’un filtre d’objet

Ces exemples utilisent ce qui suit :

• Un filtre d’objet supplémentaire nommé oldestDog
• Propriété de l’objet appelée Nom

Renvoyer un entier à partir d’un filtre d’objets

Ces exemples utilisent ce qui suit :

• Un filtre d’objet supplémentaire appelé countOfDogs

Renvoie plusieurs objets à partir d’un filtre d’objets

Pour un filtre nommé dogs configuré avec Multiple, parcourez en boucle les enregistrements correspondants pour afficher la propriété Name de chaque animal de compagnie :

{% for pet in object_filter.dogs %}
{{ pet.Name }}
{% endfor %}

Récupérer des enregistrements d’objets

Utilisez customobjects pour récupérer jusqu’à 5 enregistrements liés au destinataire, classés du plus récemment ajouté au plus ancien. Parcourez en boucle les enregistrements renvoyés pour afficher leurs propriétés. Cet exemple utilise les éléments suivants :

• Objet appelé profil d’animal de compagnie
• Propriété de l’objet appelée name

Données d’objets dans l’objet

Utilisez la même syntaxe d’objet personnalisé dans les objets que dans le corps du message. Ces exemples montrent la syntaxe pour chaque source de données :

• {{ object_filter.oldestDog.Name }} affiche la propriété Name du single-object filter oldestDog.
• {{ object.Name }} affiche la propriété Nom de l’objet qui a déclenché un flux déclenché par une date.
• {% customobject event.pet_id object_type_title="Pet" as pet %}{{ pet.Name }}{% endcustomobject %} recherche un enregistrement Pet par ID. Utilisez-le dans un flux déclenché par un événement contenant pet_id.

Par exemple, utilisez {{ object.Name }} dans un flux déclenché par une date, basé sur l’objet Pet, pour afficher le nom de l’animal de compagnie d’un client dans l’objet.

Vue brouillon :

Aperçu de l’e-mail :

Données d’objet dans la logique d’affichage et de masquage

Vous pouvez également configurer l’affichage ou le masquage d’un bloc dans un modèle en fonction des données d’objet. Utilisez une propriété ou un nombre issu d’un filtre d’objet, ou l’objet qui a déclenché un flux déclenché à une date. Vous pouvez utiliser les données d’objet dans une seule condition d’affichage/masquage, ou dans la condition de chaque variante de logique d’affichage/masquage. Pour les données récupérées par ID, utilisez la logique conditionnelle avancée décrite ci-dessous.

Par exemple, dans un flux déclenché par une date basé sur un objet Pet, utilisez object.Breed == 'Labrador' pour afficher un bloc uniquement lorsque la Breed de l’animal déclencheur est Labrador. Utilisez la valeur de race exacte de vos données.

1. Sélectionnez le bloc et ouvrez l’onglet Affichage. Sous Afficher/masquer la logique, sélectionnez Afficher uniquement à une audience spécifique, ou sélectionnez Personnaliser pour plusieurs audiences pour créer des variantes de logique. Sélectionnez ensuite Utiliser le code.
2. Saisissez une condition, telle que object_filter.countOfDogs > 0, sans {{ }} ni {% %} autour. Les filtres d’objets peuvent être utilisés dans les campagnes et les flux. Utilisez object uniquement dans un flux déclenché par une date basé sur les données d’objet.
3. Cliquez sur Enregistrer pour appliquer la condition.

Les sections d’objets personnalisés prennent en charge la logique d’affichage/masquage pour une seule audience. Les variantes de logique ne sont pas disponibles pour elles. En savoir plus sur les variantes de logique d’affichage/masquage.

Pour plus de flexibilité (par exemple, rendre certaines informations conditionnelles en fonction des informations renvoyées par {% customobject %} ou {% customobjects %}), envisagez d’utiliser une logique conditionnelle avancée avec une logique {% if ... %} directement dans un bloc de texte.

Filtres d’objets

Qu’est-ce qu’un filtre d’objet ?

Les filtres d’objet sélectionnent les enregistrements liés à chaque destinataire selon les critères que vous définissez. Vous pouvez afficher une propriété d’un enregistrement correspondant, des propriétés de jusqu’à 10 enregistrements correspondants, ou un décompte des enregistrements correspondants.

Créer un nouveau filtre pour les objets

Pour commencer à créer un filtre d’objet :

1. Ajoutez un nouveau bloc de texte ou modifiez le texte dans un bloc de texte existant dans votre modèle.
2. Sélectionnez le bouton Personnalisation .

3. Dans la fenêtre modale de personnalisation, sélectionnez Objets dans la liste déroulante Tous les types .
4. Sélectionnez l’objet qui contient les données pour lesquelles vous souhaitez définir un filtre.
5. Sélectionnez la propriété que vous souhaitez afficher. Pour créer plutôt un filtre de comptage, sélectionnez Nombre d’objets.
6. Cliquez sur Créer s’il n’y a pas encore de filtres. Si des filtres sont répertoriés, laissez-les non sélectionnés, puis cliquez sur Créer un filtre d’objet.

Dans la fenêtre modale Créer un filtre d’objet, définissez les informations suivantes :

• Nom
  Saisissez un nom unique ne contenant que des lettres et des chiffres, par exemple oldestDog. N’utilisez pas d’espaces ni de caractères spéciaux.
• Définir les conditions de filtrage
  Définissez les règles auxquelles un objet doit répondre pour être inclus dans le bloc de texte.
• Combien d’objets faut-il afficher ?
  Pour une valeur de propriété, sélectionnez Unique pour 1 enregistrement ou Multiple pour jusqu’à 10 enregistrements. Les filtres de comptage n’affichent pas ce paramètre.
• Sélectionner la propriété et Ordre de tri
  Pour un filtre de propriété-valeur, choisissez la propriété utilisée pour sélectionner ou trier les enregistrements, puis choisissez son ordre de tri. Par exemple, triez selon une propriété d’anniversaire avec Le plus ancien pour sélectionner l’animal le plus âgé en premier. Ces champs n’apparaissent pas pour les filtres de comptage.

Cliquez sur Créer un filtre d’objet pour enregistrer votre filtre et insérer son tag dans le bloc de texte.

Une fois votre filtre d’objet créé, vous pouvez l’utiliser dans la logique d’affichage/masquage et les tags de personnalisation pour afficher des enregistrements d’objet spécifiques en fonction des critères que vous avez définis.

Ressources supplémentaires