Comment utiliser des objets personnalisés dans les modèles
Vous devez avoir accès à des objets personnalisés pour utiliser cette fonctionnalité.
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 d’abord créer un objet avant de pouvoir utiliser des données d’objet personnalisé dans les modèles.
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 à l’aide de propriétés provenant d’un objet personnalisé, ou du nombre d’enregistrements pour un objet.
Découvrez comment utiliser l’éditeur de modèle Klaviyo.
Pour commencer à ajouter des données d’objet dans vos modèles :
- Ajoutez un nouveau bloc de texte ou sélectionnez un bloc de texte existant.
- Double-cliquez dans le bloc de texte, puis positionnez votre curseur à l’endroit où vous souhaitez insérer votre propriété dynamique.
- Sélectionnez le bouton Personnalisation en haut à droite.
- Dans la modale de personnalisation, sélectionnez Objets dans la liste déroulante Tous les types .
- 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.
- Sélectionnez la propriété d’objet spécifique ou le filtre d’objet à inclure dans le modèle. Vous pouvez également créer un nouveau filtre d’objet ici.
- Définissez le texte par défaut et tous les styles de votre texte.
Pour définir les règles de mise en majuscules des données d’objet, vous devrez définir manuellement la règle dans le tag de personnalisation. Par exemple :
- {{ 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
{{ object }} n’est disponible que lorsqu’un objet a déclenché un flux. La balise de modèle {{ object }} n’est disponible que dans les flux déclenchés par une date basés sur un objet. Cela ressemble à la balise de modèle {{ event }} pour les flux déclenchés par un événement.
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
Structure | Exemple |
{{ object.object_property }} | {{ object.Name }} |
{{ object | lookup:'object_property' }} | {{ object | lookup:'Name' }} |
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.
Structure | Exemple |
{% customobject event.object_id object_type_title=« Title » as alias %} | {% customobject event.pet_id object_type_title="Pet" as pet %} |
{% customobject event.object_id object_type_title=« Title » as alias %} | {% customobject event.pet_id object_type_title="Pet" as pet %} |
Renvoyer un seul objet à partir d’un filtre d’objet
Ces exemples utilisent ce qui suit :
- Un filtre d’objet supplémentaire appelé oldest_dog
- Propriété de l’objet appelée Nom
Structure | Exemple |
{{ object_filter.object_filter_name.object_property}} | {{ object_filter.oldest_dog.Name }} |
{{ object_filter.object_filter_name | lookup: 'object_property' }} | {{ object_filter.oldest_dog | lookup: 'Name' }} |
Renvoyer un entier à partir d’un filtre d’objets
Ces exemples utilisent ce qui suit :
- Un filtre d’objet supplémentaire appelé count_of_dogs
Structure | Exemple |
{{ object_filter.object_filter_name }} | {{ object_filter.count_of_dogs }} |
Récupérer des enregistrements d’objets
Pour récupérer les enregistrements d’objet les plus récents d’un objet, vous devrez parcourir tous les enregistrements d’objet. Cet exemple utilise les éléments suivants :
- Objet nommé Pets
Structure | Exemple |
{% customobjects object_type_title="Title" as alias %} | {% customobjects object_type_title="Profil d’animal de compagnie" as pets %} |
Données d’objets dans l’objet
Vous pouvez personnaliser vos objet avec n’importe lequel des tags d’objet personnalisés :
- {% object_filter %}
- {% object %}
- {% customobject %}
Par exemple, vous pouvez utiliser le tag {% object %} dans l’objet de votre message pour afficher directement le nom de l’animal de compagnie d’un client.
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 de l’objet. Afficher ou masquer un bloc de manière dynamique en fonction des données d’objet utilise les mêmes tags que l’éditeur de modèles. Vous pouvez référencer des objets par ID, des propriétés à partir de filtres d’objet, ou des agrégats à partir de filtres d’objet.
Vous devez créer des filtres d’objets avant de pouvoir les référencer dans la logique d’affichage/masquage.
Par exemple, si vous avez un objet Pet avec une propriété appelée Breed, vous pouvez choisir d’afficher un bloc uniquement aux propriétaires d’animaux qui ont une certaine race de chien en utilisant la condition object.Breed .
Pour définir la logique d’affichage/masquage, cliquez sur le bloc pour lequel vous souhaitez définir des règles, puis sélectionnez Utiliser le code dans l’onglet Affichage.
Saisissez la condition directement dans l’éditeur de code. Vous pouvez utiliser les filtres d’objet et la balise de modèle d’objet s’il s’agit d’un message pour un flux déclenché par une date en fonction des données de l’objet.
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’objets vous permettent de limiter les enregistrements d’objets renvoyés en fonction de critères spécifiques que vous définissez, afin d’afficher des enregistrements d’un certain type.
Créer un nouveau filtre pour les objets
Pour commencer à créer un filtre d’objet :
- Ajoutez un nouveau bloc de texte ou modifiez le texte dans un bloc de texte existant dans votre modèle.
- Sélectionnez le bouton Personnalisation .
- Dans le modèle de personnalisation, sélectionnez Objets dans le menu déroulant Tous les types .
- Sélectionnez l’objet qui contient les données pour lesquelles vous souhaitez définir un filtre.
- Sélectionnez la propriété d’objet pour laquelle vous souhaitez définir un filtre.
- Sélectionnez Créer un filtre.
Dans la fenêtre modale Créer un filtre d’objet, définissez les informations suivantes :
- Nom
Créez un nom pour votre filtre d’objet. - Conditions de filtre
Définissez les règles qu’un objet doit respecter pour être inclus dans le bloc de texte. - Comportement lorsque plusieurs enregistrements répondent aux conditions
Définissez le comportement pour les cas où plusieurs enregistrements répondent aux conditions.
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.