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.
Pamiętaj, że ten przewodnik jest przeznaczony dla doświadczonego marketingowca lub klienta, który ma dostęp do programisty.
{% 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.
| Znacznik szablonu | Nazwa | Opis |
|---|---|---|
{{ catalog_item.description }} |
Opis | Opis przedmiotu. |
{{ catalog_item.url }} |
Adres URL | Adres URL umożliwiający dostęp do elementu w Twoim sklepie. |
{{ catalog_item.title }} |
Nazwa | Tytuł elementu. |
{% currency_format catalog_item.metadata|lookup:"price" %} |
Cena | Cena przedmiotu. Ten znacznik formatuje cenę przedmiotu z poprawnym prefiksem waluty. |
{{ catalog_item.currency_symbol }} |
Symbol waluty | Symbol graficzny używany do oznaczenia jednostki walutowej |
{{ catalog_item.currency_code }} |
Kod waluty | Kod alfabetyczny używany do oznaczania waluty |
{{ catalog_item.featured_image.full.src }} |
Pełny obraz | Adres URL pełnego obrazu elementu. Użyj tego wewnątrz bloku obrazu lub znacznika <img>. |
{{ catalog_item.featured_image.thumbnail.src }} |
Miniatura | Adres URL pełnego obrazu elementu. Użyj tego w znaczniku <img> w niestandardowym kodzie HTML lub użyj go jako dynamicznego adresu URL obrazu otoczonego otwierającym i zamykającym znacznikiem {% catalog %}. |
{{ catalog_item.id }} |
Id | Identyfikator produktu. |
{{ catalog_id }} |
Identyfikator katalogu | Identyfikator katalogu, dzięki któremu możesz określić, z którego katalogu pobrać dane, jeśli masz ich wiele. |
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:
- W Klaviyo przejdź do sekcji Zawartość > Produkty.
- Z listy rozwijanej Wszystkie katalogiwybierz katalog, którego chcesz użyć.
- Skopiuj identyfikator katalogu z adresu URL.
Następnie znajdź identyfikator przedmiotu:
- Po wybraniu katalogu wybierz z niego produkt, którego chcesz użyć.
- 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 %}Filtrowanie według lokalizacji
Katalogi uwzględniające lokalizację, takie jak katalog Shopify w Klaviyo, można wyszukiwać według lokalizacji. Język lokalny i region można określić za pomocą dwuliterowego kodu kraju i języka przy użyciu standardów ISO 3166 i 639. Jeśli nie można znaleźć zlokalizowanego produktu, użyte zostaną 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 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
<img src= style= display: inline-block; border: none width= 150px / p{% for item in person|lookup:'Recommended Products' %}{% catalog item %} {{ catalog_item.featured_image.thumbnail.src }}<p>{{ catalog_item.title }} {% endcatalog %}</p>
{% endfor %}/p" """"">
<> <>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!".
Znacznik has_category wyszukuje pełne i częściowe dopasowania do ustawionej nazwy kategorii. Na przykład, jeśli użyjesz "wyprzedaż" jako nazwy kategorii, a produkt ma znacznik "na wyprzedaży", znacznik has_category zostanie oceniony jako prawdziwy dla tego produktu.