Naslaginformatie voor cataloguslookup-tag
Wat je leert
Leer hoe je de catalog tag gebruikt, waarmee je in je e-mails, sms en pushberichten kunt verwijzen naar specifieke productinformatie uit je catalogus. Dit is handig als je aangepaste productaanbevelingen wilt maken of productinformatie wilt kruislings vergelijken. Als je bijvoorbeeld je eigen aanbevelingsengine gebruikt, kun je je eigen productaanbevelingen als event- of profielgegevens aan Klaviyo doorgeven en die gegevens vervolgens gebruiken in templates.
Houd er rekening mee dat deze handleiding is ontworpen voor technisch onderlegde marketeers of klanten die toegang hebben tot een developer.
De {% catalog %} tag
De tag {% catalog %} gebruikt de volgende syntaxis:
{% catalog itemID unpublished="cancel" %}
...
{% endcatalog %}Vervang itemID door de product-ID van het product waarnaar je verwijst. Dit is de product-ID zoals gesynchroniseerd vanuit je eigen productcatalogus. Let op: deze opzoekactie is specifiek voor de product-ID en niet voor de SKU.
Door unpublished="cancel" op te nemen, zorg je ervoor dat je je bericht niet verstuurt als het item waarnaar wordt verwezen niet is gepubliceerd. Dit argument is optioneel.
- Als een item waarnaar in je bericht wordt verwezen op het moment van opzoeken niet is gepubliceerd in je catalogus, wordt het hele bericht overgeslagen.
- Voor een specifiek flowbericht kun je naar Analytics > Recipient Activity > Other gaan en een lijst bekijken met het label Overgeslagen: catalogusitem niet beschikbaar. Deze lijst bevat alle profielen die zijn overgeslagen omdat een item dat in het bericht wordt uitgelicht niet op voorraad was of anderszins niet beschikbaar was.
Wanneer je deze functie gebruikt, kun je tussen de openings- en sluitende catalogustags verwijzen naar specifieke gegevens van het item dat is gekoppeld aan de itemID in je Klaviyo-productcatalogus.
De volgende gegevens zijn beschikbaar als referentie binnen een {% catalog %} -blok.
Templatetag | Naam | Beschrijving |
|---|---|---|
| Beschrijving | De beschrijving van het item. |
| URL | De url voor toegang tot het item in je winkel. |
| Titel | De titel van het item. |
| Prijs | De prijs van een item. Deze tag maakt de itemprijs op met het juiste valutavoorvoegsel. |
| Valutasymbool | Het grafische symbool dat wordt gebruikt om een valuta-eenheid aan te duiden |
| Valutacode | De alfabetische code die wordt gebruikt om valuta aan te duiden |
| Volledige afbeelding | De url voor de volledige afbeelding van het item. Gebruik dit in een afbeeldingsblok of een <img> -tag. |
| Thumbnail | De url voor de volledige afbeelding van het item. Gebruik dit in een <img> -tag in aangepaste HTML, of gebruik het als een dynamische afbeeldingsplaceholder-URL, omgeven door de opening- en sluitende {% catalog %}-tags |
| ID | De product-ID van het item. |
| Catalogus-ID | De ID van de catalogus, zodat je kunt aangeven uit welke catalogus je wilt ophalen als je er meerdere hebt. |
Er zijn mogelijk extra gegevensvelden beschikbaar die als metadata worden beschouwd. Om naar een van deze extra itemeigenschappen te verwijzen, kun je de variabele syntaxis gebruiken: {{ catalog_item.metadata.color }}. In dit geval haalt de variabele de waarde "color" op die is gekoppeld aan het item dat is opgeslagen in de metadata van het item.
Om een preview te openen van alle beschikbare details die op een item zijn opgeslagen — inclusief alle metadata — voeg je het volgende snippet toe aan een tekstblok in een testtemplate en werk je itemID bij met de Product ID van een van de huidige producten in je catalogus.
{% catalog itemID %}
{{ catalog_item }}
{% endcatalog %}Bekijk daarna een voorbeeld van het bericht. Deze preview biedt een onbewerkte versie van alle gegevens die beschikbaar zijn voor je producten.
Filteren op catalogus-ID
Als je meerdere catalogi hebt, kun je met de tag {{catalog id}} aangeven uit welke catalogus je wilt ophalen. Je kunt bijvoorbeeld een catalogus hebben die is gesynchroniseerd via een Klaviyo-integraties zoals Shopify, een catalogus die is gesynchroniseerd via API, of een aangepaste catalogusfeed. Tagdetails kunnen variëren afhankelijk van je integratie. In het volgende voorbeeld zijn meerdere catalogi gesynchroniseerd met dezelfde Klaviyo-account en willen we een productbeschrijving ophalen van een specifiek product dat in een API-catalogus staat.
Zoek eerst de catalogus-ID:
- Navigeer in Klaviyo naar Content > Producten.
- Selecteer de catalogus die je wilt gebruiken in het dropdownmenu Alle catalogi.
- Kopieer de catalogus-ID uit de URL.
Zoek vervolgens de item-ID:
- Nadat je de catalogus hebt geselecteerd, selecteer je het product dat je wilt gebruiken uit de catalogus.
- Op de pagina met productgegevens zie je de item-ID.
Voor het bovenstaande voorbeeld zou de code er zo uitzien:
{% catalog "SAMPLE-DATA-ITEM-15" integration="api" catalog_id="1060935"%} {{ catalog_item.description }}{% endcatalog %}Filteren op taalinstelling
Locatiebewuste catalogi, zoals de Shopify-catalogus in Klaviyo, kunnen per locatie worden doorzocht. Naar de locatietaal en -regio kan worden verwezen met een land- en taalcode van twee letters volgens de ISO 3166- en 639-normen. Als een gelokaliseerd product niet kan worden gevonden, wordt de standaard productinformatie gebruikt.
{% catalog "SAMPLE-DATA-ITEM-15" integration="api" catalog_id="1060935" language='fr' region='CA' %} {{ catalog_item.description }}{% endcatalog %}Zoek een item-ID op dat met een event wordt doorgegeven
Het gebruik van een catalogusopzoeking met een event wordt vooral in de volgende scenario's gebruikt:
- Als je een aangepaste integratie gebruikt waarbij productaanbevelingen samen met een event worden doorgegeven om in het bericht te tonen. Bijvoorbeeld een bericht voor website verlaten, waarbij unieke aanbevelingen worden gegenereerd op basis van bekeken items. In plaats van het enkele item dat een klant heeft bekeken in het bericht te vullen, kun je een set aanbevolen items genereren en vullen op basis van dat bekeken item. Er moet een set product-ID's samen met het event naar Klaviyo worden gestuurd.
- Als je een aangepaste integraties gebruikt en je liever niet alle productgegevens verstuurt die in een bericht moeten staan. Bijvoorbeeld: bij een bericht over een winkelwagen verlaten verstuur je alleen de product-ID's van alle verlaten items en kan Klaviyo ze allemaal opzoeken om alle relevante gegevens op te halen. Het is niet nodig dat elk event de productnaam, prijs, afbeelding, enz. bevat, omdat dit allemaal kan worden ingevuld door alleen de product-ID aan Klaviyo door te geven en vervolgens de informatie op te zoeken in je Klaviyo-productcatalogus.
Als je een {% catalog %} -tag gebruikt met een event, is de lookup gebaseerd op de item-ID van het catalogusitem (dit is Product ID of SKU, afhankelijk van de integraties).
Voor een event waarbij de doorgegeven identificerende waarde de item-ID is, zien de lookup tags er zo uit:
{% catalog event.ItemID %}
...
{% endcatalog %}Voeg binnen dit {% catalog %} -blok templatetags toe voor de gegevens die je wilt invullen voor elk item (bijv. titel, afbeelding, enz.)
Als je bijvoorbeeld de onderstaande voorbeeldgegevens van het catalogusitem gebruikt, kunnen we een {% catalog %} -blok opzetten dat verwijst naar belangrijke productinformatie:
Catalogusitemgegevens:
{
"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"
}
}Syntaxis van templateblokken:
De syntaxis voor het volgende {% catalog %} -blok haalt voor elk item in de gebeurtenis de itemafbeelding, itemtitel en itembeschrijving uit je catalogus op:
{% for item in event.Items %}
{% catalog item.SKU %}
<img src="{{ catalog_item.featured_image.full.src }}"/>
{{ catalog_item.title }}
{{ catalog_item.description }}
{% endcatalog %}
{% endfor %}Als de opzoekactie het item dat wordt gezocht niet kan vinden, wordt het bericht overgeslagen en niet verzonden.
Een item-ID opzoeken als een aangepaste eigenschap
Als je je eigen aanbevelingsengine gebruikt, kun je aanbevolen item-ID's als een aangepaste profieleigenschap doorgeven aan profielen in Klaviyo. Met een {% catalog %} -tag kun je informatie van elk van deze producten gebruiken wanneer je deze klant een bericht stuurt.
Als de opzoekactie het item dat wordt gezocht niet kan vinden, wordt het bericht overgeslagen en niet verzonden.
Syntaxis voor meerdere item-ID's die in één eigenschap zijn opgeslagen
{% 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 %}Syntaxis voor één item-ID in een profieleigenschappen
{% 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>Over de has_category-tag
Gebruik de has_category -tag om te bepalen of een item in je catalogus deel uitmaakt van een bepaalde categorie. Het moet worden gebruikt binnen een catalog lookup-tag voor een bepaald item.
Gebruik de onderstaande voorbeeldcode om deze tag te gebruiken, waarbij je itemID vervangt door een product-ID uit je catalogus en category_name door de volledige naam of een deel van een categorienaam.
{% catalog itemID %}
{{ catalog_item.title }}
{% has_category catalog_item "category_name" as in_category %}
{% if in_category %}
I am on sale!
{% else %}
{% endif %}
{% endcatalog %}Dit voorbeeld geeft de producttitel weer en controleert vervolgens of het product in een categorie staat, category_name. Als dit als true wordt geëvalueerd, verschijnt het bericht "I am on sale!" na de producttitel.
De has_category -tag zoekt naar volledige en gedeeltelijke overeenkomsten met de categorienaam die je instelt. Als je bijvoorbeeld “sale” gebruikt als categorienaam en een product de tag “on-sale” heeft, dan wordt de has_category -tag voor dat product geëvalueerd als true.