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 wartością ID elementu widoczną na stronie szczegółów produktu w Klaviyo. Wartość musi odpowiadać identyfikatorowi elementu zapisanym w Twoim katalogu; użyj SKU tylko wtedy, gdy jest ono również identyfikatorem elementu w katalogu. Zachowaj cudzysłowy wokół dosłownego identyfikatora ID. Gdy używasz zmiennej zdarzenia lub profilu, pozostaw zmienną bez cudzysłowów, jak pokazano w przykładach poniżej.

Uwzględnienie unpublished="cancel" zapobiega wysłaniu wiadomości, jeśli element, do którego odwołuje się to odwołanie, nie jest opublikowany w Twoim katalogu Klaviyo. Ten argument jest opcjonalny. Bez niego nieopublikowany element nadal może pojawić się w wiadomości.

• Jeśli podczas wyszukiwania dowolne zapytanie z parametrem unpublished="cancel" znajdzie nieopublikowany element, cała wiadomość zostanie pominięta dla tego odbiorcy.
• W przypadku wiadomości w sekwencji otwórz jej analitykę i wybierz Aktywność odbiorców > Pominięte. W menu rozwijanym Typ wybierz Pominięto: pozycja katalogu niedostępna. Ta lista obejmuje profile, których wiadomości zostały pominięte, ponieważ nie udało się znaleźć elementu, do którego się odwoływano, lub ponieważ za pomocą unpublished="cancel" wyszukiwano nieopublikowany element. Element może być nieopublikowany, ponieważ jest niedostępny w magazynie lub w inny sposób niedostępny w Twoim katalogu.

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 zapisanych w elemencie — w tym wszystkich metadanych — dodaj poniższy fragment kodu do bloku tekstowego w testowym szablonie i zaktualizuj itemID, podając identyfikator elementu (Item ID) 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, użyj argumentu catalog_id w otwierającym znaczniku {% catalog %}, aby określić katalog. Musisz też uwzględnić integration, a obie wartości ująć w cudzysłów. Na przykład możesz mieć katalog zsynchronizowany przez integrację Klaviyo, taką jak Shopify, katalog zsynchronizowany przez API lub niestandardowy kanał danych katalogu. Wartość integracji musi być zgodna ze źródłem katalogu. Poniższy przykład używa integration="api" do pobrania opisu produktu z katalogu API.

Najpierw znajdź identyfikator katalogu:

1. W Klaviyo przejdź do Treść > Produkty.
2. Użyj filtra Opcje katalogu, aby wybrać katalog, którego chcesz użyć. Domyślny wybór to Wszystkie katalogi.

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

Zastąp przykładowy identyfikator elementu i identyfikator katalogu własnymi wartościami, a następnie wyświetl podgląd wiadomości i sprawdź, czy pokazuje oczekiwane szczegóły produktu. Jeśli wyszukiwanie nie znajdzie dopasowania w katalogu, który wskażesz, może przełączyć się na inny katalog na Twoim koncie.

Filtrowanie według ustawień regionalnych

Jeśli Twój katalog zawiera zlokalizowane dane produktów, na przykład katalog Shopify z danymi zlokalizowanymi zsynchronizowanymi z Klaviyo, możesz wyszukać produkt według ustawień regionalnych. Uwzględnij zarówno język, jak i region, używając odpowiednio 2-literowych kodów języka i kraju z ISO 639 oraz ISO 3166. Na przykład language='fr' i region='CA' wymagają danych produktu w języku francuskim dla Kanady. Jeśli nie można znaleźć zlokalizowanego produktu, używane są 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 wyślij tylko identyfikatory produktów (Product IDs) wszystkich porzuconych pozycji, a Klaviyo może wyszukać każdą 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 (Product ID), a następnie wyszukując informacje w Twoim 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 znaczniki szablonu dla danych, które chcesz uzupełnić dla każdego elementu (np. tytuł lub obraz).

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:

Poniższy przykład HTML pobiera obraz, tytuł i opis dla każdego elementu w event.Items. Zakłada on, że każdy element ma wartość SKU, która odpowiada identyfikatorowi elementu w Twoim katalogu Klaviyo. Jeśli Twoje zdarzenie używa innej właściwości dla identyfikatora elementu katalogu, zastąp item.SKU tą właściwością. Użyj przykładów HTML w e-mailu; w przypadku SMS-ów lub powiadomień push użyj znaczników katalogu z polami tekstowymi zamiast znaczników HTML.

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

Przechowuj Recommended Products jako listę identyfikatorów elementów, np. ["KLAVIYO-TSHIRT", "KLAVIYO-HAT"]. Zastąp te przykładowe identyfikatory identyfikatorami z Twojego katalogu i zastąp nazwę właściwości w kodzie, jeśli u Ciebie jest inna.

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

Zapisz pojedynczy identyfikator elementu jako wartość tekstową w Recommended Products, na przykład KLAVIYO-TSHIRT. Użyj nazwy właściwości i identyfikatora elementu ze swojego konta.

{% 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!”.

Dodatkowe źródła