Jak używać niestandardowych obiektów w szablonie
Aby korzystać z tej funkcji, musisz mieć dostęp do niestandardowych obiektów.
Czego się dowiesz
Dowiedz się, jak używać niestandardowych obiektów w szablonie, aby móc korzystać z danych obiektów w sekwencji i kampaniach wysyłania.
Musisz najpierw utworzyć obiekt, zanim będziesz mógł użyć danych obiektu niestandardowego w szablonie.
Dostęp do obiektu dane poprzez menu personalizacji
Możesz spersonalizować blok tekstowy w edytorze szablonów przy użyciu właściwości obiektu niestandardowego lub liczby rekordów dla obiektu.
Dowiedz się, jak korzystać z edytora szablonów Klaviyo.
Aby rozpocząć dodawanie obiektu Dane do swojego szablonu:
- Dodaj nowy blok tekstu lub wybierz istniejący blok tekstu.
- Kliknij dwukrotnie blok tekstu, a następnie umieść kursor w miejscu, w którym chcesz wstawić właściwość dynamiczną.
- Wybierz przycisk Personalizacja w prawym górnym rogu.
- W oknie personalizacji wybierz opcję Obiekty z listy rozwijanej Wszystkie typy .
- W sekcji Obiekty zobaczysz wszystkie obiekty na swoim koncie, których możesz użyć do przeciągnięcia danych do szablonu. Wybierz obiekt zawierający dane, których chcesz użyć w szablonie.
- Wybierz konkretną właściwość obiektu lub filtr obiektu do uwzględnienia w szablonie. Tutaj możesz także utworzyć nowy filtr obiektów.
- Ustaw domyślny tekst i style dla tekstu.
Aby określić reguły wielkich liter dla obiektu dane, musisz ręcznie ustawić regułę w znaczniku szablonu. 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' }}
NN
Dowiedz się więcej o modyfikowaniu wartości za pomocą filtrów Django.
Uzyskaj dostęp do obiektu dane za pomocą znacznika szablonu
Możesz użyć znacznika szablonu w wiadomości e-mail (w tym tematu wiadomości e-mail), SMS/MMS wiadomości, powiadomienie push i Klaviyo Customer Hub, aby wyświetlić dane obiektu.
Dowiedz się, jak używać znacznika szablonu w Klaviyo.
Obiekt znacznik szablonu odniesienia
Możesz użyć następującego znacznika szablonu z obiektami.
Używanie obiektu, który wywołał sekwencję
{{ object }} jest dostępna tylko wtedy, gdy obiekt uruchomił sekwencję. Znacznik szablonu {{ object }} jest dostępny tylko w sekwencji wyzwalanej datą na podstawie obiektu. Jest to podobne do {{ event }} znacznika szablonu dla sekwencji wyzwalanych zdarzeniami.
Te przykłady wykorzystują następujące elementy:
- Obiekt o nazwie Pet , do którego odwołuje się obiekt znacznik w szablonie.
- Właściwość obiektu o nazwie Name
Struktura | Przykład |
{{ object.object_property }} | {{ object.Name }} |
{{ object | lookup:'object_property' }} | {{ object | lookup:'Name' }} |
Pobieranie obiektu według ID
Te przykłady wykorzystują następujące elementy:
- Obiekt o nazwie Pet
- Właściwość obiektu o nazwie Name
- 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 %} {{ alias.object_property }} {% endcustomobject %} | {% customobject event.pet_id object_type_title="Pet" as pet %} {{ pet.Name }} {% endcustomobject %} |
{% customobject event.object_id object_type_title="Title" as alias %} {{ alias | lookup:'object_property' }} {% endcustomobject %} | {% customobject event.pet_id object_type_title="Pet" as pet %} {{ pet | lookup:'Name' }} {% endcustomobject %} |
Zwraca z filtra obiektów pojedynczy obiekt
Te przykłady wykorzystują następujące elementy:
- Dodatkowy filtr obiektów o nazwie oldest_dog
- Właściwość obiektu o nazwie Name
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
Te przykłady wykorzystują 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 }} |
Pobieranie rekordów obiektów
Aby pobrać najnowsze rekordy obiektu, należy przejść przez wszystkie rekordy obiektu. W tym przykładzie użyto następujących elementów:
- Obiekt o nazwie Zwierzęta domowe
Struktura | Przykład |
{% customobjects object_type_title="Title" as alias %} | {% customobjects object_type_title="Pet Profile" as pets %} |
Obiekt dane w temacie wiadomości
Możesz spersonalizować swój temat wiadomości za pomocą dowolnego znacznika:
- {% object_filter %}
- {% object %}
- {% customobject %}
Możesz na przykład użyć znacznika {% object %} w temacie wiadomości, aby bezpośrednio wyświetlić nazwę zwierzaka klienta.
Wersja robocza:
Podgląd wiadomości e-mail:
Obiekt Dane w logice pokaż/ukryj
Możesz także skonfigurować pokazywanie lub ukrywanie bloków w szablonie na podstawie danych obiektu. Dynamiczne pokazywanie lub ukrywanie bloku na podstawie danych obiektu wykorzystuje ten sam znacznik, co kreator szablonów. Możesz odwoływać się do obiektów według ID, właściwości z filtrów obiektów lub agregatów z filtrów obiektów.
Musisz utworzyć filtry obiektów, zanim będziesz mógł odwoływać się do nich w logice pokazywania/ukrywania.
Na przykład, jeśli masz obiekt Pet z właściwością o nazwie Breed, możesz wybrać wyświetlanie bloku tylko właścicielom zwierząt z określoną rasą psów, używając warunku object.Breed.
Aby ustawić logikę pokazywania/ukrywania, kliknij blok, dla którego chcesz ustawić reguły i wybierz opcję Użyj kodu na karcie Wyświetlanie.
Wprowadź warunek bezpośrednio w edytorze kodu. Możesz użyć filtrów obiektów i znacznika szablonu obiektu, jeśli jest to wiadomość dla sekwencji wyzwalanej datą na podstawie danych obiektu.
Aby uzyskać większą elastyczność (np. uzależnienie niektórych 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
Czym jest filtr obiektów?
Filtry obiektów pozwalają ograniczyć zwracane rekordy obiektów w oparciu o określone kryteria, dzięki czemu możesz wyświetlać rekordy określonego typu.
Utwórz nowy filtr obiektów
Aby rozpocząć tworzenie filtra obiektów:
- Dodaj nowy blok tekstowy lub edytuj tekst w istniejącym bloku tekstowym w szablonie.
- Wybierz przycisk Personalizacja .
- W modelu personalizacji wybierz opcję 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 opcję Utwórz nowy filtr.
W oknie dialogowym Utwórz filtr obiektów ustaw następujące informacje:
- Nazwa
Utwórz nazwę dla filtra obiektów. - Filtruj warunki
Zdefiniuj reguły, które obiekt musi spełnić, aby znaleźć się w bloku tekstowym. - Zachowanie, gdy wiele rekordów spełnia warunki
Zdefiniuj zachowanie dla przypadków, w których wiele rekordów spełnia warunki.
Po utworzeniu filtru obiektów możesz użyć go w logice pokazywania/ukrywania i znacznika szablonu, aby wyświetlić określone rekordy obiektów na podstawie ustawionych kryteriów.
Dodatkowe źródła
Odniesienie do personalizacji wiadomości
Jak korzystać z panelu podglądu do personalizacji wiadomości?