Référence des tags de recherche dans le catalogue
Objectif de cet article
Découvrez comment utiliser le tag catalogue, qui vous permet de référencer des informations spécifiques sur les produits de votre catalogue dans vos e-mails, SMS et notifications push. 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 conçu pour les marketeurs à l’aise avec la technique ou les clients qui ont accès à un développeur.
Le tag {% catalog %}
Le tag {% 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’ID de produit tel qu’il est synchronisé depuis votre propre catalogue de produits. Notez que cette recherche concerne spécifiquement l’ID du produit et non le SKU.
Inclure unpublished="cancel" permet de s’assurer que vous n’envoyez pas votre message au cas où l’élément 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’intégralité du message sera ignorée.
- Pour un message de flux donné, vous pouvez naviguer vers Analytics > Recipient Activity > Other et voir une liste intitulée Ignoré : 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 autrement indisponible.
Lorsque vous utilisez cette fonctionnalité, entre les tags d’ouverture et de fermeture du catalogue, vous pouvez référencer 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 dans un bloc {% catalog %}.
Balise de modèle | Nom | Description |
|---|---|---|
| Description | La description de l’article. |
| URL | L’url permettant d’accéder à l’article dans votre boutique. |
| Title | Le titre de l’article. |
| Prix | Le prix d’un article. Ce tag met en forme le prix de l’article avec le préfixe de devise approprié. |
| Symbole de devise | Le symbole graphique utilisé pour indiquer une unité monétaire |
| Code de la devise | Le code alphabétique utilisé pour désigner une devise |
| Image complète | L’URL de l’image complète de l’article. Utilisez ceci à l’intérieur d’un bloc d’image, ou d’une tag <img>. |
| Vignette | L’URL de l’image complète de l’article. Utilisez-le dans une tag <img> dans du code HTML personnalisé, ou utilisez-le comme URL d’espace réservé d’image dynamique entourée des tags ouvrantes et fermantes {% catalog %} |
| Identifiant | L’ID de produit de l’article. |
| Identifiant du catalogue | L’identifiant du catalogue, afin que vous puissiez indiquer le catalogue à partir duquel extraire les données si vous en avez plusieurs. |
D’autres champs de données peuvent être disponibles et être considérés comme des métadonnées. Pour référencer l’une de ces propriétés d’article supplémentaires, vous pouvez utiliser la syntaxe de variable suivante : {{ catalog_item.metadata.color }}. Dans ce cas, la variable récupérera la valeur "couleur" associée à l’article stocké dans les métadonnées de l’article.
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 de code suivant à un bloc de texte dans un modèle de test, puis 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 le message. Cet aperçu fournit une version brute de toutes les données disponibles pour vos produits.
Filtrage par identifiant de catalogue
Si vous avez plusieurs catalogues, vous pouvez spécifier le catalogue depuis lequel vous souhaitez extraire des données à l’aide du tag {{catalog id}}. Par exemple, vous pouvez avoir un catalogue synchronisé via une intégration Klaviyo comme Shopify, un catalogue synchronisé via l’API ou un flux de catalogue personnalisé. Les détails des tags peuvent varier selon vos intégrations. Dans l’exemple suivant, plusieurs catalogues sont synchronisés avec le même compte Klaviyo, et nous voulons extraire une description de produit à partir d’un produit spécifique contenu dans un catalogue API.
Tout d’abord, recherchez l’ID du catalogue :
- Dans Klaviyo, accédez à Contenu > Produits.
- Sélectionnez le catalogue que vous souhaitez utiliser dans la liste déroulante Tous les catalogues.
- Copiez l’ID du catalogue à partir de l’URL.
Ensuite, trouvez l’ID de l’élément :
- Après avoir sélectionné le catalogue, sélectionnez le produit que vous souhaitez utiliser dans le catalogue.
- Sur la page de détails du produit, vous verrez l’ID de l’article.
Pour l’exemple ci-dessus, le code ressemblerait à :
{% catalog "SAMPLE-DATA-ITEM-15" integration="api" catalog_id="1060935"%} {{ catalog_item.description }}{% endcatalog %}Filtrage par paramètres régionaux
Les catalogues localisés, comme le catalogue Shopify dans Klaviyo, peuvent être recherchés par paramètres régionaux. La langue et la région des paramètres régionaux peuvent être référencées à l’aide d’un code pays et langue à deux lettres, conformément aux normes ISO 3166 et 639. Si aucun produit localisé ne peut être trouvé, les informations du produit par défaut seront utilisées.
{% catalog "SAMPLE-DATA-ITEM-15" integration="api" catalog_id="1060935" language='fr' region='CA' %} {{ catalog_item.description }}{% endcatalog %}Recherchez un ID d’article transmis avec un événement
L’utilisation d’une recherche 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 s’afficher dans le message. Par exemple, un message d’abandon de navigation où des recommandations uniques sont générées en fonction des articles consultés. Au lieu de renseigner dans le message l’article unique consulté par un client, vous pouvez générer et renseigner un ensemble d’articles recommandés en fonction de l’article consulté. Un ensemble d’ID 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 produit qui doivent figurer dans un message. Par exemple, avec un message de panier abandonné, envoyez uniquement les ID de produit de tous les articles abandonnés et Klaviyo peut rechercher chacun d’entre eux pour 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 toutes ces informations peuvent être renseignées en transmettant uniquement l’ID du produit à Klaviyo, puis en recherchant les informations dans votre catalogue de produits Klaviyo.
Lorsque vous utilisez un tag {% catalog %} avec un événement, la recherche est basée sur l’ID d’article de l’article du catalogue (il s’agira soit de l’ID de produit, soit du SKU selon les intégrations).
Pour un événement dans lequel la valeur d’identification transmise est l’ID de l’article, les tags de recherche apparaîtront comme suit :
{% catalog event.ItemID %}
...
{% endcatalog %}Dans ce bloc {% catalog %}, ajoutez des balises de modèle pour les données que vous souhaitez renseigner concernant chaque article (c.-à-d. titre, image, etc.)
Par exemple, en utilisant les exemples de données d’articles de catalogue ci-dessous, nous pouvons créer un bloc {% catalog %} qui fait référence aux informations clés sur les produits :
Données d’article de catalogue :
{
"description": "Standard issue for all Klaviyos. This t-shirt has the Klaviyo logo on the front and mark diagram on the back.",
"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 de bloc de modèle :
La syntaxe du bloc {% catalog %} suivant importerait l’image de l’article, le titre de l’article et la description de l’article depuis 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 parvient pas à trouver l’élément qu’elle cherche, le message est ignoré et n’est pas envoyé.
Rechercher un ID d’article en tant que propriété personnalisée
Si vous utilisez votre propre moteur de recommandation, vous pouvez transmettre les ID d’articles recommandés aux profils dans Klaviyo en tant que propriété de profil personnalisée. À l’aide d’un tag {% catalog %}, vous pouvez référencer les informations de n’importe lequel de ces produits lorsque vous envoyez des messages à ce client.
Si la recherche ne parvient pas à trouver l’élément qu’elle cherche, le message est ignoré et n’est pas envoyé.
Syntaxe pour plusieurs ID 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 du tag has_category
Utilisez le tag has_category pour déterminer si un article de votre catalogue fait partie d’une catégorie particulière. Il doit être utilisé au sein d’un tag de recherche de catalogue pour un article particulier.
Utilisez l’exemple de code ci-dessous pour utiliser ce tag, en remplaçant itemID par un identifiant de produit de votre catalogue et category_name par tout ou partie d’un nom de catégorie.
{% catalog itemID %}
{{ catalog_item.title }}
{% has_category catalog_item "category_name" as in_category %}
{% if in_category %}
I am on sale!
{% else %}
{% endif %}
{% endcatalog %}Cet exemple affiche le titre du produit, puis vérifie si le produit appartient à une catégorie, category_name. Si cela est évalué comme true, le message « Je suis en promotion ! » apparaîtra après le titre du produit.
Le tag has_category recherche des correspondances complètes et partielles avec le nom de catégorie que vous définissez. Par exemple, si vous utilisez « sale » comme nom de catégorie et qu’un produit a un tag « on-sale », le tag has_category sera évalué comme true pour ce produit.