-default.png)
Veuillez noter que ce guide est conçu pour les spécialistes du marketing avertis ou les 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 est 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'inclusion de unpublished="cancel" garantira que vous n'enverrez pas votre e-mail au cas où l'article référencé serait dépublié. Cet argument est facultatif.
Si l'un des articles référencés dans votre e-mail n'est pas publié dans votre catalogue au moment de la recherche, l'e-mail entier sera ignoré.
Pour un e-mail de flux donné, vous pouvez naviguer dans Analytics > Recipient Activity > Other et voir une liste intitulée Skipped : Élément du catalogue indisponible. Cette liste comprend tous les profils qui ont été ignorés parce qu'un article présenté dans l'e-mail était en rupture de stock ou indisponible.
Lorsque vous utilisez 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 %}.
Template Tag | Name | Description |
| Description | The description of the item. |
| Tags | Any tags added to the item. |
| URL | The url for accessing the item in your store. |
| Title | The title of the item. |
| Price | The price of an item. This tag formats the item price with the correct currency prefix. |
| Full image | The url for the full image of the item. Use this inside of an image block, or an <img> tag. |
| Thumbnail | The url for the full image of the item. Use this inside of an image block, or an <img> tag. |
| Id | The Product ID of the item. |
Il peut y avoir des champs de données supplémentaires disponibles qui sont considérés comme des métadonnées. Pour faire référence à l'une de ces propriétés d'article supplémentaires, vous pouvez utiliser la syntaxe de la variable : {{ catalog_item.metadata.color }}. Dans ce cas, la variable récupère la valeur "couleur" associée à l'élément et stockée dans les métadonnées de l'élément.
Pour accéder à 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 %}Ensuite, prévisualisez l'e-mail.
Cet aperçu fournit une version brute des données disponibles pour vos produits.
Recherche d'un ID d'article transmis par 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 où les recommandations de produits sont transmises avec un événement pour être affichées dans l'email. Par exemple, un e-mail d'abandon de navigation dans lequel des recommandations uniques sont générées en fonction des articles consultés. Au lieu d'afficher dans l'e-mail le seul article consulté par le client, vous pouvez générer et afficher un ensemble d'articles recommandés en fonction 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 être envoyés dans un e-mail. Par exemple, dans le cas d'un courriel sur les paniers abandonnés, envoyez uniquement les ID de produits de tous les articles abandonnés et Klaviyo pourra rechercher chacun d'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 tout ceci peut être rempli en passant seulement l'ID du produit à Klaviyo, puis en recherchant les informations dans votre catalogue de produits Klaviyo.
Lors de l'utilisation d'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 où 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 faire apparaître pour chaque article (titre, image, etc.).
Par exemple, en utilisant l'exemple de données d'article de catalogue ci-dessous, Klavyio peut créer un bloc {% catalog %} qui fait référence aux informations clés du produit :
Données de l'article du catalogue :
{
"description": "Standard issue for all Klaviyos. This t-shirt has the Klaviyo logo on the front and mark diagram on the back.",
"tags": "apparel,t-shirt,new-arrival",
"url": "https://klaviyogear.myshopify.com/collections/klaviyo-classics/products/short-sleeve-t-shirt-1",
"title": "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 des blocs de modèle :
La syntaxe du bloc {% catalog %} suivant récupère l'image, le titre et la description de l'élément dans votre catalogue, pour chaque élément 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 qu'elle cherche, l'e-mail est ignoré et n'est pas envoyé.
Recherche d'un ID d'article comme propriété personnalisée
Si vous utilisez votre propre moteur de recommandation, vous pouvez transmettre les ID des articles recommandés aux profils dans Klaviyo comme une propriété personnalisée. Par exemple, le profil suivant montre trois ID de produits recommandés attachés à un profil comme un tableau.
En utilisant une balise {% catalog %}, vous pouvez faire référence aux informations de n'importe lequel de ces produits lorsque vous envoyez un e-mail à ce client.
Voici un exemple de syntaxe :
{% 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 %}Si la recherche ne trouve pas l'élément qu'elle cherche, l'e-mail est ignoré et n'est pas envoyé.
