Catalogus opzoeken tag referentie

Wat je leert

Leer hoe je de catalogus tag kunt gebruiken, waarmee je specifieke productinformatie uit je catalogus kunt opnemen in je e-mail-, sms- en push -berichten. Dit is handig als je aangepaste productaanbevelingen wilt maken of productinformatie wilt vergelijken. Als je bijvoorbeeld je eigen aanbevelingsmachine gebruikt, kun je je eigen productaanbevelingen als gebeurtenis of profielgegevens doorgeven aan Klaviyo en die gegevens vervolgens gebruiken in sjablonen.

De tag {% catalog %}

De tag {% catalog %} tag 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 opzoeking is specifiek voor de product-ID en niet voor de SKU.

Met unpublished="cancel" zorg je ervoor dat je je bericht niet verstuurt als het item waarnaar verwezen wordt ongepubliceerd is. Dit argument is optioneel. 

• Als een item waarnaar je bericht verwijst niet gepubliceerd is in je catalogus op het moment van opzoeken, dan wordt het hele bericht overgeslagen.
• Voor een bepaald flow bericht kun je navigeren naar analyses > ontvangers Activiteit > Overig en een lijst met het label Overgeslagen zien : Catalogusitem niet beschikbaar. Deze lijst bevat alle profielen die zijn overgeslagen omdat een artikel in het bericht niet op voorraad of anderszins niet beschikbaar was.

Als je deze functie gebruikt, kun je tussen de openings- en sluitingscatalogustag verwijzen naar specifieke gegevens van het item dat is gekoppeld aan het itemID in je Klaviyo productcatalogus.

De volgende gegevens zijn beschikbaar om naar te verwijzen binnen een {% catalog %} blok.

Er kunnen extra gegevensvelden beschikbaar zijn die als metagegevens worden beschouwd. Om naar een van deze aanvullende objecteigenschappen te verwijzen, kun je de variabele syntaxis gebruiken: {{ catalog_item.metadata.color }}. In dit geval haalt de variabele de "kleur" waarde op die is gekoppeld aan de itemzaak in de metagegevens van het item.

Om een voorbeeld van alle beschikbare details van een item te bekijken - inclusief alle metadata - voeg je het volgende fragment toe aan een tekstblok in een test template, en update itemID met het Product ID van een van de huidige producten in je catalogus.

{% catalog itemID %}{{ catalog_item }}{% endcatalog %}

Bekijk dan een voorbeeld van het bericht. Deze preview geeft een ruwe versie van alle gegevens die beschikbaar zijn voor je producten.

Filteren op catalogus-ID 

Als je meerdere catalogi hebt kun je aangeven uit welke catalogus je wilt halen met de {{catalog id}} tag. Je kunt bijvoorbeeld een catalogus hebben die gesynchroniseerd is via een Klaviyo integratie zoals Shopify, een catalogus die gesynchroniseerd is via API of een aangepaste catalogusfeed. De details van de tag kunnen variëren afhankelijk van je integratie. In het volgende voorbeeld zijn meerdere catalogi gesynchroniseerd met hetzelfde Klaviyo account en we willen een productbeschrijving ophalen van een specifiek product uit een API catalogus.

Zoek eerst de catalogus ID:

1. Navigeer in Klaviyo naar Inhoud > Producten.
2. Selecteer de catalogus die je wilt gebruiken uit de Alle catalogi vervolgkeuzelijst.
   
3. Kopieer de catalogus-ID van de URL.
   

Zoek dan de ID van het item:

1. Nadat je de catalogus hebt geselecteerd, selecteer je het product dat je wilt gebruiken uit de catalogus.
2. Op de pagina met productdetails zie je de artikel-ID.
   

Voor het bovenstaande voorbeeld zou de code er als volgt uitzien:

{% catalog "SAMPLE-DATA-ITEM-15" integration="api" catalog_id="1060935"%}{{ catalog_item.description }}{% endcatalog %}

Een item-ID opzoeken die met een gebeurtenis wordt doorgegeven

Het gebruik van een catalogus lookup met een gebeurtenis wordt meestal gebruikt in de volgende scenario's:

• Als je een aangepaste integratie gebruikt waarbij productaanbevelingen worden doorgegeven met een gebeurtenis om te tonen in het bericht. Bijvoorbeeld een website verlaten bericht waar unieke aanbevelingen worden gegenereerd op basis van bekeken items. In plaats van het enkele item dat een klant in het bericht heeft bekeken in te vullen, kun je een reeks aanbevolen items genereren en invullen op basis van dat bekeken item. Samen met het evenement moet een set product-id's naar Klaviyo worden gestuurd.
• Als je een aangepaste integratie gebruikt en je wilt niet alle productgegevens verzenden die in een bericht moeten. Stuur bijvoorbeeld met een winkelwagen verlaten bericht alleen de product-ID's van alle verlaten artikelen en Klaviyo kan ze allemaal opzoeken om alle relevante details op te halen. Het is niet nodig dat elke gebeurtenis de productnaam, prijs, afbeelding, enz. bevat, omdat dit allemaal kan worden ingevuld door alleen de Product ID door te geven aan Klaviyo en dan de informatie op te zoeken in uw Klaviyo productcatalogus.

Als je een {% catalog %} tag met een gebeurtenis wordt de opzoeking gebaseerd op de Item ID van het catalogusitem (dit is of Product ID of SKU afhankelijk van de integraties).

Voor een gebeurtenis waarbij de doorgegeven identificatiewaarde Item ID is, zal de lookup tag er als volgt uitzien:

{% catalog event.ItemID %}
...
{% endcatalog %}

Voeg binnen dit {% catalog %} blok voeg je templatetag toe voor de gegevens die je wilt invullen voor elk item (bijv. titel, afbeelding, etc.)

Als we bijvoorbeeld de voorbeeldgegevens van het catalogusartikel hieronder gebruiken, kunnen we een {% catalog %} blok maken dat verwijst naar belangrijke productinformatie:

Catalogus item gegevens:

{
 " beschrijving": "Standard kwestie voor alle Klaviyos. Dit t-shirt heeft het Klaviyo logo op de voorkant en een markeringsschema op de achterkant.",
  "url": "https://klaviyogear.myshopify.com/collections/klaviyo-classics/products/short-sleeve-t-shirt-1",
  "titel": "Klassiek Klaviyo T-Shirt",
 " featured_image": {
 " volledig": {
      "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"
  }
}

sjabloon blok syntaxis:

De syntaxis voor het volgende {% catalog %} blok zou de itemafbeelding, itemtitel en itembeschrijving ophalen uit je catalogus, voor elk item in de gebeurtenis:

{% 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 lookup het gezochte item niet kan vinden, wordt het bericht overgeslagen en niet verzonden.

Een artikel-ID opzoeken als een aangepaste eigenschap

Als je je eigen aanbevelingsmachine gebruikt, kun je aanbevolen artikel-ID's doorgeven aan profiel in Klaviyo als een aangepaste profieleigenschappen. Met behulp van een {% catalog %} tag kun je verwijzen naar informatie van elk van deze producten wanneer je een bericht stuurt naar deze klant.

Als de lookup het gezochte item niet kan vinden, wordt het bericht overgeslagen en niet verzonden.

Syntaxis voor meerdere item ID's zaak in een enkele eigenschap

{% 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>

<p>{{ catalog_item.title }} {% endcatalog %}</p>

{% endfor %}

Syntaxis voor een enkel artikel-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>

  <p>{{ catalog_item.title }} {% endcatalog %}</p>

Over de tag has_category

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 catalogusopzoeking tag voor een bepaald item. 

Gebruik de voorbeeldcode hieronder om deze tag te gebruiken, waarbij je itemID vervangt door een product-ID uit je catalogus en category_name door een volledige categorienaam of een deel daarvan. 

{% catalog itemID %}
{{ catalog_item.title }}
{% has_category catalog_item "category_name" as in_category %}
{% if in_category %}
Ik ben in de uitverkoop!
{% else %}
{% endif %}
{% endcatalog %}

Dit voorbeeld geeft de producttitel weer en controleert vervolgens of het product in een categorie zit, categorie_naam. Als dit waar is, verschijnt het bericht "Ik ben in de aanbieding!" na de producttitel. 

Extra hulpbronnen

• Hoe gebruik je productfeed en aanbevelingen
• Overzicht van de e-mailtemplate editor