Jak pokazać lub ukryć szablon blok i sekcje na podstawie zmiennych dynamicznych?
Czego się dowiesz
Dowiedz się, jak wyświetlić określony blok lub sekcję w wiadomości e-mail dla określonych odbiorców za pomocą kreatora logiki pokazywania/ukrywania w edytorze szablonów.
Możesz to wykorzystać do wyświetlania różnych treści, na przykład osobom należącym do określonych poziomów lojalnościowych lub tym, które zakupiły określony produkt. Ta funkcja umożliwia kierowanie treści wiadomości e-mail na podstawie informacji o Twoim subskrybencie, dzięki czemu każdy odbiorca ma wysoce spersonalizowane doświadczenie marketingowe.
Zanim zacznieszZanim zaczniesz
Możesz wyświetlać/ukrywać zawartość na podstawie:
- dane profilowe (tj, profil lub właściwości niestandardowe)
-
Zmienne zdarzeń, ale tylko dla:
- Sekwencja wyzwalana zdarzeniem (zwana również sekwencją wyzwalaną metryką)
- Niestandardowy blok pokazywania/ukrywania
Zanim stworzysz wiadomość e-mail, musisz mieć potrzebne dane na swoim koncie. Innymi słowy, musisz mieć 1 wydarzenie lub profil z właściwością, której chcesz użyć.
Korzystanie z danych profilowych
Jeśli chcesz wyświetlać/ukrywać warunki na podstawie danych profilowych (np. lokalizacji, języka itp.), potrzebujesz co najmniej 1 profilu z tymi danymi.
profil i właściwości niestandardowe można dodawać w następujący sposób:
- Formularze rejestracyjne
- Przesyłanie CSV
- integracje e-commerce
- wzrost listy i integracje lojalnościowe, takie jak Typeform lub Yotpo
Dowiedz się więcej o właściwościach profilu w Klaviyo.
Korzystanie z właściwości zdarzeń
Podobnie w przypadku właściwości wydarzenia, na Twoim koncie Klaviyo musi znajdować się 1 wydarzenie. Następnie możesz pokazać/ukryć blok w oparciu o zdarzenie wyzwalające tej sekwencji przy użyciu niestandardowego bloku. Nie możesz odwoływać się do danych zdarzeń za pomocą kreatora logiki.
Tak więc, w porzuconym koszyku zakupowym sekwencja z wyzwalaczem Uruchomiona strona płatności kasa, możesz budować warunki pokazywania/ukrywania w oparciu o wartość koszyka lub konkretne elementy dodane przez klienta.
Stwórz swoją wiadomość
Konstruktor logiczny pokaż/ukryj dane profilowe sformatowane jako tekst, liczby i lista. Nie obsługuje danych zdarzeń, dat ani wartości logicznych. Jeśli chcesz użyć nieobsługiwanych danych w warunku pokazywania/ukrywania, użyj niestandardowego kodu do napisania warunku.
- Dodaj blok lub sekcję do szablonu e-mailowego.
- Wybierz kartę Wyświetlanie.
- W sekcji Pokaż/ukryj logikę wybierz opcję Użyj konstruktora logiki.
- Wybierz warunek.
- Możesz utworzyć prosty warunek z pojedynczym kryterium lub bardziej złożony warunek z kilkoma kryteriami połączonymi przez AND lub OR. Dowiedz się więcej o złączach AND i OR.
- Użyj przycisku Dodaj warunek, aby w razie potrzeby dodać dodatkowe warunki.
- Wybierz Zapisz.
Jeśli używasz logiki pokazywania/ukrywania w sekcji i bloku w tej sekcji, ustawienia mogą wchodzić w interakcje i powodować konflikty. Dowiedz się więcej w naszym artykule na temat opcji wyświetlania.
AND vs. OR w warunkach pokazywania/ukrywania
Podczas oceny logiki pokaż/ukryj, warunki połączone przez AND są oceniane przed warunkami połączonymi przez OR. Rozważ kolejność, w jakiej twoja logika będzie oceniana podczas pisania, aby upewnić się, że zostanie zinterpretowana zgodnie z twoimi intencjami.
Jako przykład rozważ następujący warunek:
Zgodnie z tymi kryteriami sprawdź, czy blok jest widoczny dla niektórych przykładowych odbiorców:
odbiorcy | Czy blok się pojawia? | Dlaczego? |
Jane loyalty_points = 145 Ulubiony kolor = zielony Ulubiony owoc = banan | Nie | Jane mogła określić, czy jej ulubionym kolorem jest niebieski lub czy jej ulubionym owocem jest banan. |
Alex Ulubiony kolor = niebieski Ulubiony owoc = jabłko | Nie | Alex mógłby się zakwalifikować, gdyby miał więcej punktów lojalnościowych lub gdyby jego ulubionym owocem było kiwi. |
Amanda Ulubiony kolor = niebieski Ulubiony owoc = granat | Tak | Amanda kwalifikuje się, ponieważ ma > 99 punktów lojalnościowych, a jej ulubionym kolorem jest niebieski. Jej ulubiony owoc nie jest brany pod uwagę, ponieważ spełnia oba kryteria po przeciwnej stronie operatora OR. |
Stephanie Ulubiony kolor = pomarańczowy Ulubiony owoc = kiwi | Tak | Stephanie kwalifikuje się, ponieważ jej ulubionym owocem jest kiwi. Pozostałe warunki nie są brane pod uwagę, ponieważ spełnia ona kryteria po jednej stronie operatora OR. |
Przypadki użycia dla bloków pokaż/ukryj
Przypadki użycia dla bloków pokaż/ukryj
program lojalnościowy banerprogram lojalnościowy baner
Jeśli masz program lojalnościowy, pokaż aktywnym uczestnikom, ile punktów aktualnie posiadają. Zaoferuj kontaktom, które jeszcze nie zarejestrowały się w programie, zachętę do dołączenia. Aby to skonfigurować, będziesz potrzebować 2 banerów.
Pokaż aktywnym uczestnikom programu lojalnościowego baner z tym warunkiem ukrycia:
Liczba punktów lojalnościowych > jest większa niż 0.
Pokaż potencjalnym klientom baner z tym warunkiem:
loyalty_points > nie jest ustawiony
Konieczne może być dostosowanie kryteriów w oparciu o dane dostępne na Twoim koncie.
Spersonalizowane obrazySpersonalizowane obrazy
Jeśli zbierasz informacje o tym, jak subskrybent korzysta z Twojego produktu, pokaż mu obrazy, które się do nich odnoszą.
Na przykład marka sprzedająca plecaki może zapytać, czy subskrybent używa ich do dojazdów do pracy, podróży lub wędrówek. W zależności od ich odpowiedzi, marka ta mogłaby pokazać zdjęcia swoich produktów w tych środowiskach.
Aby to skonfigurować, będziesz potrzebować 3 bloków obrazów przedstawiających Twój produkt w 3 różnych ustawieniach.
Pokaż osobom dojeżdżającym do pracy zdjęcie motocyklisty noszącego plecak podczas dojazdu do pracy w takim stanie:
Preferowana torba = dojazdy do pracy
Pokaż podróżnym zdjęcie jednego ze swoich plecaków w takim stanie na zatłoczonym lotnisku:
Preferowana torba = podróżna
Pokaż wszystkim innym zdjęcie jednego ze swoich plecaków w malowniczym krajobrazie na świeżym powietrzu:
Preferencja torby > nie jest równa > Podróż ORAZ Preferencja torby > nie jest równa > Dojazdy do pracy
Zwróć uwagę, że ostatni obraz nie jest skierowany tylko do turystów pieszych; zobaczy go każdy, kto nie jest osobą dojeżdżającą do pracy lub podróżującą. Ważne jest, aby konto dla odbiorców, którzy mogą nie mieć ustawionej tej właściwości, aby Twój e-mail wyglądał świetnie dla wszystkich.
Uwagi dotyczące produktuUwagi dotyczące produktu
Odwoływanie się do elementu z poziomu zdarzenia wyzwalającego sekwencję wymaga użycia niestandardowego kodu.
Przekazuj osobom porzucającym koszyki informacje dotyczące konkretnych produktów, aby przekazać im kluczowe informacje, które mogą wpłynąć na ich decyzję o zakupie. Na przykład, jeśli kończy Ci się produkt, dodaj blok tekstowy z ostrzeżeniem o niskim stanie magazynowym, który pojawi się tylko dla osób z tym produktem w koszyku z tym warunkiem:
ITEM_NAME in event.Items
Wiadomości dostosowane do lokalizacji
Warunki specyficzne dla lokalizacji mogą oceniać tylko tekst; nie mogą oceniać odległości od kodu pocztowego. Pokaż niestandardowy baner mieszkańcom, którzy mieszkają w określonym obszarze, na przykład w tym samym mieście, co Twój sklep stacjonarny z tym warunkiem:
Miasto = Boston
Rozwiązywanie problemów z pokazywaniem/ukrywaniem bloków
Jeśli blok pokaż/ukryj nie jest renderowany zgodnie z oczekiwaniami, użyj przycisku Konwertuj na kod, aby przekonwertować logikę konstruktora na kod. Stamtąd możesz sprawdzić i dostosować kod, aby renderował się zgodnie z oczekiwaniami.
Konwersja logiki na kod nie jest odwracalna.
Podczas rozwiązywania problemów upewnij się, że typ dane użyty w wartości warunku jest taki sam jak typ dane w profilu, do którego się odwołujesz. Na przykład liczba 22 jest inna niż wartość tekstowa "22". Jeśli twój warunek jest ustawiony na Number, ale twoje wartości są przechowywane jako tekst na profilu, warunek nie będzie w stanie poprawnie ocenić.
Konwersja tekstu na liczby
Jeśli masz właściwości liczbowe, ale są one przechowywane jako tekst w profilu, możesz przekonwertować je na liczby w polu kodu niestandardowego za pomocą filtra |multiply. Aby z niej skorzystać, dodaj filtr bezpośrednio po nazwie zmiennej:
person.Birthday|multiply:"1" > 21
Booleans sklep jako tekst
Jeśli dana prawda/fałsz jest przechowywana jako tekst, a nie jako wartość logiczna, lub jeśli odwołujesz się do właściwości zawierającej zarówno wartości logiczne, jak i tekst, możesz użyć tych struktur, aby uwzględnić wszystkie scenariusze. Uwzględnij wszystkie pisownie i wielkie litery, które są obecne w twoim tekście.
Przykładowe warunki | Pokaż blok, jeśli... |
person|lookup:'VIP' == 1 lub person|lookup:'VIP' == 'true' lub person|lookup:'VIP' == 'True' | Właściwość VIP jest ustawiona na wartość logiczną true lub ciąg znaków true lub True |
person|lookup:'VIP' == 0 lub person|lookup:'VIP' == 'false' lub person|lookup:'VIP' == 'False' | Właściwość VIP jest ustawiona na wartość logiczną false lub ciąg znaków false lub False |
Znaki niealfanumeryczne we właściwościach
Jeśli właściwości lub wartości, do których odwołuje się twój blok show/hide zawierają znaki niealfanumeryczne (np. symbole takie jak =, <, lub >), twój warunek nie będzie obsługiwany i zobaczysz komunikat o błędzie. Aby uzyskać najlepsze wyniki, używaj tylko liter (wielkich lub małych, z uwzględnieniem wielkości liter), cyfr, podkreśleń (_) lub myślników (-).
Niestandardowe kodowanie pokaż/ukryj blokNiestandardowe kodowanie pokaż/ukryj blok
Jeśli wolisz większą kontrolę lub chcesz utworzyć warunek przy użyciu danych zdarzeń, dat lub wartości logicznych, zakoduj swój blok pokazywania/ukrywania zamiast korzystać z kreatora logiki. Aby rozpocząć od zera przy użyciu kodu, wybierz przycisk Użyj kodu w ustawieniach logiki Pokaż/Ukryj.
Możesz także przekonwertować istniejący warunek pokaż/ukryj, aby użyć kodu za pomocą przycisku Konwertuj na kod.
Konwersja logiki na kod nie jest odwracalna.
Jeśli zdecydujesz się użyć kodu, upewnij się, że dobrze rozumiesz Django, logikę programowania i typy danych Klaviyo. KlaviyoZespół ds. pomocy nie jest w stanie zapewnić bezpośredniej pomocy ani rozwiązywania problemów z niestandardowym kodem.
Dowiedz się więcej o wspieranych strukturach kondycyjnych.
Pokaż/ukryj warunki na podstawie danych zdarzeniaPokaż/ukryj warunki na podstawie danych zdarzenia
Jeśli Twój e-mail jest wysyłany jako część sekwencji wyzwalanej zdarzeniem (np. porzucony koszyk zakupowy lub sekwencja potwierdzenia zamówienia), możesz pokazać/ukryć blok na podstawie szczegółów zdarzenia wyzwalającego tę sekwencję. Tak więc, w porzuconym koszyku zakupowym sekwencja z wyzwalaczem Uruchomiona strona płatności kasa, możesz niestandardowo zakodować warunki pokazywania/ukrywania w oparciu o wartość koszyka lub konkretne elementy dodane przez klienta. Dowiedz się więcej o zmiennych zdarzeń.
Zrozum, jak dany jest sklepZrozum, jak dany jest sklep
Przed skonfigurowaniem stanu pokaż/ukryj sprawdź, jak wygląda Twój sklep. Istnieje 5 typów psów w Klaviyo:
- Tekst
- Numer
- Data
- Wartość logiczna
- Lista
To, jaki sklep ma Twój pies, będzie miało wpływ na to, które warunki pokazywania/ukrywania będą dla Ciebie odpowiednie. Dowiedz się, jak rozpoznać typy psów na własnym koncie.
Stwórz swoją wiadomośćStwórz swoją wiadomość
Pierwszym krokiem do dodania niestandardowych warunków pokazywania/ukrywania w wiadomości jest zbudowanie szablonu e-mailowego. W tej sekcji omówimy konkretny przykład, ale możesz wykonać te same kroki, aby ustawić dowolny blok do wyświetlania na podstawie własnych kryteriów.
Na przykład, jeśli Twoja firma sprzedaje skórzane torby, możesz zbierać preferencje klientów dotyczące sposobu korzystania z toreb za pomocą formularza rejestracyjnego, jak pokazano poniżej.
Następnie możesz wyświetlić inny obraz w zależności od preferencji klienta. Na przykład, jeśli preferencją klienta jest "Praca", torba pojawi się na obrazie obok laptopa. Jeśli preferencje klienta to "Na zewnątrz", torba pojawi się w pobliżu malowniczego widoku na szlaku turystycznym.
- Utwórz wiadomość kampania lub sekwencja.
- Dodaj blok obrazu.
- Prześlij obraz związany z pracą do bloku.
- Kliknij opcję Wyświetl w menu dostosowywania bloku obrazu.
- W sekcji Pokaż/ukryj logikę wybierz opcję Użyj kodu.
- Dodaj ten warunek: person|lookup:'Bag Preference' == 'Work'.
- Kliknij przycisk Zapisz zmiany.
- Kliknij przycisk Gotowe na bloku.
Ten blok będzie widoczny tylko dla osób, które wybrały opcję "Praca" jako swoje preferencje.
Następnie dodaj obraz związany z podróżą do nowego bloku pod obrazem związanym z pracą. Wykonaj te same kroki, co poprzednio, ale tym razem użyj warunku person|lookup:'Bag Preference' == 'Outdoors'.
Ten blok będzie wyświetlany tylko osobom, które wybrały opcję "Na zewnątrz" jako swoje preferencje.
Na koniec dodaj obraz, który pojawi się dla każdego, kto nie wybrał opcji "Praca" lub "Na zewnątrz". Użyj bardziej ogólnego obrazu i tego warunku: person|lookup:'Bag Preference ' != 'Work' i person|lookup : 'Bag Preference' != 'Outdoors'.
Tutaj != oznacza, że "nie jest równe", więc ten warunek szuka osób, które wybrały coś innego niż "Praca" lub "Na zewnątrz" lub nigdy nie wybrały preferencji.
Po skonfigurowaniu każdego z bloków wyświetl podgląd wiadomości przy użyciu 3 profili. Te profile powinny być subskrybentami, którzy spełniają jedno z kryteriów wizerunkowych:
- Klient, który wybrał "Outdoor"
- Klient, który wybrał "Praca"
- I klient bez preferencji / z innymi preferencjami
Możesz użyć tych kroków, aby pokazać lub ukryć blok na podstawie dowolnego profilu lub danych zdarzenia na koncie.
Utwórz warunek pokaż/ukryj za pomocą dane profiloweUtwórz warunek pokaż/ukryj za pomocą dane profilowe
Jeśli tworzysz niestandardowy warunek pokazywania/ukrywania na podstawie profilu właściwości, zastąp przykładową zmienną z tabel w odwołaniu do logiki warunkowej (np. person|lookup:'Favorite Color') swoim profilem właściwości.
Aby znaleźć właściwą zmienną do użycia:
- Kliknij Personalizacja, aby otworzyć menu personalizacji.
- Wybierz opcję z menu, aby dodać ją do bloku tekstowego.
- Skopiuj nazwę zmiennej ze znacznika. Aby zidentyfikować nazwę zmiennej, usuń nawiasy klamrowe wokół zmiennej, a także |default:'' na końcu (jeśli występuje), wraz z innymi filtrami.
Na przykład na poniższym zrzucie ekranu pełny znacznik to {{ person|lookup:"Accepts Marketing"|default:"" }}. Nazwa zmiennej to person|lookup:"Accepts Marketing", więc wybierz tę część, aby użyć jej w warunku pokazywania/ukrywania.
Utwórz warunek pokazywania/ukrywania za pomocą event dane
Możesz użyć danych zdarzenia, aby pokazać lub ukryć blok, jeśli twoja wiadomość jest częścią sekwencji wyzwalanej zdarzeniem. Tylko dane w zdarzeniu wyzwalającym mogą być użyte w warunku pokazania/ukrycia.
Aby zidentyfikować zmienne zdarzeń:
- W edytorze szablonów kliknij przycisk Podgląd & test.
- W sekcji Podgląd źródła danych kliknij opcję Zdarzenie.
- Z rozwijanego menu wybierz zdarzenie, które wywoła tworzoną wiadomość.
- Przewiń właściwości zdarzenia, aby znaleźć dane, które chcesz dołączyć.
- Kliknij nazwę właściwości, aby skopiować znacznik.
- Wklej znacznik do bloku tekstowego lub edytora tekstu.
- Usuń nawiasy klamrowe (tj. {{ i }}) ze znacznika, a także wszelkie filtry.
- Użyj zmiennej, która pozostaje w warunku pokazywania/ukrywania.
Na poniższym zrzucie ekranu zobaczysz znacznik {{ event|lookup:'Item Count' }}. Będziesz potrzebował tylko tekstu event|lookup:'Item Count' dla swojego warunku show/hide. Pamiętaj, że twoje dane mogą mieć inną strukturę, np. {{ event.extra.line_items.0.title }} lub {{ event.ShippingAddress.address1 }}. Użyj zmiennej w takiej postaci, w jakiej pojawia się w danych zdarzenia.
Dostosuj warunki pokazywania/ukrywania
Dowiedz się, jak tworzyć niestandardowe warunki pokazywania/ukrywania przy użyciu logiki warunkowej. Ten zasób zawiera przykładowe warunki, które możesz dostosować za pomocą własnego profilu i danych zdarzenia.