Referens för kataloguppslagningstaggar

Du kommer att lära dig

Lär dig hur du använder katalogetiketten, som gör att du kan referera till specifik produktinformation från din katalog i dina e-postmeddelanden, sms och push-meddelanden. Det här är användbart när du vill skapa anpassade produktrekommendationer eller korsreferera produktinformation. Om du till exempel använder din egen rekommendationsmotor kan du skicka dina egna produktrekommendationer som händelse- eller profildata till Klaviyo och sedan använda dessa data i mallar.

Taggen {% catalog %}

{% catalog %} -etiketten använder följande syntax:

{% catalog itemID unpublished="cancel" %}
...
{% endcatalog %}

Ersätt itemID med produkt-ID:t för produkten som du refererar till. Det här är produkt-ID:t som synkroniseras från din egen produktkatalog. Observera att den här uppslagningen specifikt gäller produkt-ID:t och inte SKU:t.

Om du inkluderar unpublished="cancel" säkerställer du att du inte skickar ditt meddelande om objektet som refereras är opublicerat. Det här argumentet är valfritt.

• Om något objekt som refereras till i ditt meddelande inte är publicerat i din katalog vid tidpunkten för sökningen hoppas hela meddelandet över.
• För ett visst flödesmeddelande kan du navigera till Analys > Mottagaraktivitet > Annat och se en lista med etiketten Hoppades över: Katalogobjektet är inte tillgängligt. Den här listan innehåller alla profiler som hoppades över eftersom ett objekt som ingick i meddelandet var slut i lager eller på annat sätt inte tillgängligt.

När du använder den här funktionen kan du mellan de inledande och avslutande katalogetiketterna referera till specifika data från objektet som är kopplat till itemID i din Klaviyo-produktkatalog.

Följande data är tillgängliga att referera till i ett {% catalog %} -block.

Det kan finnas ytterligare datafält som räknas som metadata. Om du vill referera till en av dessa ytterligare egenskaper för artikeln kan du använda variabelsyntaxen: {{ catalog_item.metadata.color }}. I det här fallet kommer variabeln att hämta "color"-värdet som är kopplat till objektet som lagras i objektets metadata.

För att komma åt en förhandsgranskning av alla tillgängliga detaljer som lagras på ett objekt – inklusive all metadata – lägger du till följande kodsnutt i ett textblock i en testmall och uppdaterar itemID med produkt-ID:t för en av de aktuella produkterna i din katalog.

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

Förhandsgranska sedan meddelandet. Den här förhandsgranskningen visar en rå version av alla data som finns tillgängliga för dina produkter.

Filtrering efter katalog-ID

Om du har flera kataloger kan du ange vilken katalog du vill hämta från med hjälp av etiketten {{catalog id}}. Du kan till exempel ha en katalog som synkas via en Klaviyo-integration som Shopify, en katalog som synkas via API eller ett anpassat katalogflöde. Etikettdetaljerna kan variera beroende på din integration. I följande exempel synkas flera kataloger till samma Klaviyo-Konto och vi vill hämta en produktbeskrivning från en specifik produkt i en API-katalog.

Börja med att hitta katalog-ID:t:

1. I Klaviyo navigerar du till Innehåll > Produkter.
2. Välj den katalog du vill använda i rullgardinsmenyn Alla kataloger.
   

3. Kopiera katalog-ID:t från URL:en.
   

Hitta sedan artikel-ID:t:

1. När du har valt katalogen väljer du den produkt du vill använda från katalogen.
2. På sidan med produktinformation ser du objekt-ID:t.
   

För exemplet ovan skulle koden se ut så här:

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

Filtrering efter språkinställning

Språkmedvetna kataloger, som Shopify-katalogen i Klaviyo, kan sökas efter språkvariant. Språk och region för språkinställningen kan refereras med lands- och språkkod med två bokstäver enligt standarderna ISO 3166 och 639. Om en lokaliserad produkt inte kan hittas används standardproduktinformationen.

{% catalog "SAMPLE-DATA-ITEM-15" integration="api" catalog_id="1060935" language='fr' region='CA' %} {{ catalog_item.description }}{% endcatalog %}

Sök upp ett artikel-ID som skickas med en händelse

Att använda en kataloguppslagning med en händelse används främst i följande scenarier:

• Om du använder en anpassad integration där produktrekommendationer skickas vidare tillsammans med en händelse för att visas i meddelandet. Till exempel ett meddelande om övergiven surfning där unika rekommendationer genereras baserat på visade artiklar. I stället för att fylla med den enda artikeln som en kund tittade på i meddelandet kan du generera och fylla i en uppsättning rekommenderade artiklar baserat på den visade artikeln. En uppsättning produkt-ID:n måste skickas till Klaviyo tillsammans med händelsen.
• Om du använder en anpassad integration och du föredrar att inte skicka alla produktuppgifter som behöver finnas med i ett meddelande. Till exempel kan du med ett meddelande om övergiven kundvagn bara skicka produkt-ID:n för alla övergivna artiklar så kan Klaviyo slå upp var och en för att hämta alla relevanta detaljer. Det finns ingen anledning att varje händelse ska innehålla produktnamn, pris, bild osv. eftersom allt detta kan fyllas i genom att du bara skickar produkt-ID:t till Klaviyo och sedan slår upp informationen i din Klaviyo-produktkatalog.

När du använder en {% catalog %} -etikett med en händelse baseras uppslagningen på artikel-ID:t för katalogartikeln (detta är antingen produkt-ID eller SKU beroende på integrationen).

För en händelse där det identifierande värdet som skickas är artikel-ID kommer uppslags-etiketterna att se ut så här:

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

I det här {% catalog %} -blocket lägger du till malltaggar för de data som du vill fylla i för varje artikel (dvs. titel, bild osv.)

Om vi till exempel använder exempeldata för katalogobjektet nedan kan vi bygga ett {% catalog %} -block som refererar till viktig produktinformation:

Katalogobjektdata:

{
  "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"
  }
}

Syntax för mallblock:

Syntaxen för följande {% catalog %} -block skulle hämta artikelbilden, artikeltiteln och artikelbeskrivningen från din katalog för varje artikel i händelsen:

{% for item in event.Items %}
	{% catalog item.SKU %}
 		<img src="{{ catalog_item.featured_image.full.src }}"/>
 		{{ catalog_item.title }}
 		{{ catalog_item.description }}
 	{% endcatalog %}
{% endfor %}

Om uppslaget inte kan hitta varan som det letar efter hoppas meddelandet över och skickas inte.

Slå upp ett objekt-ID som en anpassad egenskap

Om du använder din egen rekommendationsmotor kan du skicka rekommenderade objekt-ID:n till profiler i Klaviyo som en anpassad profilegenskap. Med en {% catalog %} -etikett kan du referera till information från någon av dessa produkter när du skickar meddelanden till den här kunden.

Om uppslaget inte kan hitta varan som det letar efter hoppas meddelandet över och skickas inte.

Syntax för flera objekt-ID:n som lagras i en enda egenskap

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

Syntax för ett enskilt artikel-ID i en profilegenskap

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

Om etiketten has_category

Använd has_category -etiketten för att avgöra om en artikel i din katalog ingår i en viss kategori. Den måste användas inom en katalognuppslagsetikett för en viss artikel.

Använd exempelkoden nedan för att använda den här etiketten och ersätt itemID med ett produkt-ID från din katalog och category_name med hela eller en del av ett kategorinamn.

{% catalog itemID %}
{{ catalog_item.title }}
{% has_category catalog_item "category_name" as in_category %}
{% if in_category %}
I am on sale!
{% else %}
{% endif %}
{% endcatalog %}

Det här exemplet visar produkttiteln och kontrollerar sedan om produkten finns i en kategori, category_name. Om detta utvärderas som true visas meddelandet ”Jag är på rea!” efter produkttiteln.

Ytterligare resurser