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.
Musisz utworzyć obiekt, zanim będzie można używać niestandardowych danych obiektu w szablonach. W menu personalizacji, filtrach obiektów i listach rekordów odbiorców używaj obiektu z relacją do profilu. Jego rekordy muszą być połączone z odbiorcą, aby wyświetlały się w jego wiadomości.
Uzyskiwanie dostępu do danych obiektu za pomocą menu personalizacji
Możesz personalizować bloki tekstu w edytorze szablonów typu „przeciągnij i upuść”, używając właściwości z obiektu niestandardowego lub liczby rekordów dla obiektu.
Dowiedz się jak korzystać z edytora szablonów Klaviyo.
Jeśli zaczynasz od szablonu HTML, możesz najpierw utworzyć kopię metodą przeciągnij i upuść:
- W Klaviyo przejdź do Treści > Szablony, a potem otwórz E-mail: zapisane. Otwórz menu z trzema kropkami w swoim szablonie HTML i wybierz Klonuj do edytora „przeciągnij i upuść”.
- Otwórz Przekonwertowane szablony, aby sprawdzić postępy. Gdy status to Gotowe do użycia, kliknij nazwę przekonwertowanego szablonu, aby go otworzyć.
- Przed użyciem sprawdź układ tekstu i spersonalizowaną treść. Oryginalny szablon HTML pozostaje bez zmian.
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ą.
- Wybierz przycisk Personalizacja na pasku narzędzi tekstu.
- 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 właściwość do wyświetlenia lub Liczbę obiektów, aby wyświetlić liczbę. Następnie wybierz filtr obiektów. Tutaj możesz też utworzyć nowy filtr obiektów.
- Po wybraniu istniejącego filtra kliknij Wstaw. Jeśli utworzysz nowy filtr, jego znacznik zostanie wstawiony, gdy skończysz go tworzyć.
- Zastosuj dowolne style tekstu, których potrzebujesz. Dla wartości właściwości dodaj tekst domyślny, edytując jej znacznik tak, aby zawierał
|default:'value'. Zastąpvaluetekstem, który chcesz wyświetlić, gdy właściwość jest pusta.
Aby określić reguły użycia wielkich liter dla danych obiektu, musisz ręcznie ustawić regułę w znaczniku personalizacji. Na przykład te znaczniki używają obiektu, który uruchomił sekwencję wyzwalaną datą:
- {{ 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 oldestDog
- Właściwość obiektu o nazwie Nazwa
Struktura | Przykład |
{{ object_filter.object_filter_name.object_property}} | {{ object_filter.oldestDog.Name }} |
{{ object_filter.object_filter_name | lookup:'object_property' }} | {{ object_filter.oldestDog | 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 countOfDogs
Struktura | Przykład |
{{ object_filter.object_filter_name }} | {{ object_filter.countOfDogs }} |
Zwraca z filtra obiektów wiele obiektów
W przypadku filtra o nazwie dogs skonfigurowanego jako Wiele przejdź w pętli przez pasujące rekordy, aby wyświetlić właściwość Name każdego zwierzaka:
{% for pet in object_filter.dogs %}
{{ pet.Name }}
{% endfor %}
Pobierz rekordy obiektów
Użyj customobjects, aby pobrać do 5 rekordów powiązanych z odbiorcą, uporządkowanych od ostatnio dodanych do najstarszych. Przejrzyj zwrócone rekordy w pętli, aby wyświetlić ich właściwości. Ten przykład korzysta z następujących elementów:
- Obiekt o nazwie Profil zwierzęcia
- Właściwość obiektu o nazwie name
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
Użyj tej samej składni obiektów niestandardowych w tematach wiadomości co w treści wiadomości. Te przykłady pokazują składnię dla każdego źródła danych:
{{ object_filter.oldestDog.Name }}wyświetla właściwość Name z filtra oldestDog dla pojedynczego obiektu.{{ object.Name }}wyświetla właściwość Name z obiektu, który uruchomił sekwencję wyzwalaną przez datę.{% customobject event.pet_id object_type_title="Pet" as pet %}{{ pet.Name }}{% endcustomobject %}wyszukuje rekord Pet według identyfikatora ID. Użyj tego w sekwencji uruchamianej przez zdarzenie zawierające pet_id.
Na przykład użyj {{ object.Name }} w sekwencji wyzwalanej datą na podstawie obiektu Pet, aby wyświetlić imię zwierzaka klienta w temacie wiadomości.
Widok wersji roboczej:
Podgląd e-maila:
Dane obiektu w logice pokaż/ukryj
Możesz też skonfigurować, czy w szablonie pokazywać, czy ukrywać blok na podstawie danych obiektu. Użyj właściwości lub liczby z filtra obiektu albo obiektu, który wyzwolił sekwencję wyzwalaną datą. Możesz użyć danych obiektu w jednym warunku pokaż/ukryj albo w warunku dla każdego wariantu logiki pokaż/ukryj. W przypadku danych pobieranych według identyfikatora (ID) użyj zaawansowanej logiki warunkowej opisanej poniżej.
Aby móc odwoływać się do filtrów obiektów w logice pokaż/ukryj, musisz je najpierw utworzyć.
Na przykład w sekwencji wyzwalanej datą na podstawie obiektu Zwierzę domowe użyj object.Breed == 'Labrador', aby wyświetlać blok tylko wtedy, gdy rasa wyzwalającego zwierzęcia Breed to Labrador. Użyj dokładnej wartości rasy z Twoich danych.
- Wybierz blok i otwórz kartę Wyświetlanie. W sekcji Logika pokazywania/ukrywania wybierz Pokazuj tylko określonej grupie odbiorców lub wybierz Personalizuj dla wielu grup odbiorców, aby utworzyć warianty logiki. Następnie wybierz Użyj kodu.
- Wpisz warunek, np.
object_filter.countOfDogs > 0, bez{{ }}ani{% %}wokół niego. Filtry obiektów można używać w kampaniach i sekwencjach. Użyjobjecttylko w sekwencji uruchamianej przez datę na podstawie danych obiektu. - Kliknij Zapisz, aby zastosować warunek.
Sekcje obiektów niestandardowych obsługują logikę pokaż/ukryj tylko dla jednej grupy odbiorców. Warianty logiki nie są dla nich dostępne. Dowiedz się więcej o wariantach logiki pokaż/ukryj.
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 wybierają rekordy powiązane z każdym odbiorcą na podstawie ustawionych przez Ciebie kryteriów. Możesz wyświetlić właściwość z 1 pasującego rekordu, właściwości z maksymalnie 10 pasujących rekordów lub liczbę pasujących rekordów.
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 oknie modalnym personalizacji wybierz Obiekty z menu rozwijanego Wszystkie typy .
- Wybierz obiekt zawierający dane, dla których chcesz ustawić filtr.
- Wybierz właściwość, którą chcesz wyświetlić. Aby zamiast tego utworzyć filtr zliczający, wybierz Liczba obiektów.
- Kliknij Utwórz, jeśli nie ma jeszcze żadnych filtrów. Jeśli filtry są na liście, pozostaw je niezaznaczone i kliknij Utwórz filtr obiektów.
W oknie modalnym Utwórz filtr obiektów ustaw następujące informacje:
- Nazwa
Wpisz unikalną nazwę zawierającą tylko litery i liczby, np. oldestDog. Nie używaj spacji ani znaków specjalnych. - Ustaw warunki filtra
Zdefiniuj reguły, które obiekt musi spełnić, aby został uwzględniony w bloku tekstu. - Ile obiektów ma być wyświetlanych?
Dla wartości właściwości wybierz Pojedyncza dla 1 rekordu lub Wiele dla maksymalnie 10 rekordów. Filtry zliczania nie pokazują tego ustawienia. - Wybierz właściwość i kolejność sortowania
W przypadku filtra właściwość–wartość wybierz właściwość używaną do wybierania lub sortowania rekordów, a następnie wybierz jej kolejność sortowania. Na przykład posortuj według właściwości „data urodzenia” z opcją najstarsze, aby najpierw wybrać najstarsze zwierzę. Te pola nie są wyświetlane w przypadku filtrów zliczających.
Kliknij Utwórz filtr obiektu, aby zapisać filtr i wstawić jego znacznik do bloku tekstowego.
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.
Dodatkowe źródła
- Pierwsze kroki z obiektami niestandardowymi
Poznasz obiekty niestandardowe, które umożliwiają przechowywanie i kojarzenie wielu właściwości z pojedynczym „obiektem”. Obiekty niestandardowe umożliwiają mapowanie do Klaviyo różnorodnych, multirelacyjnych pojęć dotyczących danych, których nie można przechowywać za pomocą właściwości profilu. Następnie możesz używać obiektów niestandardowych w swoich wiadomościach, segmentach i nie tylko.
- Informacje dotyczące personalizacji wiadomości
Naucz się, jak korzystać ze zmiennych i znaczników personalizacji Klaviyo, aby zapewnić klientom spersonalizowaną obsługę.
- Używanie panelu podglądu do personalizacji wiadomości
Dowiedz się, jak korzystać z panelu podglądu, aby zrozumieć dane personalizacji dostępne dla wiadomości, oraz jak uzyskać dostęp do znaczników szablonu. Korzystaj z modalu podglądu jako źródła informacji o opcjach personalizacji.