Comment utiliser les objets personnalisés dans les modèles
Vous devez avoir accès aux objets personnalisés pour utiliser cette fonctionnalité.
Objectif de cet article
Découvrez comment utiliser des objets personnalisés dans les modèles pour 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 l'objet personnalisé données dans modèle.
Accéder aux données d’objet via le menu de personnalisationAccéder aux données d’objet via le menu de personnalisation
Vous pouvez personnaliser les blocs de texte dans l’éditeur de modèles à l’aide des propriétés d’un objet personnalisé ou du nombre d’enregistrements d’un objet.
Apprenez à utiliser l'éditeur de modèles de Klaviyo.
Pour commencer à ajouter des données d’objet dans vos modèles :
- Ajoutez un nouveau bloc de texte ou modifiez le texte d’un bloc de texte existant dans votre modèle.
- Sélectionnez le bouton Personnalisation en haut à droite.
- Dans la fenêtre modale de personnalisation, sélectionnez Objets dans le menu déroulant Tous les types .
- Dans Objets, vous verrez tous les objets de votre compte que vous pouvez utiliser pour importer 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'objets ici.
- Définissez le texte par défaut et ses styles.
Pour spécifier les règles de majuscule pour les données d’objet, vous devez 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 DONE -
{{ object.full_name|lower|default:'value' }}
john doe
Apprenez-en plus sur la modification des valeurs avec le filtreur de Django .
Accéder aux données d’objets avec des balises de personnalisationAccéder aux données d’objets avec des balises de personnalisation
Vous pouvez utiliser des balises de personnalisation dans les e-mails (y compris l’objet de l’e-mail), les messages SMS/MMS, les notifications push et le hub client pour afficher les données d’objet.
Découvrez comment utiliser les tags de personnalisation dans Klaviyo.
Guide du tag de personnalisation d’objetGuide du tag de personnalisation d’objet
Vous pouvez utiliser les balises de personnalisation suivantes avec les objets.
Utiliser 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 la date et basés sur un objet. Cette balise est similaire à la balise de modèle {{ event }} pour les flux déclenchés par des événements.
Ces exemples utilisent les éléments suivants :
- Objet appelé Pet qui est référencé avec l'objet tag 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' }} |
Obtenir un objet par identifiant
Ces exemples utilisent les éléments suivants :
- Objet appelé Pet (animal de compagnie)
- Propriété de l’objet appelée Nom
- Événement ayant déclenché le flux à l’aide d’une propriété d’objet appelée animal_id. Ce champ est le même que l’identifiant d’objet pour l’objet Pet.
Structure | Exemple |
{% personobject {{ event.object_id }} object_type_title= »Title » comme alias %} |
{% customobject {{ event.pet_id }} object_type_title="Pet" as pet %} |
{% personobject {{ event.object_id }} object_type_title= »Title » comme alias %} |
{% customobject {{ event.pet_id }} object_type_title="Pet" as pet %} |
Renvoyer un seul objet à partir d’un filtre d’objet
Ces exemples utilisent les éléments suivants :
- Un filtre d’objet supplémentaire appelé plus ancien_chien
- 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' }} |
Retourne un entier à partir d'un filtre d'objets
Ces exemples utilisent les éléments suivants :
- Un filtre d’objet supplémentaire appelé count_of_chien
Structure | Exemple |
{{ object_filter.object_filter_name }} | {{ object_filter.count_of_dogs }} |
Récupérer les enregistrements d’objets
Pour récupérer les enregistrements d’objets les plus récents pour un objet, vous devez parcourir tous les enregistrements d’objets. Cet exemple utilise les éléments suivants :
- Objet appelé Animaux de compagnie
Structure | Exemple |
{% customobjects object_type_title="Title" as alias %} {% for object_instance in alias %} {{ object_instance.record }} {% endfor %} {% endcustomobjects %} |
{% customobjects object_type_title="Pet Profile" as pets %} |
Object données in objet
Vous pouvez personnaliser votre objet avec l'une des étiquettes personnalisées :
- {% object_filter %}
- {% object %}
- {% customobject %}
Par exemple, vous pouvez utiliser le site {% object %} tag dans l'objet de votre message pour afficher directement le nom d'un animal de compagnie du client.
Draft view :
Email avant-première :
Données d’objet dans la logique d’affichage et de masquage
Vous pouvez également configurer l’affichage ou le masquage de blocs dans un modèle en fonction des données d’objet. L’affichage ou le masquage d’un bloc de manière dynamique en fonction des données d’objet utilise les mêmes balises que le concepteur de modèles. Vous pouvez faire référence à des objets par identifiant, par propriétés provenant de filtres d’objets ou par agrégats provenant de filtres d’objets.
Vous devez créer des filtres d’objets avant de pouvoir les utiliser dans la logique d’affichage et de masquage.
Par exemple, si vous avez un objet Pet avec une propriété appelée Breed, vous pouvez choisir de n’afficher un bloc qu’aux propriétaires d’animal de compagnie avec une certaine race de chien en utilisant la condition object.Breed .
Pour définir une logique afficher/masquer, cliquez sur le bloc pour lequel vous souhaitez définir les règles et sélectionnez Utiliser le code dans l’onglet Affichage.
Saisissez la condition directement dans l'éditeur de code. Vous pouvez utiliser l'objet filtrer et l'objet balise de modèle s'il s'agit d'un message pour un flux déclenché par la date et basé sur les données de l'objet.
Pour une plus grande flexibilité (par exemple, pour rendre certaines informations conditionnelles aux informations renvoyées par {% customobject %} ou {% customobjects %}), envisagez d'utiliser une logique conditionnelle avancée avec la logique {% if … %} directement dans un bloc de texte.
Filtres d’objetsFiltres d’objets
Qu’est-ce qu’un filtre d’objet ?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 avez définis pour afficher les enregistrements d’un certain type.
Créer un filtre d’objetCréer un filtre d’objet
Pour commencer à créer un filtre d’objet :
- Ajoutez un nouveau bloc de texte ou modifiez le texte d’un bloc de texte existant dans votre modèle.
- Sélectionnez le bouton Personnalisation .
- Dans le modèle de personnalisation, sélectionnez Objets dans la liste déroulante 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 filtrage
Définissez les règles qu’un objet doit remplir pour être inclus dans le bloc de texte. -
Comportement lorsque plusieurs enregistrements remplissent les conditions
Définissez le comportement dans les cas où plusieurs enregistrements remplissent les conditions.
Une fois votre filtre d’objet créé, vous pouvez l’utiliser dans la logique d’affichage/masquage et les balises de personnalisation pour afficher des enregistrements d’objets spécifiques en fonction des critères que vous avez définis.
Ressources complémentairesRessources complémentaires
Guide de personnalisation des messages
Comment utiliser le panneau de prévisualisation pour la personnalisation des messages