Kataloguppslagning etikett referens

Du kommer att lära dig

Lär dig hur du använder katalogetiketten, som gör att du kan hänvisa till specifik produktinformation från din katalog i dina e-post-, sms- och pushnotis-meddelanden. Detta är användbart när du vill skapa anpassade produktrekommendationer eller korsreferera produktinformation. Om du t.ex. använder din egen rekommendationsmotor kan du skicka dina egna produktrekommendationer som händelse eller profildata till Klaviyo och sedan använda data i köpcentret.

{% catalog %} etikett

Etikett {% catalog %} etikett använder följande syntax:

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

Ersätt itemID med produkt-ID för den produkt som du refererar till. Detta är produkt-ID:t som synkroniserats från din egen produktkatalog. Observera att denna sökning gäller specifikt för produkt-ID och inte SKU.

Genom att inkludera unpublished="cancel" säkerställer du att du inte skickar ditt meddelande i händelse av att den artikel som hänvisas till är opublicerad. Detta argument är valfritt. 

• Om något objekt som du hänvisar till i ditt meddelande inte är publicerat i din katalog vid tidpunkten för sökningen kommer hela meddelandet att hoppas över.
• För ett visst flöde av meddelanden kan du navigera till analys > mottagare Aktivitet > Övrigt och se en lista märkt Skippad: Katalogobjektet är inte tillgängligt. Denna lista innehåller alla profiler som hoppades över på grund av att en artikel i meddelandet var slut i lager eller på annat sätt inte fanns tillgänglig.

När du använder denna funktion, mellan den inledande och avslutande katalogetiketten, kan du referera till specifika data från den artikel som är associerad med artikelID i din Klaviyo produktkatalog.

Följande data är tillgängliga för referens inuti ett {% catalog %} block.

Det kan finnas ytterligare data -fält tillgängliga som betraktas som metadata. Om du vill referera till en av dessa ytterligare objektsegenskaper kan du använda variabelsyntaxen: {{ catalog_item.metadata.color }}. I det här fallet kommer variabeln att hämta in värdet "color" som är kopplat till artikeln butik i artikelns metadata.

För att få tillgång till en förhandsgranskning av alla tillgängliga detaljer om en artikel - inklusive alla metadata - lägg till följande utdrag i en text block i en testgalleria och uppdatera itemID med produkt-ID för en av de aktuella produkterna i din katalog.

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

Förhandsgranska sedan meddelandet. Denna förhandsgranskning ger en råversion av alla tillgängliga data för dina produkter.

Filtrering efter katalog-ID 

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

Först hittar du katalog-ID:t:

1. I Klaviyo navigerar du till Content > Products.
2. Välj den katalog som du vill använda i rullgardinsmenyn Alla kataloger.
   
3. Kopiera katalog-ID:t från webbadressen.
   

Leta sedan reda på artikelns ID:

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

I exemplet ovan skulle koden se ut på följande sätt:

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

Leta upp ett objekt-ID som skickas med en händelse

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

• Om du använder en anpassad integration där produktrekommendationer skickas tillsammans med en händelse som ska visas i meddelandet. Till exempel ett övergivet surfmeddelande där unika rekommendationer genereras baserat på visade artiklar. Istället för att fylla i den enskilda artikeln som en kund tittade på i meddelandet kan du generera och fylla i en uppsättning rekommenderade artiklar baserat på den artikel som visades. En uppsättning produkt-ID:n måste skickas till Klaviyo tillsammans med händelsen.
• Om du använder en anpassad integrationstjänst och du föredrar att inte skicka alla produktdetaljer som behöver skickas i ett meddelande. Till exempel, med ett meddelande om övergiven kundvagn, skicka bara produkt-ID: n för alla övergivna artiklar så kan Klaviyo leta upp var och en för att hämta alla relevanta detaljer. Det finns inget behov av att varje händelse ska innehålla produktnamn, pris, bild etc. eftersom allt detta kan fyllas i genom att bara skicka produkt-ID till Klaviyo och sedan leta upp informationen i din Klaviyo-produktkatalog.

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

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

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

Inom detta {% catalog %} block lägg till malltagg för data som du vill fylla i för varje artikel (t.ex. titel, bild etc.)

Om vi till exempel använder exempelkatalogartikeln data nedan kan vi bygga upp en {% catalog %} block som refererar till viktig produktinformation:

Katalogobjekt data:

{
 " beskrivning": "Standard fråga för alla Klaviyos. Denna t-shirt har Klaviyo -logotypen på framsidan och märkesdiagrammet på tillbaka.",
  "url": "https://klaviyogear.myshopify.com/collections/klaviyo-classics/products/short-sleeve-t-shirt-1",
  "titel": "Klassisk 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"
  }
}

mall block syntax:

Syntaxen för följande block {% catalog %} block skulle hämta objektbild, objekttitel och objektbeskrivning från din katalog, för varje objekt 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 sökfunktionen inte hittar det objekt som den letar efter, hoppas meddelandet över och skickas inte.

Leta upp ett artikel-ID som en anpassad egenskap

Om du använder din egen rekommendationsmotor kan du skicka rekommenderade artikel-ID:n till profil i Klaviyo som en anpassad profilegenskaper. Använda en {% catalog %} etikett kan du hänvisa till information från någon av dessa produkter när du skickar meddelanden till denna kund.

Om sökfunktionen inte hittar det objekt som den letar efter, hoppas meddelandet över och skickas inte.

Syntax för flera artikel-ID:n i en och samma fastighet

{% 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 föremåls-ID i en profilegenskaper

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

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

Använd exempelkoden nedan för att använda denna etikett och ersätt itemID med ett produkt-ID från din katalog och category_name med hela eller delar av ett kategorinamn. 

{% catalog itemID %}
{{ catalog_item.title }}
{% has_category catalog_item "category_name" as in_category %}
{% if in_category %}
Jag är på rea!
{% else %}
{% endif %}
{% endcatalog %}

I det här exemplet visas produkttiteln och sedan kontrolleras om produkten finns i en kategori, category_name. Om detta utvärderas som sant kommer meddelandet "Jag är på rea!" att visas efter produkttiteln. 

Ytterligare resurser

• Så här använder du produktfeed och rekommendationer
• Översikt över redigeraren för e-postmallar