Jak używać obiektów niestandardowych w szablonach
Aby korzystać z tej funkcji, musisz mieć dostęp do obiektów niestandardowych.
Czego się dowiesz?
Dowiedz się, jak używać niestandardowych obiektów w szablonach, aby móc wykorzystywać dane obiektów w wysyłanych sekwencjach i kampaniach.
Przed użyciem niestandardowych danych obiektu w szablonach musisz najpierw utworzyć obiekt.
Uzyskiwanie dostępu do danych obiektu za pomocą menu personalizacji
Możesz personalizować bloki tekstu w edytorze szablonów za pomocą właściwości z obiektu niestandardowego lub na podstawie liczby rekordów dla obiektu.
Dowiedz się jak korzystać z edytora szablonów Klaviyo.
Aby rozpocząć dodawanie danych obiektu do szablonów:
- Dodaj nowy blok tekstu lub wybierz istniejący blok tekstu.
- Kliknij dwukrotnie blok tekstu, a następnie ustaw kursor w miejscu, w którym chcesz wstawić właściwość dynamiczną.
- W prawym górnym rogu wybierz przycisk Personalizacja .
- W modalu personalizacji wybierz Obiekty z listy rozwijanej Wszystkie typy .
- W sekcji Obiekty zobaczysz wszystkie obiekty na swoim koncie, których możesz użyć do pobierania danych do szablonu. Wybierz obiekt zawierający dane, których chcesz użyć w szablonie.
- Wybierz konkretną właściwość obiektu lub filtr obiektu, który chcesz uwzględnić w szablonie. Tutaj możesz też utworzyć nowy filtr obiektów.
- Ustaw tekst domyślny oraz style dla tekstu.
Aby określić reguły zapisu wielkimi literami dla danych obiektu, trzeba ręcznie ustawić regułę w znaczniku personalizacji. Na przykład:
- {{ object.full_name|title|default:'value' }}
John Doe - {{ object.full_name|upper|default:'value' }}
JOHN DOE - {{ object.full_name|lower|default:'value' }}
john doe
Dowiedz się więcej o modyfikowaniu wartości za pomocą filtrów Django.
Uzyskiwanie dostępu do danych obiektu za pomocą znaczników personalizacji
Możesz używać znaczników personalizacji w e-mailach (w tym w temacie wiadomości), wiadomościach SMS/MMS, powiadomieniach push oraz w Klaviyo Customer Hubie, aby wyświetlać dane obiektu.
Dowiedz się, jak używać znaczników personalizacji w Klaviyo.
Odwołanie do znaczników personalizacji obiektów
Można używać następujących znaczników personalizacji z obiektami.
Korzystanie z obiektu, który uruchomił sekwencję
{{ object }} jest dostępny tylko wtedy, gdy obiekt uruchomił sekwencję. Znacznik szablonu {{ object }} jest dostępny tylko w sekwencjach uruchamianych przez datę na podstawie obiektu. Jest to podobne do znacznika szablonu {{ event }} dla sekwencji uruchamianych przez zdarzenie.
W tych przykładach używane są następujące elementy:
- Obiekt o nazwie Pet , do którego odwołuje się znacznik obiektu w szablonie.
- Właściwość obiektu o nazwie Nazwa
Struktura | Przykład |
{{ object.object_property }} | {{ object.Name }} |
{{ object | lookup:'object_property' }} | {{ object | lookup:'Name' }} |
Pobieranie obiektu według identyfikatora
W tych przykładach używane są następujące elementy:
- Obiekt o nazwie Pet
- Właściwość obiektu o nazwie Nazwa
- Zdarzenie, które wywołało sekwencję, z właściwością obiektu o nazwie pet_id. To pole jest takie samo jak identyfikator obiektu dla obiektu Pet.
Struktura | Przykład |
{% customobject event.object_id object_type_title="Title" as alias %} | {% customobject event.pet_id object_type_title="Pet" as pet %} |
{%% customobject event.object_id object_type_title="Title" jako alias %} | {% customobject event.pet_id object_type_title="Pet" as pet %} |
Zwraca z filtra obiektów pojedynczy obiekt
W tych przykładach używane są następujące elementy:
- Dodatkowy filtr obiektów o nazwie oldest_dog
- Właściwość obiektu o nazwie Nazwa
Struktura | Przykład |
{{ object_filter.object_filter_name.object_property}} | {{ object_filter.oldest_dog.Name }} |
{{ object_filter.object_filter_name | lookup: 'object_property' }} | {{ object_filter.oldest_dog | lookup: 'Name' }} |
Zwróć liczbę całkowitą z filtra obiektów
W tych przykładach używane są następujące elementy:
- Dodatkowy filtr obiektów o nazwie count_of_dogs
Struktura | Przykład |
{{ object_filter.object_filter_name }} | {{ object_filter.count_of_dogs }} |
Pobierz rekordy obiektów
Aby pobrać najnowsze rekordy obiektu dla obiektu, musisz przejść w pętli przez wszystkie rekordy obiektu. Ten przykład korzysta z następujących elementów:
- Obiekt o nazwie Zwierzęta
Struktura | Przykład |
{% customobjects object_type_title="Title" as alias %} | {% customobjects object_type_title="Pet Profile" as pets %} |
Dane obiektów w temacie wiadomości
Możesz spersonalizować temat wiadomości za pomocą dowolnych znaczników obiektów niestandardowych:
- {% object_filter %}
- {% object %}
- {% customobject %}
Na przykład możesz użyć znacznika {% object %} w temacie wiadomości, aby wyświetlić bezpośrednio imię zwierzaka klienta.
Widok wersji roboczej:
Podgląd e-maila:
Dane obiektu w logice pokaż/ukryj
Możesz też skonfigurować, czy blok ma być wyświetlany czy ukryty w szablonie na podstawie danych obiektu. Dynamiczne wyświetlanie lub ukrywanie bloku na podstawie danych obiektu korzysta z tych samych znaczników co kreator szablonów. Możesz odwoływać się do obiektów według identyfikatora, właściwości z filtrów obiektów lub agregatów z filtrów obiektów.
Aby móc odwoływać się do filtrów obiektów w logice pokaż/ukryj, musisz je najpierw utworzyć.
Na przykład, jeśli istnieje obiekt Pet z właściwością o nazwie Breed, można wybrać, aby wyświetlać blok tylko właścicielom zwierząt z określoną rasą psa, używając warunku object.Breed .
Aby skonfigurować logikę pokaż/ukryj, kliknij blok, dla którego chcesz ustawić reguły, i wybierz Użyj kodu na karcie Wyświetlanie.
Wprowadź warunek bezpośrednio w edytorze kodu. Możesz używać filtrów obiektów i znacznika szablonu obiektu, jeśli jest to wiadomość w sekwencji wyzwalanej datą na podstawie danych obiektu.
Aby uzyskać większą elastyczność (np. aby uzależnić część informacji od informacji zwróconych przez {% customobject %} lub {% customobjects %}), rozważ użycie zaawansowanej logiki warunkowej z logiką {% if ... %} bezpośrednio w bloku tekstowym.
Filtry obiektów
Co to jest filtr obiektów?
Filtry obiektów umożliwiają ograniczenie zwracanych rekordów obiektów na podstawie określonych kryteriów, które ustawisz, dzięki czemu możesz wyświetlać rekordy określonego typu.
Utwórz nowy filtr obiektów
Aby zacząć tworzyć filtr obiektów:
- Dodaj nowy blok tekstu lub edytuj tekst w istniejącym bloku tekstu w swoim szablonie.
- Wybierz przycisk Personalizacja .
- W modelu personalizacji wybierz Obiekty z listy rozwijanej Wszystkie typy .
- Wybierz obiekt zawierający dane, dla których chcesz ustawić filtr.
- Wybierz właściwość obiektu, dla której chcesz ustawić filtr.
- Wybierz Utwórz nowy filtr.
W oknie modalnym Utwórz filtr obiektów ustaw następujące informacje:
- Nazwa
Utwórz nazwę filtra obiektów. - Warunki filtra
Zdefiniuj reguły, które obiekt musi spełnić, aby został uwzględniony w bloku tekstowym. - Zachowanie, gdy wiele rekordów spełnia warunki
Zdefiniuj zachowanie w przypadkach, gdy wiele rekordów spełnia warunki.
Gdy filtr obiektu zostanie utworzony, możesz używać go w logice pokaż/ukryj oraz znacznikach personalizacji, aby wyświetlać określone rekordy obiektu na podstawie ustawionych kryteriów.