Vous apprendrez
Apprenez à utiliser la balise catalogue, qui vous permet de référencer des informations spécifiques sur les produits de votre catalogue dans vos e-mails et messages SMS. Cette fonction est utile lorsque vous souhaitez créer des recommandations de produits personnalisées ou des références croisées d'informations sur les produits. Par exemple, si vous utilisez votre propre moteur de recommandation, vous pouvez transmettre à Klaviyo vos propres recommandations de produits en tant que données d'événement ou de profil, puis utiliser ces données dans des modèles.
Veuillez noter que ce guide est destiné aux spécialistes du marketing qui maîtrisent la technologie ou aux clients qui ont accès à un développeur.
La balise {% catalog %}
La balise {% catalog %} utilise la syntaxe suivante :
{% catalog itemID unpublished="cancel" %}
...
{% endcatalog %}Remplacez itemID par l'ID du produit auquel vous faites référence. Il s'agit de l'identifiant du produit tel qu'il a été synchronisé à partir de votre propre catalogue de produits. Notez que cette recherche porte spécifiquement sur l'ID du produit et non sur l'UGS.
L'ajout de unpublished="cancel" garantit que vous n'enverrez pas votre message si l'article référencé n'est pas publié. Cet argument est facultatif.
- Si un article référencé dans votre message n'est pas publié dans votre catalogue au moment de la recherche, l'ensemble du message sera ignoré.
- Pour un message de flux donné, vous pouvez naviguer vers Analytics > Recipient Activity > Other et voir une liste intitulée Skipped : Catalog Item Unavailable. Cette liste comprend tous les profils qui ont été ignorés parce qu'un article présenté dans le message était en rupture de stock ou indisponible.
En utilisant cette fonctionnalité, entre les balises d'ouverture et de fermeture du catalogue, vous pouvez faire référence à des données spécifiques de l'article associé à l'itemID dans votre catalogue de produits Klaviyo.
Les données suivantes peuvent être référencées à l'intérieur d'un bloc {% catalog %}.
| Modèle de balise | Nom | Description |
{{ catalog_item.description }} | Description | La description de l'article. |
{{ catalog_item.url }} | URL | L'url permettant d'accéder à l'article dans votre magasin. |
{{ catalog_item.title }} | Titre | Le titre de l'article. |
{% currency_format catalog_item.metadata|lookup:"price" %} | Prix | Le prix d'un article. Cette balise formate le prix de l'article avec le préfixe monétaire correct. |
{{ catalog_item.featured_image.full.src }} | Image complète | L'url de l'image complète de l'élément. Utilisez-le à l'intérieur d'un bloc d'images ou d'une balise <img>. |
{{ catalog_item.featured_image.thumbnail.src }} | Vignette | L'url de l'image complète de l'élément. Utilisez-le dans une balise <img> dans un code HTML personnalisé, ou utilisez-le en tant qu'URL d'image dynamique entourée des balises {% catalog %} d'ouverture et de fermeture. |
{{ catalog_item.id }} | Id | L'ID du produit de l'article. |
{{ catalog_id }} | ID du catalogue | L'ID du catalogue afin que vous puissiez spécifier le catalogue à extraire si vous en avez plusieurs. |
Il peut y avoir des champs de données supplémentaires qui sont considérés comme des métadonnées. Pour faire référence à l'une de ces propriétés supplémentaires, vous pouvez utiliser la syntaxe de la variable : {{ catalog_item.metadata.color }}. Dans ce cas, la variable va récupérer la valeur de la couleur "" associée à l'article et stockée dans les métadonnées de l'article.
Pour obtenir un aperçu de tous les détails disponibles stockés sur un article - y compris toutes les métadonnées - ajoutez l'extrait suivant à un bloc de texte dans un modèle de test, et mettez à jour itemID avec l'ID de produit de l'un des produits actuels de votre catalogue.
{% catalog itemID %}
{{ catalog_item }}
{% endcatalog %}Prévisualisez ensuite le message. Cet aperçu fournit une version brute de toutes les données disponibles pour vos produits.
En outre, si vous disposez de plusieurs catalogues (c'est-à-dire si vous synchronisez plusieurs catalogues personnalisés avec votre compte), vous pouvez spécifier le catalogue à partir duquel vous souhaitez effectuer une extraction à l'aide de la balise {{ catalog_id }}. Par exemple :
{% catalog "womens-jewelry-bundle" integration="demandware" catalog_id="catalogID"%} {{ catalog_item.internal_id }} {% endcatalog %}Recherchez l'identifiant d'un élément transmis lors d'un événement
L'utilisation d'une consultation de catalogue avec un événement est principalement utilisée dans les scénarios suivants :
- Si vous utilisez une intégration personnalisée dans laquelle les recommandations de produits sont transmises avec un événement à afficher dans le message. Par exemple, un message d'abandon de navigation dans lequel des recommandations uniques sont générées en fonction des articles consultés. Au lieu d'indiquer dans le message le seul article que le client a consulté, vous pouvez générer et indiquer un ensemble d'articles recommandés sur la base de l'article consulté. Un ensemble d'identifiants de produits doit être envoyé à Klaviyo avec l'événement.
- Si vous utilisez une intégration personnalisée et que vous préférez ne pas envoyer tous les détails du produit qui doivent figurer dans un message. Par exemple, dans le cas d'un message de panier abandonné, il suffit d'envoyer les identifiants de produit de tous les articles abandonnés et Klaviyo peut rechercher chacun d'entre eux pour en extraire tous les détails pertinents. Il n'est pas nécessaire que chaque événement contienne le nom du produit, le prix, l'image, etc. puisque tous ces éléments peuvent être renseignés en transmettant uniquement l'ID du produit à Klaviyo, puis en recherchant les informations dans votre catalogue de produits Klaviyo.
Lorsque vous utilisez une balise {% catalog %} avec un événement, la recherche est basée sur l'ID de l'article du catalogue (il s'agira de l'ID du produit ou de l'UGS selon l'intégration).
Pour un événement dont la valeur d'identification transmise est l'ID de l'article, les balises de recherche apparaîtront comme suit :
{% catalog event.ItemID %}
...
{% endcatalog %}Dans ce bloc {% catalog %}, ajoutez des variables de modèle pour les données que vous souhaitez remplir pour chaque élément (c'est-à-dire titre, image, etc.)
Par exemple, en utilisant l'exemple de données de catalogue ci-dessous, nous pouvons construire un bloc {% catalog %} qui fait référence à des informations clés sur le produit :
Données de l'article de catalogue :
{
" description": "Édition standard pour tous les Klaviyos. Ce t-shirt porte le logo Klaviyo sur le devant et le diagramme de marque sur le dos.",
"url": "https://klaviyogear.myshopify.com/collections/klaviyo-classics/products/short-sleeve-t-shirt-1",
"titre": "Classic Klaviyo T-Shirt",
" featured_image": {
" full": {
"src": "https://www.klaviyo.com/media/images/examples/products/klaviyo-tshirt-full.png"
},
" thumbnail": {
"src": "https://www.klaviyo.com/media/images/examples/products/klaviyo-tshirt-thumbnail.png"
}
},
" id": "KLAVIYO-TSHIRT",
" metadata": {
"Color": "Grey",
"Design": "Standard"
}
}Syntaxe du bloc de modèle :
La syntaxe du bloc {% catalog %} suivant permet de récupérer l'image, le titre et la description de l'article dans votre catalogue, pour chaque article de l'événement :
{% for item in event.Items %}
{% catalog item.SKU %}
<img src="{{ catalog_item.featured_image.full.src }}"/>
{{ catalog_item.title }}
{{ catalog_item.description }}
{% endcatalog %}
{% endfor %}Si la recherche ne trouve pas l'élément recherché, le message est ignoré et n'est pas envoyé.
Rechercher l'identifiant d'un article en tant que propriété personnaliséeRechercher l'identifiant d'un article en tant que propriété personnalisée
Si vous utilisez votre propre moteur de recommandation, vous pouvez transmettre les ID des éléments recommandés aux profils dans Klaviyo en tant que propriété de profil personnalisée. En utilisant une balise {% catalog %}, vous pouvez faire référence à des informations provenant de n'importe lequel de ces produits lorsque vous envoyez un message à ce client.
Si la recherche ne trouve pas l'élément recherché, le message est ignoré et n'est pas envoyé.
Syntaxe pour plusieurs identifiants d'articles stockés dans une seule propriétéSyntaxe pour plusieurs identifiants d'articles stockés dans une seule propriété
{% for item in person|lookup:'Recommended Products' %}{% catalog item %}
<img src="{{ catalog_item.featured_image.thumbnail.src }}" style="display : inline-block ; border : none" width="150px" />
<p>{{ catalog_item.title }} {% endcatalog %}</p>
{% endfor %}Syntaxe pour un ID d'article unique dans une propriété de profil
{% catalog person|lookup:"Recommended Products" %}
<img style="display : inline-block ; border : none ;" src="{{ catalog_item.featured_image.thumbnail.src }}" width="150px"/>
<p>{{ catalog_item.title }} {% endcatalog %}</p>
À propos de la balise has_category
La balise has_category permet de déterminer si un élément de votre catalogue fait partie d'une catégorie particulière. Il doit être utilisé dans une balise de recherche de catalogue pour un article particulier.
Utilisez l'exemple de code ci-dessous pour utiliser cette balise, en remplaçant itemID par l'identifiant d'un produit de votre catalogue et category_name par tout ou partie du nom d'une catégorie.
{% catalog itemID %}
{{ catalog_item.title }}
{% has_category catalog_item "category_name" as in_category %}
{% if in_category %}
Je suis en solde !
{% else %}
{% endif %}
{% endcatalog %}Cet exemple affiche le titre du produit, puis vérifie si le produit se trouve dans une catégorie, nom_catégorie. Si l'évaluation est positive, le message "Je suis en solde !" apparaît à la suite du titre du produit.
La balise has_category recherche des correspondances complètes ou partielles avec le nom de la catégorie que vous avez défini. Par exemple, si vous utilisez "sale" comme nom de catégorie et qu'un produit possède une balise "on-sale", la balise has_category sera évaluée comme vraie pour ce produit.