Informacje dotyczące personalizacji wiadomości

Około 15 min czytania

Zaktualizowano 21 sie 2025, 08:27 EST

Nauczysz się, jak korzystać ze zmiennych i znaczników personalizacji Klaviyo w komunikatach marketingowych i w Customer Hubie, aby zapewnić subskrybentom i subskrybentkom spersonalizowaną obsługę.

Znaczniki personalizacji mogą być używane w e-mailach (w tym w temacie wiadomości), wiadomościach SMS/MMS, powiadomieniach push oraz w Customer Hubie. W tym artykule opisano niektóre dostępne znaczniki, ich struktury i formy oraz sposób ich dostosowywania. Aby dowiedzieć się, jak dodać personalizację, przejdź do artykułu na temat personalizacji wiadomości.

Znaczniki personalizacji były wcześniej nazywane znacznikami szablonów oraz składnią zmiennych.

Informacje o znacznikach personalizacji

Po wprowadzeniu znaczników do pola tekstowego wyglądają one jak zdanie po lewej stronie w poniższej tabeli. Po wyświetleniu wiadomości znaczniki zostaną zastąpione informacjami z profilu odbiorcy lub szczegółami zdarzenia. Będą wtedy wyglądać jak zdanie po prawej stronie.

Nazywasz się {{ first_name }} {{ last_name }} i Twoim ulubionym kolorem jest {{ person|lookup:'Favorite Color' }}

Nazywasz się George Washington i Twoim ulubionym kolorem jest zielony

Personalizacja profilu zazwyczaj zaczyna się od słowa person. Wyjątek stanowi kilka specjalnych znaczników takich jak first_name i last_name. Zmienne zdarzeń, które mogą być używane w sekwencjach uruchamianych przez metryki, zaczynają się od słowa event. Znaczniki organizacji (podobnie jak nazwa i adres firmy) zaczynają się od słowa organization.

We wszystkich znacznikach personalizacji rozróżnia się wielkość liter – muszą one więc dokładnie odpowiadać nazwom właściwości, do których się odnoszą. Upewnij się, że Twoje znaczniki są zapisane poprawnie, i używaj tej samej wielkości liter co w swoich profilach.

Personalizacja profilu

Personalizacja profilu umożliwia wyświetlanie w wiadomościach specjalnych właściwości Klaviyo. Poniższa lista obejmuje wszystkie personalizacje profilu (tj. wbudowane właściwości Klaviyo). Znaczniki personalizacji profilu są dostępne w menu Personalizacja edytora e-maili lub w oknie podglądu SMS-ów i powiadomień push.

Jeśli chcesz dodać do swoich wiadomości właściwości niestandardowe, przejdź do sekcji dotyczącej personalizacji niestandardowej.

Znacznik	Właściwość profilu
`{{ email }}`	Adres e-mail
`{{ first_name }}`	Imię
`{{ last_name }}`	Nazwisko
`{{ person.organization }}`	Organizacja odbiorcy
`{{ person\|lookup:"$address1" }}`	Pole adresu 1
`{{ person.id }}`	Unikalny identyfikator ($id/zewnętrzny identyfikator)
`{{ person\|lookup:"$latitude" }}`	Szerokość geograficzna
`{{ person\|lookup:"$longitude" }}`	Długość geograficzna
`{{ person.KlaviyoID }}`	Identyfikator Klaviyo
`{{ person.full_name }}`	Imię i nazwisko
`{{ person.title }}`	Nazwa
`{{ person.phone_number }}`	Numer telefonu
`{{ person\|lookup:'$address2' }}`	Pole adresu 2
`{{ person.City }}`	Miejscowość
`{{ person.Region }}`	Województwo/region
`{{ person.Country }}`	Kraj
`{{ person.Zipcode }}`	Kod pocztowy
`{{ person\|lookup:"$source" }}`	Źródło
`{{ person\|lookup:"$consent" }}`	Zgoda
`{{ person\|lookup:'$consent_form_id' }}`	$consent_form_id
`{{ person\|lookup:'$consent_form_version' }}`	$consent_form_version
`{{ person\|lookup:'$consent_method' }}`	$consent_method
`{{ person\|lookup:"$timezone" }}`	Strefa czasowa odbiorcy
`{{ person\|lookup:'$consent_timestamp' }}`	$consent_timestamp
`{{ person\|lookup:'$phone_number_region' }}`	$phone_number_region
`{{ person.ViewedItems }}`	Ostatnio przeglądane pozycje
`{{ person\|lookup:"Expected Date Of Next Order" }}`	Spodziewany termin następnego zamówienia

Niestandardowe znaczniki obiektów

Niestandardowe znaczniki obiektów umożliwiają korzystanie z danych obiektów w wysyłanych sekwencjach i kampaniach.

Konkretne przykłady na to, jak używać znaczników w celu uzyskania identyfikatora obiektu lub zwrócenia liczby znajdziesz w informacjach dotyczących znaczników.

Przed użyciem niestandardowych danych obiektu w szablonach należy najpierw utworzyć obiekt. Znacznik {{ object }} będzie dostępny tylko, jeżeli obiekt uruchomił sekwencję.

Znacznik	Rezultat
`{{ object.object_property }}`	Zwraca obiekt, który uruchomił sekwencję
`{{ object \| lookup:'object_property' }}`	Zwraca obiekt, który uruchomił sekwencję
`{{ object_filter.object_filter_name.object_property}}`	Zwraca z filtra obiektów pojedynczy obiekt
`{{ object_filter.object_filter_name \| lookup: 'object_property' }}`	Zwraca z filtra obiektów pojedynczy obiekt
`{{ object_filter.object_filter_name }}`	Zwraca z filtra obiektów liczbę
`{% customobject id={{ event.object_id }} as alias %}`	Pobiera obiekt według identyfikatora
`{% customobjects object_type_title=“Title” as alias %} {% for object_instance in alias %} {{ object_instance.record }} {% endfor %} {% endcustomobjects %}`	Pobiera wszystkie rekordy dla obiektu z jednego profilu

Znaczniki organizacji

Znaczniki organizacji umożliwiają umieszczanie w wiadomościach informacji o firmie lub organizacji. Aby zarządzać tymi informacjami, kliknij nazwę organizacji w lewym dolnym rogu, a następnie wybierz kolejno opcje Ustawienia > Organizacja > Dane kontaktowe. Wszystkie znaczniki organizacji zaczynają się od słowa organization. Lista znaczników organizacji znajduje się w poniższej tabeli.

Znacznik organizacji	Opis
`{{ organization.name }}`	Nazwa organizacji
`{{ organization.url }}`	Strona internetowa organizacji
`{{ organization.full_address }}`	Pełny adres organizacji, w tym miejscowość, województwo/region i kod pocztowy
`{{ organization.street_address }}`	Adres organizacji (ulica)
`{{ organization.street_address2 }}`	Druga część adresu organizacji (np. numer mieszkania lub numer budynku)
`{{ organization.city }}`	Miejscowość organizacji
`{{ organization.region }}`	Województwo, prowincja lub region organizacji
`{{ organization.zip_code }}`	Kod pocztowy organizacji

Znaczniki linków i podglądu

Znaczniki linków i podglądu umożliwiają odbiorcom zarządzanie preferencjami subskrypcji oraz wyświetlanie wiadomości w przeglądarce. Oto i one:

Wycofaj subskrypcję
Zarządzaj preferencjami
Widok w przeglądarce
Podgląd tekstu

Znaczniki te działają tylko dla szablonów e-mailowych. Jeżeli w e-mailu poglądowym klikniesz jeden z tych linków, nastąpi przekierowanie do strony zastępczej, a nie do aktywnej strony zgody lub podglądu.

Wycofaj subskrypcję

Klaviyo wymaga umieszczenia linku do rezygnacji z subskrypcji we wszystkich e-mailach. Użyj prostego znacznika rezygnacji z subskrypcji dla linku z napisem „Wycofaj subskrypcje” lub dodaj własny tekst w cudzysłowie.

Znacznik	Rezultat
`{% unsubscribe %}`	Wycofaj subskrypcję
Jeśli nie chcesz już otrzymywać naszych e-maili, `{% unsubscribe 'click here' %}`.	Jeśli nie chcesz już otrzymywać naszych e-maili, kliknij tutaj.

Aby wygenerować adres URL do rezygnacji z subskrypcji można też użyć znacznika {% unsubscribe_link %}. Zamiast generować pełne słowo lub frazę z zagnieżdżonym linkiem, ten znacznik tworzy tylko adres URL do rezygnacji z subskrypcji. Skorzystaj z tego znacznika, jeśli dla swojego linku do rezygnacji z subskrypcji chcesz użyć innego koloru niż tego, który ustawiono w stylach szablonu, lub zamiast tekstu z linkiem wolisz wykorzystać przycisk/obraz z łączem.

Znacznik	Rezultat
`To dekoracyjne łącze do <a href="{% unsubscribe_link %}">wycofania subskrypcji</a>.`	To dekoracyjne łącze do wycofania subskrypcji.

Kiedy odbiorca kliknie link do wycofania subskrypcji, zostanie przeniesiony na konfigurowalną stronę potwierdzenia.

Zarządzaj preferencjami

Strony preferencji umożliwiają odbiorcom aktualizowanie swoich preferencji, co pozwala na skuteczniejsze segmentowanie i targetowanie wiadomości. Aby dołączyć link do tej strony dla każdego odbiorcy, użyj znacznika zarządzania preferencjami.

Możesz tworzyć ogólne strony zarządzania preferencjami oraz przeznaczone dla konkretnych list. Te ostatnie wysyłane są podczas wysyłki tylko do jednej listy. Ogólna strona zarządzania preferencjami jest używana podczas wysyłki do segmentu, kombinacji list oraz w sekwencjach, które nie są uruchamiane przez listy. Dowiedz się więcej o stronach zarządzania preferencjami.

Użyj prostego znacznika zarządzania preferencjami dla linku z napisem „Zarządzaj preferencjami” lub dodaj własny tekst w cudzysłowie.

Znacznik	Rezultat
`{% manage_preferences %}`	Zarządzaj preferencjami
Chcesz zaktualizować swoje preferencje? `{% manage_preferences 'Click here' %}`.	Chcesz zaktualizować swoje preferencje? Kliknij tutaj.

Aby wygenerować adres URL do zarządzania preferencjami można też użyć znacznika {% manage_preferences_link %}. Zamiast generować pełne słowo lub frazę z zagnieżdżonym linkiem, ten znacznik tworzy tylko adres URL do strony preferencji odbiorcy. Skorzystaj z tego znacznika, jeśli dla swojego linku do strony zarządzania preferencjami chcesz użyć innego koloru niż tego, który ustawiono w stylach szablonu, lub zamiast tekstu z linkiem wolisz wykorzystać przycisk/obraz z łączem.

Znacznik	Rezultat
`To dekoracyjne łącze do <a href="{% manage_preferences_link %}">zarządzania preferencjami</a>.`	To dekoracyjne łącze do zarządzania preferencjami.

Widok w przeglądarce

Aby umożliwić odbiorcom wyświetlanie e-maili bezpośrednio jako strony internetowej, można użyć znacznika widoku w przeglądarce.

Znacznik	Rezultat
`{% web_view %}`	Wyświetl w przeglądarce
Nie widzisz tego e-maila? `{% web_view 'Open in your browser' %}`.	Nie widzisz tego e-maila? Otwórz go w przeglądarce.
`To dekoracyjne łącze do <a href="{% web_view_link %}">widoku w przeglądarce</a>.`	To ozdobny link do widoku w przeglądarce.

Podgląd tekstu

W niektórych przypadkach tekst podglądu może wyświetlać się w głównej części szablonu. Do dowolnego tekstu podglądu ustawionego na ekranie podglądu/konfiguracji e-maila można odnieść się za pomocą znacznika {% render_variable preview_text %}.

Jeżeli zaktualizujesz tekst podglądu na ekranie podglądu e-maila, ten znacznik wyświetli Twój zaktualizowany tekst podglądu.

Niestandardowe znaczniki personalizacji i zdarzeń

Znaczniki niestandardowe odnoszą się do niestandardowych właściwości profilu (czyli wszelkich danych zebranych na temat Twoich kontaktów, które są inne niż specjalne właściwości i zdarzenia Klaviyo) takich jak data urodzin danej osoby lub jej preferencje kontaktowe. Znaczniki zdarzeń odnoszą się do danych konkretnego zdarzenia (np. złożonego zamówienia) i mogą być używane tylko w sekwencjach uruchamianych przez to zdarzenie.

Aby dodać znacznik niestandardowy, w polu tekstowym e-maila kliknij opcję Personalizacja i znajdź znacznik. Znacznik zdarzenia dodasz, wyświetlając podgląd wiadomości i kopiując znacznik zmiennej zdarzenia z danych podglądu. Możesz również użyć formatów opisanych poniżej, aby znaczniki niestandardowe dodać do swoich szablonów ręcznie.

Format znacznika	Opis	Przykład
`{{ person.property_name }}`	Prosty znacznik personalizacji profilu	`{{ person.Birthday }}`
`{{ person\|lookup:'property name' }}`	Znacznik personalizacji profilu, jeśli nazwa właściwości zawiera spacje lub znaki specjalne	`{{ person\|lookup:'Favorite Color' }}`
`{{ event.property_name }}`	Prosty znacznik zmiennej zdarzenia	`{{ event.URL }}`
`{{ event\|lookup:'property name' }}`	Znacznik zmiennej zdarzenia, jeśli nazwa zmiennej zawiera spacje lub znaki specjalne	`{{ event\|lookup:'$value' }}`
`{{ event.property.nested_variable }}`	Znacznik zmiennej zdarzenia, jeśli zmienna zdarzenia jest zagnieżdżona w danych zdarzenia	`{{ event.extra.checkout_url }}`
`{{ event\|lookup:'property name'\|lookup:'nested variable name' }}`	Znacznik zmiennej zdarzenia, jeśli zmienna zdarzenia jest zagnieżdżona w innej zmiennej, której nazwa zawiera spację lub znak specjalny	`{{ event\|lookup:'Coupon Codes'\|lookup:'0' }}`

W przypadku znaczników bez spacji i znaków specjalnych należy stosować notację kropkową (.). Jeżeli nazwy właściwości zawierają spacje lub znaki specjalne (np. $), należy użyć notacji wyszukiwania (z lookup).

Pamiętaj, że jeśli w przypadku właściwości zagnieżdżonych nazwa jednej właściwości wykorzystuje notację z lookup, wszystkie kolejne właściwości również muszą wykorzystywać notację z lookup. To znaczy, że znacznik event|lookup:'Collection Names'|lookup:'0' jest poprawny, ale event|lookup:'Collection Names'.0 już nie.

Personalizacja znacznika za pomocą filtrów

Aby dostosować sposób wyświetlania znaczników do swoich potrzeb, zastosuj filtry szablonów. Filtrowania można używać do określania wielkości liter, ustawiania liczby miejsc po przecinku i nie tylko/ Dwa najpopularniejsze filtry to default (domyślny) oraz title (od dużej litery).

Filtr default ustawia wartość domyślną, która pojawi się, jeśli odbiorca wiadomości nie ma ustawionej tej właściwości. W poniższym przykładzie „przyjacielu” i „smakołyki” są ustawione jako wartości domyślne w przypadku, gdy imię lub ulubione danie odbiorcy nie jest ustawione w jego profilu Klaviyo.

Tekst ze znacznikami personalizacji	Rezultat
Cześć, `{{ first_name\|default:'friend' }}`! Jakie są Twoje ulubione `{{ person\|lookup:'Favorite Food'\|default:'tasty treats' }}`?	Hej, przyjacielu! Jakie są Twoje ulubione smakołyki?

Filtr title umożliwia zaczynanie każdego wyrazu znacznika tekstowego od dużej litery, aby zapewnić spójny wysłanych wiadomości. Na przykład podczas wypełnienia formularza rejestracyjnego niektórzy subskrybenci czy subskrybentki mogli użyć samych dużych lub samych małych liter. Bez tego filtra ich imiona i nazwiska byłyby zapisane dokładnie tak jak w wypełnionym formularzu. Filtr „title” poprawia jednak wielkość liter, dzięki czemu imiona i nazwiska wyświetlane są poprawnie.

Tekst ze znacznikami personalizacji	Rezultat
Hej, `{{ first_name\|title }}`! Znasz już nasz najnowszy produkt?	Hej, Eliza! Znasz już nasz najnowszy produkt?

Istnieją dziesiątki innych filtrów dostępnych dla wiadomości. Dowiedz się więcej o używaniu filtrów w celu personalizacji znaczników.

Znaczniki daty

Znaczniki daty umożliwiają szybkie wstawianie do e-maili informacji o dacie. Podana jest ona w strefie czasowej Twojego konta i odzwierciedla dzień lub godzinę wysłania wiadomości.

Znacznik {{ today }} jest jednym z najczęściej używanych znaczników daty i w momencie wysłania wiadomości wypełnia sygnaturę czasu. Aby użyć znacznika „today” (dzisiaj), wklej do swojego szablonu następujący fragment kodu:

{% today "%Y-%m-%d" as today %} {{ today }}

Pamiętaj, że użycie znacznika {{ today }} bez poprzedzającego go kodu nic nie wygeneruje – konieczna jest pełna linia kodu.

Aby dowiedzieć się, jak używać znacznik daty lub go dostosowywać, przejdź do artykułu na temat znaczników daty w szablonach.

Znaczniki walut

Z danymi zdarzeń takimi jak Złożono zamówienie czy Dodano do koszyka często powiązana jest wartość finansowa (np. cena produktu lub wartość koszyka klienta). Aby zastosować do tej wartości formatowanie waluty swojego kraju, użyj znacznika {% currency_format … %}.

Rozważmy na przykład pole $value w poniższej metryce Rozpoczęto proces płatności:

Jeżeli użyjesz tylko zmiennej {{ event|lookup:"$value" }}, ta właściwość będzie wyświetlana w e-mailu jedynie z jednym miejscem po przecinku i bez symbolu waluty:

W przypadku zastosowania znacznika formatu waluty {% currency_format event|lookup:"$value" %}, liczba wyświetli się z symbolem waluty oraz z prawidłową liczbą miejsc po przecinku:

Aby użyć znacznika formatu waluty, w miejsce elementu zastępczego („PLACEHOLDER”) w {% currency_format PLACEHOLDER %} wstaw swoją zmienną.

Na przykład jeśli zmienną jest {{ event.item.price }}, pełnym znacznikiem formatu waluty będzie {% currency_format event.item.price %}. Jeśli znacznik zawiera filtry (np. wartość domyślną w przypadku, gdy właściwość jest pusta), należy je również uwzględnić w znaczniku: {% currency_format event.item.price|default:”0” %}.

Wybór kraju

Format waluty dla wiadomości można ustawić w dwóch miejscach:

Dla całego konta
Przejdź do: Ustawienia > Organizacja > Język firmowy i format regionalny, a następnie wybierz Język firmowy.
Dla określonej wiadomości
Inny format waluty dla pojedynczej wiadomości wybierzesz w karcie Style szablonu w sekcji Waluta.

Rozwiązywanie problemów ze znacznikiem currency_format

Ten znacznik jest obsługiwany tylko w przypadku zmiennych będących liczbami (np. 10; 24,56). Właściwości zawierające symbol waluty (np. 40 $; 76,30 $) są ciągami znaków, a znacznik currency_format nie może ich zmienić.

Instrukcje warunkowe

Znaczniki warunkowe umożliwiają umieszczenie treści w wiadomościach dla odbiorców spełniających określone kryteria, a pominięcie jej w przypadku pozostałych osób. Dają one potężne możliwości personalizacji wiadomości pod kątem każdego odbiorcy.

Instrukcje warunkowe „if”

Instrukcje „if” pozwalają kontrolować treść otrzymywaną przez odbiorcę na podstawie profilu lub danych zdarzenia.

W poniższym przykładzie: jeśli dana osoba posiada więcej niż 150 punktów lojalnościowych, zostanie jej wyświetlony pierwszy wiersz tekstu. Jeśli ma mniej niż 150 punktów, ale więcej niż 0, zobaczy drugi wiersz. A jeśli nie ma punktów lojalnościowych w ogóle, zobaczy trzeci komunikat.

{% if person|lookup:'Loyalty Points' > 150 %}
Dziękujemy za to, że jesteś naszym VIP-em! Zawsze możesz liczyć na bezpłatne wysyłkę i zwroty!
{% elif person|lookup:'Loyalty Points' > 0 %}
Masz {{ person|lookup:'Loyalty Points' }} pkt., a potrzebujesz tylko 150, aby zostać naszym VIP-em! 
{% else %}
Znasz nasz program VIP? Dołącz do niego już dziś na naszej stronie i zdobywaj nagrody.
{% endif %}

W instrukcji „if” wymagany jest warunek początkowy {% if … %}, a także znacznik zamykający {% endif %}. Wszystkie pozostałe elementy (czyli {% elif %} i {% else %}) są opcjonalne. Można użyć nieograniczonej liczby znaczników {% elif %}, po których następuje maksymalnie jeden znacznik {% else %}. Każdy odbiorca i odbiorczyni e-maila zobaczą tylko jedną wiadomość – pierwszą, do której się kwalifikują.

Instrukcje warunkowe „for”

Bloki „for” pozwalają na iteracyjne sprawdzanie warunku wobec każdego elementu zmiennej, która przechowuje listę, i wyświetlanie ich indywidualnie. Poniżej znajduje się przykładowe zastosowanie tego warunku:

{% for item in event.shopping_cart_items %}{{ item.name }} × {{ item.quantity }} {% endfor %}

Duży koc plażowy × 1

Krzesła plażowe × 4

Krem przeciwsłoneczny z filtrem SPF × 2

Plastikowa lodówka turystyczna × 1

Każda instrukcja warunkowa for musi zawierać następujące elementy:

Znacznik otwierający {% for … %}, który zawiera alias wiersza (w powyższym przykładzie item) oraz kolekcję wierszy (w powyższym przykładzie event.shopping_cart_items)
Znacznik zamykający {% endfor %}

Pomiędzy dwoma wymaganymi znacznikami można umieścić dowolny tekst. Aby uwzględnić zmienne zagnieżdżone w kolekcji wierszy, należy zastąpić początek nazwy zmiennej (kolekcja wierszy plus liczba następująca po kolekcji wierszy) aliasem wiersza. Na przykład zmienna {{ event.shopping_cart_items.0.name }} stałaby się {{ item.name }}.

Instrukcje warunkowe a wbudowany edytor tekstu

Po dodaniu do bloku tekstowego określonych instrukcji warunkowych mogą one zniknąć z wbudowanego edytora tekstu. Kod nadal będzie obecny – po prostu pozostanie ukryty. Aby przeglądać i edytować instrukcje warunkowe, otwórz pole Kod źródłowy bloku tekstowego.

Następujące znaczniki są widoczne tylko w polu Kod źródłowy bloku tekstowego:

{% for ... %}
{% endfor %}
{% if ... %}
{% elif ... %}
{% else %}
{% endif %}
{% with ... %}
{% endwith %}

Dodatkowe źródła

Czy ten artykuł był pomocny?

Ten formularz służy tylko do przesyłania opinii na temat artykułów. Dowiedz się, jak skontaktować się z zespołem ds. pomocy.

Dowiedz się od Klaviyo więcej

Społeczność

Nawiązuj kontakty z osobami na podobnych stanowiskach, partnerami oraz ekspertami i ekspertkami Klaviyo – inspirujcie się nawzajem, wymieniajcie spostrzeżeniami i pomagajcie szukać odpowiedzi na nurtujące Was pytania.

Odwiedź stronę społeczności

Szkolenie na żywo

Chcesz poznać najlepsze praktyki, nauczyć się konfigurować najważniejsze funkcje i nie tylko? Dołącz do sesji na żywo z udziałem ekspertów i ekspertek Klaviyo.

Zarejestruj się teraz

Pomoc

Uzyskaj wsparcie za pośrednictwem konta.

E-mail do zespołu ds. pomocy (konta w bezpłatnym okresie próbnym oraz konta płatne) Całodobowa dostępność

Czat/wirtualna pomoc
Dostępność różni się w–zależności od lokalizacji i typu planu.

Zaloguj się