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 personalizacjiDostę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 tekstowy lub edytuj tekst w istniejącym bloku tekstowym w szablonie.
- 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 szablonuUzyskaj 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 odniesieniaObiekt 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 %}
{% for object_instance in alias %} {{ object_instance.record }} {% endfor %} {% endcustomobjects %} |
{% 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ówFiltry obiektów
Czym jest filtr 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ówUtwó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 musi spełniać obiekt, aby mógł zostać uwzględniony w bloku tekstowym. -
Zachowanie, gdy wielerekordów spełnia warunki
Zdefiniuj zachowanie w przypadkach, gdy 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łaDodatkowe źródła
Odniesienie do personalizacji wiadomości
Jak korzystać z panelu podglądu do personalizacji wiadomości?