Materiały referencyjne dotyczące znaczników wyszukiwania w katalogu

Czego się dowiesz?

Dowiedz się, jak korzystać ze znacznika katalogu, który pozwala odwoływać się do konkretnych informacji o produkcie z katalogu w e-mailach, SMS-ach i wiadomościach push. Jest to przydatne, gdy chcesz tworzyć niestandardowe rekomendacje produktów lub zestawiać informacje o produktach. Na przykład, jeśli używasz własnego silnika rekomendacji, możesz przekazywać własne rekomendacje produktów jako dane zdarzenia lub profilu do Klaviyo, a następnie wykorzystywać te dane w szablonach.

Znacznik {% catalog %}

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

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

Zastąp itemID identyfikatorem produktu produktu, do którego się odwołujesz. To identyfikator produktu zsynchronizowany z Twojego katalogu produktów. Uwaga: to wyszukiwanie dotyczy konkretnie identyfikatora produktu, a nie SKU.

Uwzględnienie unpublished="cancel" sprawi, że nie wyślesz wiadomości, jeśli element, do którego odnosi się odwołanie, jest nieopublikowany. Ten argument jest opcjonalny.

• Jeśli jakikolwiek element, do którego odwołujesz się w wiadomości, jest nieopublikowany w katalogu w momencie wyszukiwania, cała wiadomość zostanie pominięta.
• Dla danej wiadomości w sekwencji możesz przejść do Analityka > Aktywność odbiorców > Inne i zobaczyć listę oznaczoną jako Pominięto: element katalogu niedostępny. Ta lista obejmuje wszystkie profile, które zostały pominięte, ponieważ element wyróżniony w wiadomości był niedostępny w magazynie lub w inny sposób niedostępny.

Podczas korzystania z tej funkcji, między otwierającymi i zamykającymi tagami katalogu, możesz odwoływać się do konkretnych danych z elementu powiązanego z itemID w katalogu produktów Klaviyo.

Poniższe dane są dostępne do odwołań wewnątrz bloku {% catalog %}.

Mogą być dostępne dodatkowe pola danych, które są uznawane 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 przechowywaną w metadanych elementu.

Aby uzyskać dostęp do podglądu wszystkich dostępnych szczegółów przechowywanych w elemencie — w tym wszystkich metadanych — dodaj poniższy fragment do bloku tekstowego w testowym szablonie i zaktualizuj itemID, podając identyfikator produktu jednego z aktualnych produktów w Twoim katalogu.

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

Następnie wyświetl podgląd wiadomości. Ten podgląd zawiera surową 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ć dane, używając znacznika {{catalog id}}. Na przykład możesz mieć katalog zsynchronizowany za pośrednictwem integracji Klaviyo, takiej jak Shopify, katalog zsynchronizowany przez API lub niestandardowy kanał katalogu. Szczegóły znaczników mogą się różnić w zależności od integracji. W poniższym przykładzie wiele katalogów jest synchronizowanych z tym samym kontem Klaviyo i chcemy pobrać opis produktu z konkretnego produktu znajdującego się w katalogu API.

Najpierw znajdź identyfikator katalogu:

1. W Klaviyo przejdź do Treść > Produkty.
2. Wybierz z listy rozwijanej Wszystkie katalogi katalog, którego chcesz użyć.
   

3. Skopiuj identyfikator katalogu z adresu URL.
   

Następnie znajdź identyfikator elementu:

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

W przypadku powyższego przykładu kod wyglądałby tak:

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

Filtrowanie według ustawień regionalnych

Katalogi uwzględniające ustawienia regionalne, takie jak katalog Shopify w Klaviyo, można przeszukiwać według ustawień regionalnych. Język i region ustawień regionalnych można określić za pomocą dwuliterowego kodu kraju i języka zgodnie ze standardami ISO 3166 i 639. Jeśli nie można znaleźć zlokalizowanego produktu, zostaną użyte domyślne informacje o produkcie.

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

Wyszukaj identyfikator elementu przekazany ze zdarzeniem

Wyszukiwanie w katalogu z użyciem zdarzenia jest najczęściej stosowane w następujących scenariuszach:

• Jeśli używasz niestandardowej integracji, w której rekomendacje produktów są przekazywane wraz ze zdarzeniem do wyświetlenia w wiadomości. Na przykład wiadomość z sekwencji porzuconego przeglądania, w której unikalne rekomendacje są generowane na podstawie przeglądanych produktów. Zamiast wypełniać w wiadomości pojedynczy produkt, który klient przeglądał, możesz wygenerować i wypełnić zestaw polecanych produktów na podstawie tego przeglądanego produktu. Do Klaviyo należy wysłać wraz ze zdarzeniem zestaw identyfikatorów produktów.
• Jeśli używasz niestandardowej integracji i wolisz nie wysyłać wszystkich szczegółów produktu, które muszą znaleźć się w wiadomości. Na przykład w przypadku wiadomości o porzuconym koszyku zakupowym wysyłaj tylko identyfikatory produktów wszystkich porzuconych elementów, a Klaviyo może wyszukać każdy z nich, aby pobrać wszystkie istotne szczegóły. Nie ma potrzeby, aby każde zdarzenie zawierało nazwę produktu, cenę, obraz itp., ponieważ wszystko to można uzupełnić, przekazując do Klaviyo tylko identyfikator produktu, a następnie wyszukując informacje w katalogu produktów Klaviyo.

Gdy używasz znacznika {% catalog %} ze zdarzeniem, wyszukiwanie jest oparte na identyfikatorze elementu katalogu (będzie to identyfikator produktu lub SKU, w zależności od integracji).

W przypadku zdarzenia, w którym przekazywaną wartością identyfikującą jest identyfikator elementu, znaczniki wyszukiwania będą wyglądać tak:

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

W tym bloku {% catalog %} dodaj znacznik szablonu dla danych, które chcesz wypełnić w odniesieniu do każdego elementu (np. tytuł, obraz itp.)

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

Dane elementu katalogu:

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

Składnia bloku szablonu:

Składnia dla poniższego bloku {% catalog %} pobierze z katalogu obraz produktu, tytuł produktu i opis produktu dla każdego produktu 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ść zostaje pominięta i nie jest wysyłana.

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

Jeśli używasz własnego silnika rekomendacji, możesz przekazywać rekomendowane identyfikatory elementów do profili w Klaviyo jako niestandardową właściwość profilu. Korzystając ze znacznika {% catalog %}, 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ść zostaje pominięta i nie jest wysyłana.

Składnia dla wielu identyfikatorów elementów przechowywanych 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 pojedynczego identyfikatora elementu we właściwościach 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>

Informacje o znaczniku has_category

Użyj znacznika has_category, aby określić, czy element w katalogu należy do określonej kategorii. Musi być używany w obrębie znacznika wyszukiwania w katalogu dla konkretnego elementu.

Użyj poniższego przykładowego kodu, aby zastosować ten znacznik, zastępując itemID identyfikatorem produktu z katalogu, a category_name całą lub częścią nazwy kategorii.

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

Ten przykład wyświetla tytuł produktu, a następnie sprawdza, czy produkt znajduje się w kategorii category_name. Jeśli ta wartość zostanie oceniona jako true, po tytule produktu pojawi się komunikat „Jestem w promocji!”.