Katalog wyszukiwania znaczników referencyjnych

Czego się dowiesz

Dowiedz się, jak korzystać ze znacznika katalogu, który umożliwia odwoływanie się do określonych informacji o produkcie z katalogu w wiadomościach e-mail, SMS i wiadomościach Push. Jest to przydatne, gdy chcesz tworzyć niestandardowe rekomendacje produktów lub porównywać informacje o produktach. Na przykład, jeśli korzystasz z własnego silnika rekomendacji, możesz przekazać własne rekomendacje produktów jako zdarzenie lub dane profilowe do Klaviyo, a następnie wykorzystać te dane w szablonie.

{% catalog %} znacznik

Znacznik {% catalog %} znacznik używa następującej składni:

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

Zastąp itemID identyfikatorem produktu, do którego się odwołujesz. Jest to identyfikator produktu zsynchronizowany z Twoim katalogiem produktów. Zwróć uwagę, że to wyszukiwanie dotyczy identyfikatora produktu, a nie jednostki SKU.

Dołączenie unpublished="cancel" zapewni, że nie wyślesz wiadomości w przypadku, gdy element, do którego się odwołujesz, jest nieopublikowany. Ten argument jest opcjonalny. 

• Jeśli jakikolwiek element, do którego odwołuje się twoja wiadomość, nie jest opublikowany w twoim katalogu w momencie wyszukiwania, cała wiadomość zostanie pominięta.
• Dla danej wiadomości sekwencji możesz przejść do dane analityczne > odbiorcy Aktywność > Inne i zobaczyć listę oznaczoną jako Pominięte: Pozycja katalogowa niedostępna. Lista ta zawiera wszystkie profile, które zostały pominięte, ponieważ produkt przedstawiony w wiadomości był niedostępny lub w inny sposób niedostępny.

Korzystając z tej funkcji, pomiędzy znacznikiem otwierającym i zamykającym katalog, możesz odwołać się do konkretnych danych z pozycji powiązanej z identyfikatorem itemID w swoim Klaviyo katalogu produktów.

Następujące dane są dostępne do odwołania wewnątrz pliku {% catalog %} blok.

Mogą być dostępne dodatkowe pola danych, które są uważane za metadane. Aby odwołać się do jednej z tych dodatkowych właściwości elementu, możesz użyć składni zmiennej: {{ catalog_item.metadata.color }}. W tym przypadku zmienna pobierze wartość "color" powiązaną z elementem sklep w metadanych elementu.

Aby uzyskać dostęp do podglądu wszystkich dostępnych szczegółów sklepu na temat elementu - w tym wszystkich metadanych - dodaj następujący fragment do bloku tekstowego w szablonie testowym i zaktualizuj itemID za pomocą identyfikatora produktu jednego z bieżących produktów w katalogu.

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

Następnie wyświetl podgląd wiadomości. Ten podgląd zapewnia nieprzetworzoną wersję wszystkich danych dostępnych dla twoich produktów.

Filtrowanie według identyfikatora katalogu 

Jeśli masz wiele katalogów, możesz określić, z którego katalogu chcesz pobierać, używając znacznika {{catalog id}} znacznik. Na przykład, możesz mieć katalog zsynchronizowany za pośrednictwem integracji Klaviyo, takiej jak Shopify, katalog zsynchronizowany za pośrednictwem API lub niestandardowy kanał katalogowy. Szczegóły znacznika mogą się różnić w zależności od Twojej integracji. W poniższym przykładzie wiele katalogów jest zsynchronizowanych z tym samym kontem Klaviyo i chcemy pobrać opis produktu z określonego produktu zawartego w katalogu API.

Najpierw znajdź identyfikator katalogu:

1. W Klaviyo przejdź do sekcji Zawartość > Produkty.
2. Z listy rozwijanej Wszystkie katalogiwybierz katalog, którego chcesz użyć.
   
3. Skopiuj identyfikator katalogu z adresu URL.
   

Następnie znajdź identyfikator przedmiotu:

1. Po wybraniu katalogu wybierz z niego produkt, którego chcesz użyć.
2. Na stronie szczegółów produktu zobaczysz identyfikator przedmiotu.
   

W powyższym przykładzie kod wyglądałby następująco:

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

Wyszukaj identyfikator przedmiotu przekazany wraz ze zdarzeniem

Korzystanie z wyszukiwania w katalogu ze zdarzeniem jest najczęściej używane w następujących scenariuszach:

• Jeśli korzystasz z niestandardowej integracji, w której rekomendacje produktów są przekazywane wraz ze zdarzeniem do wyświetlenia w wiadomości. Na przykład, sekwencja porzuconego przeglądania wiadomości, w której unikalne rekomendacje są generowane na podstawie oglądanych przedmiotów. Zamiast wypełniać pojedynczy element wyświetlony przez klienta w wiadomości, możesz wygenerować i wypełnić zestaw rekomendowanych elementów na podstawie wyświetlonego elementu. Zestaw identyfikatorów produktów musi zostać wysłany do Klaviyo wraz ze zdarzeniem.
• Jeśli korzystasz z niestandardowej integracji i wolisz nie wysyłać wszystkich szczegółów produktu, które muszą zostać przesłane w wiadomości. Na przykład, wysyłając wiadomość porzucony koszyk zakupowy, wyślij tylko identyfikatory produktów wszystkich porzuconych przedmiotów, a Klaviyo może sprawdzić każdy z nich, aby uzyskać wszystkie istotne szczegóły. Nie ma potrzeby, aby każde zdarzenie zawierało nazwę produktu, cenę, obraz itp., ponieważ wszystko to można wypełnić, przekazując tylko identyfikator produktu do Klaviyo, a następnie wyszukując informacje w Twoim Klaviyo katalog produktów.

Gdy używasz znacznika {% catalog %} znacznik ze zdarzeniem, wyszukiwanie opiera się na identyfikatorze pozycji katalogu (będzie to albo identyfikator produktu, albo SKU w zależności od integracji).

W przypadku zdarzenia, w którym przekazaną wartością identyfikującą jest Item ID, znacznik wyszukiwania będzie wyglądał następująco:

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

W ramach tego {% catalog %} blok, dodaj znacznik szablonu dla danych, które chcesz wypełnić dla każdego elementu (tj. tytuł, obraz itp.)

Na przykład, korzystając z poniższego przykładowego elementu katalogu, możemy utworzyć plik {% catalog %} blok, który odwołuje się do kluczowych informacji o produkcie:

Pozycja katalogowa dane:

{
 " opis": "Standard kwestia dla wszystkich Klaviyos. Ta koszulka ma logo Klaviyo z przodu i schemat znaków na plecach.",
  "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",
 " metadane": {
    "Color": "Grey",
    "Design": "Standard"
  }
}

szablon blok składnia:

Składnia następującego polecenia {% catalog %} blok pobierze obraz przedmiotu, tytuł przedmiotu i opis przedmiotu z twojego katalogu dla każdego przedmiotu w zdarzeniu:

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

Jeśli wyszukiwanie nie może znaleźć szukanego elementu, wiadomość jest pomijana i nie jest wysyłana.

Wyszukaj identyfikator elementu jako właściwość niestandardową

Jeśli korzystasz z własnego silnika rekomendacji, możesz przekazać identyfikatory polecanych przedmiotów do profilu w Klaviyo jako niestandardowe właściwości profilu. Używając znacznika {% catalog %} znacznik, możesz odwoływać się do informacji z dowolnego z tych produktów podczas wysyłania wiadomości do tego klienta.

Jeśli wyszukiwanie nie może znaleźć szukanego elementu, wiadomość jest pomijana i nie jest wysyłana.

Składnia dla wielu identyfikatorów przedmiotów sklep w jednej właściwości

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

Składnia dla pojedynczego identyfikatora elementu we właściwości profilu

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

O has_category znacznik

Użyj znacznika has_category, aby określić, czy element w twoim katalogu jest częścią określonej kategorii. Musi on być używany w ramach znacznika wyszukiwania katalogu dla konkretnego elementu. 

Użyj poniższego przykładowego kodu, aby użyć tego znacznika, zastępując itemID identyfikatorem produktu z katalogu i category_name całą nazwą kategorii lub jej częścią. 

{% catalog itemID %}
{{ catalog_item.title }}
{% has_category catalog_item "category_name" as in_category %}
{% if in_category %}
Jestem na wyprzedaży!
{% else %}
{% endif %}
{% endcatalog %}

Ten przykład wyświetla tytuł produktu, a następnie sprawdza, czy produkt należy do kategorii category_name. Jeśli ocena będzie prawdziwa, po tytule produktu pojawi się komunikat "Jestem w wyprzedaży!". 

Dodatkowe źródła

• Jak używać feed produktowy i rekomendacje
• Przegląd edytora szablonów e-mailowych