Jak używać filtrów do dostosowywania zmiennych

Czego się dowiesz?

Dowiedz się, jak działają filtry i jak używać ich do dostosowywania zmiennych. Filtry umożliwiają dostosowanie formatu i zawartości zmiennych (tj. znaczniki personalizacji) w Twoich wiadomościach. Aby uzyskać listę filtrów dostępnych do użycia w edytorze szablonów, zapoznaj się z glosariuszem filtrów zmiennych w Klaviyo.

Kilka słów na początek

Zanim zaczniesz, zapoznaj się z tym, jak działa personalizacja w Klaviyo. Aby korzystać z filtrów, musisz umieć zidentyfikować właściwe zmienne bazowe i dodać je do szablonu.

Jak działają filtry

Filtry są stosowane do znaczników personalizacji, aby dostosować wyświetlane wyniki. Niektóre możliwe przypadki użycia to:

• Zastosuj spójną kapitalizację w fragmencie tekstu (na przykład możesz użyć filtra upper, aby wziąć dowolną zmienną i zamienić ją w całości na WIELKIE LITERY).
• Pokaż cenę produktu po zastosowaniu promocji, używając filtra multiply.
• Ustaw liczbę miejsc po przecinku wyświetlanych dla zmiennej liczbowej za pomocą filtra floatformat.

Listę obsługiwanych filtrów znajdziesz w naszym glosariuszu filtrów zmiennych.

Zastosuj filtr do zmiennej

Aby zastosować filtr do zmiennej:

1. Zidentyfikuj swój znacznik personalizacji (np. {{ item.price }}).
2. Dodaj symbol pionowej kreski ( | ) po nazwie zmiennej.
3. Dodaj nazwę filtra, np. floatformat, aby określić liczbę miejsc po przecinku do wyświetlenia.
4. Jeśli filtr wymaga argumentu (czyli dodatkowego inputu) lub chcesz ustawić argument opcjonalny, dodaj dwukropek, a po nim argument.

Nie dodawaj spacji wokół dwukropka. Spacje w argumencie tekstu ujętego w cudzysłów są dozwolone. Oto przykład zmiennej z zastosowanym filtrem:

{{ item.price|floatformat:2 }}

W tym przykładzie item.price to nazwa zmiennej, floatformat to filtr, a 2 to opcjonalny argument, który mówi filtrowi, aby zaokrąglił liczbę do 2 miejsc po przecinku i wyświetlił oba miejsca po przecinku.

Jeśli argument jest fragmentem tekstu, ujmij go w pasujące proste pojedyncze lub podwójne cudzysłowy (tzn. ' lub ", a nie ‘ lub “). Cudzysłowy nie są potrzebne, jeśli argument jest liczbą. Zapoznaj się ze słowniczkiem filtrów zmiennych Klaviyo , aby zobaczyć przykłady.

Po dodaniu filtrów sprawdź podgląd wiadomości z profilu lub zdarzenia, które zawiera dane, do których się odwołujesz. W edytorze e-maili kliknij Podgląd i sprawdź, czy wartość i formatowanie są poprawne.

Wskazówki dotyczące używania filtrów

Jeśli kopiujesz filtry i wklejasz je do szablonu, upewnij się, że wklejasz jako zwykły tekst, aby uniknąć wklejenia formatowania wraz z samym filtrem. Użyj skrótu klawiszowego do wklejania jako zwykły tekst (Ctrl+Shift+V lub Cmd+Shift+V).

Ważne jest, aby upewnić się, że dane, do których odwołują się zmienne, są odpowiednie dla używanego filtra. Niektóre filtry można zastosować tylko do typów danych tekstowych, a inne działają tylko na listach lub liczbach. Jeśli filtr nie działa zgodnie z oczekiwaniami, sprawdź zdarzenie lub dane profilu, których używasz, aby upewnić się, że są właściwego typu.

Stosowanie wielu filtrów

W razie potrzeby możesz zastosować wiele filtrów do jednej zmiennej. Aby to zrobić, połącz każdy filtr za pomocą symbolu kreski pionowej ( | ). Filtry są stosowane w kolejności (od pierwszego do ostatniego), a każdy filtr korzysta z wyniku poprzedniego. Oto kilka przykładów zmiennych, do których zastosowano wiele filtrów:

{{ first_name|title|default:'there' }}

Pierwszy filtr stosuje zapis tytułowy do imienia odbiorcy, a drugi filtr dostarcza domyślne słowo, które zostanie użyte, jeśli nie podano imienia.

{{ item.price|multiply:.8|floatformat:2 }}

Pierwszy filtr mnoży podstawową cenę produktu przez 0,8 (aby wyświetlić cenę, jeśli zastosowano kupon z rabatem 20%), a drugi filtr określa, że mają się pojawić dwa miejsca po przecinku.

Dodatkowe źródła