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 przyjmuje jakiekolwiek argumenty (tj. dodatkowe parametry lub dane wejściowe), dodaj dwukropek, a następnie argument(y).

Nie dodawaj żadnych dodatkowych spacji. 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 argument wymagany przez filtr.

Jeśli argument jest fragmentem tekstu, musi być ujęty w proste pojedyncze cudzysłowy (tj. ', a nie ‘). Cudzysłowy nie są potrzebne, jeśli argument jest liczbą. Przykłady znajdziesz w słowniczku filtrów zmiennych Klaviyo .

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 ( | ) i pamiętaj, że filtry zazwyczaj będą stosowane w kolejności (od pierwszego do ostatniego). Oto kilka przykładów zmiennych z zastosowanymi wieloma filtrami:

{{ 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 bazową cenę produktu przez 0,8 (aby wyświetlić cenę, jeśli zastosowano kupon zniżkowy 20%), a drugi filtr określa, że mają się pojawić dwa miejsca po przecinku.

Dodatkowe źródła