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 det Item ID som visas på produktinformationssidan i Klaviyo. Värdet måste matcha det item ID som finns lagrat i din katalog; använd en SKU endast om den också är katalogens item ID. Behåll citattecken runt ett bokstavligt ID. När du använder en händelse- eller profilvariabel ska du lämna variabeln utan citationstecken, som i exemplen nedan.

Om du inkluderar unpublished="cancel" förhindras meddelandet från att skickas om det refererade objektet är opublicerat i din Klaviyo-katalog. Det här argumentet är valfritt. Utan det kan ett opublicerat objekt fortfarande visas i meddelandet.

• Om någon sökning med unpublished="cancel" hittar ett opublicerat objekt vid söktillfället hoppas hela meddelandet över för den mottagaren.
• För ett flödesmeddelande öppnar du dess analyser och väljer Mottagaraktivitet > Hoppade över. I rullgardinsmenyn Typ väljer du Hoppade över: Katalogobjektet är inte tillgängligt. Den här listan innehåller profiler vars meddelanden hoppades över eftersom ett refererat objekt inte kunde hittas eller eftersom ett opublicerat objekt slogs upp med unpublished="cancel". Ett objekt kan vara opublicerat eftersom det är slut i lager eller på annat sätt inte är tillgängligt i din katalog.

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.

Om du vill se en förhandsvisning av alla tillgängliga detaljer som lagras för ett objekt – inklusive all metadata – lägger du till följande kodsnutt i ett textblock i en testmall och uppdaterar itemID med artikel-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 använder du argumentet catalog_id i den inledande {% catalog %} -etiketten för att ange en katalog. Du måste också inkludera integration, med båda värdena inom citattecken. 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. Integrationsvärdet måste matcha katalogkällan. Exemplet nedan använder integration="api" för att hämta en produktbeskrivning från en API-katalog.

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

1. I Klaviyo navigerar du till Innehåll > Produkter.
2. Använd filtret Katalogalternativ för att välja den katalog du vill använda. Standardvalet är 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 %}

Ersätt exempelartikel-ID:t och katalog-ID:t med dina egna värden. Förhandsgranska sedan meddelandet och kontrollera att det visar de förväntade produktuppgifterna. Om sökningen inte kan hitta en matchning i katalogen du anger kan den falla tillbaka till en annan katalog i ditt Konto.

Filtrering efter språkinställning

Om din katalog innehåller lokaliserade produktdata, till exempel en Shopify-katalog med lokaliserade data som synkas till Klaviyo, kan du söka upp en produkt per språkvariant. Inkludera både språk och region med språkkoder och landskoder på två bokstäver från ISO 639 respektive ISO 3166. Till exempel begär language='fr' och region='CA' franska produktdata för Kanada. 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 helst inte vill skicka alla produktuppgifter som behöver ingå i ett meddelande. Till exempel: i ett meddelande om övergiven kundvagn skickar du bara Product IDs för alla övergivna varor, så kan Klaviyo slå upp varje vara och hämta in alla relevanta uppgifter. Det finns inget behov av att varje händelse innehåller produktnamn, pris, bild osv., eftersom allt detta kan fyllas i genom att bara skicka Product ID till Klaviyo och sedan slå 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 objekt (t.ex. titel eller bild).

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:

Följande HTML-exempel hämtar artikelbild, titel och beskrivning för varje artikel i event.Items. Det förutsätter att varje artikel har ett SKU -värde som matchar artikel-ID:t i din Klaviyo-katalog. Om din händelse använder en annan egenskap för katalogens artikel-ID ersätter du item.SKU med den egenskapen. Använd HTML-exemplen i ett e-postmeddelande; för sms eller push använder du katalogetiketterna med textfält i stället för HTML-uppmärkning.

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

Lagra Recommended Products som en lista med artikel-ID:n, till exempel ["KLAVIYO-TSHIRT", "KLAVIYO-HAT"]. Ersätt dessa exempel-ID:n med ID:n från din katalog och ersätt egenskapsnamnet i koden om ditt är annorlunda.

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

Lagra ett enskilt artikel-ID som ett textvärde i Recommended Products, till exempel KLAVIYO-TSHIRT. Använd egenskapsnamnet och artikel-ID:t från ditt eget konto.

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