Odniesienie do personalizacji wiadomości

Około 15 min czytania

Zaktualizowano 8 sie 2025, 09:38 EST

Dowiesz się, jak korzystać ze zmiennych i znaczników personalizacji Klaviyo w komunikatach marketingowych i Customer Hubie, aby zapewnić subskrybentom 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 i składnią zmiennych.

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 i będą 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 person, z wyjątkiem kilku 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 event. Znaczniki organizacji (podobnie jak nazwa i adres firmy) zaczynają się od organization.

Wszystkie znaczniki personalizacji rozróżniają wielkość liter i muszą dokładnie odpowiadać nazwom właściwości, do których się odnoszą. Upewnij się, że Twoje znaczniki są poprawnie napisane, i używaj tej samej wielkości liter co w swoich profilach.

Personalizacja profilu

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

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

Znacznik	Właściwość profilu
`{{ email }}`	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 }}`	Państwo/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 }}`	Witryna internetowa organizacji
`{{ organization.full_address }}`	Pełny adres organizacji, w tym miasto, stan/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 }}`	Miasto organizacji
`{{ organization.region }}`	Stan, 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 i wyświetlanie wiadomości w przeglądarce. Oto te znaczniki:

Wypisz się
Zarządzaj preferencjami
Widok strony internetowej
Podgląd tekstu

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

Wypisz się

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

Znacznik	Rezultat
`{% unsubscribe %}`	Wypisz się
Jeśli nie chcesz już otrzymywać wiadomości e-mail, `{% unsubscribe 'click here' %}`.	Jeśli nie chcesz już otrzymywać wiadomości e-mail, kliknij tutaj.

Ewentualnie można użyć znacznika {% unsubscribe_link %}, aby wygenerować adres URL do rezygnacji z subskrypcji. 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 chcesz użyć innego koloru dla swojego linku do rezygnacji z subskrypcji niż kolor linku ustawiony w stylach szablonu lub użyć przycisku/obrazu z linkiem zamiast tekstu z linkiem.

Znacznik	Rezultat
`To jest ozdobny link do <a href="{% unsubscribe_link %}">rezygnacji z subskrypcji</a>.`	To jest ozdobny link do rezygnacji z subskrypcji.

Gdy odbiorca kliknie link do rezygnacji z 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ć strony preferencji specyficzne dla list oraz ogólne strony zarządzania preferencjami. Strony specyficzne dla list są wysyłane po wysłaniu wiadomości tylko do jednej listy. Ogólna strona zarządzania preferencjami jest używana podczas wysyłki do segmentu, kombinacji list i 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.

Ewentualnie można użyć znacznika {% manage_preferences_link %}, aby wygenerować adres URL do zarządzania preferencjami. 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 chcesz użyć innego koloru dla swojego linku niż kolor linku ustawiony w stylach szablonu lub użyć przycisku/obrazu z linkiem zamiast tekstu z linkiem.

Znacznik	Rezultat
`To jest ozdobny link do <a href="{% manage_preferences_link %}">zarządzania preferencjami</a>.`	To jest ozdobny link do zarządzania preferencjami.

Widok strony internetowej

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

Znacznik	Rezultat
`{% web_view %}`	Wyświetl w swojej przeglądarce
Nie widzisz tego e-maila? `{% web_view 'Open in your browser' %}`.	Nie widzisz tego e-maila? Otwórz go w swojej przeglądarce.
`To jest ozdobny link 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 być wyświetlany w głównej części szablonu. Możesz odwołać się do dowolnego tekstu podglądu ustawionego na ekranie podglądu/konfiguracji e-maila za pomocą znacznika {% render_variable preview_text %}.

Jeśli 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 preferencje dotyczące kontaktu. 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ć niestandardowy znacznik, kliknij opcję Personalizacja w polu tekstowym e-maila i znajdź znacznik. Aby dodać znacznik zdarzenia, wyświetl podgląd wiadomości i skopiuj znacznik zmiennej zdarzenia z danych podglądu. Możesz również użyć formatów opisanych poniżej, aby ręcznie dodać niestandardowe znaczniki do swoich szablonów.

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śli nazwy właściwości zawierają spacje lub znaki specjalne (np. $), należy użyć notacji wyszukiwania (z lookup).

Należy pamiętać, ż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. Oznacza to, że znacznik event|lookup:'Collection Names'|lookup:'0' jest poprawny, ale event|lookup:'Collection Names'.0 już nie.

Dostosowywanie znacznika za pomocą filtrów

Aby dostosować sposób wyświetlania znaczników, zastosuj filtry szablonów. Filtrowanie może być używane do określania wielkości liter, ustawiania liczby miejsc po przecinku i wielu innych rzeczy. 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 wygląd po wysłaniu wiadomości. Na przykład niektórzy subskrybenci mogą używać samych wielkich lub samych małych liter podczas wypełniania formularza rejestracyjnego. Bez tego filtra ich imiona i nazwiska byłyby zapisane dokładnie tak jak w wypełnionym formularzu. Jednak filtr „title” poprawia 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 informacji o dacie do e-maili. Data jest podana 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 wypełnia sygnaturę czasową w momencie wysłania wiadomości. Aby użyć znacznika „today” (dzisiaj), wklej następujący fragment kodu do swojego szablonu:

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

Należy pamiętać, że użycie znacznika {{ today }} bez poprzedzającego go kodu nie spowoduje wygenerowania niczego – konieczna jest pełna linia kodu.

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

Znaczniki walutowe

Dane zdarzeń, takie jak Złożono zamówienie, Dodano do koszyka i inne, mają często wartość finansową z nimi związaną (np. cena produktu lub wartość koszyka klienta). Użyj znacznika {% currency_format … %}, aby zastosować do tej wartości formatowanie waluty swojego kraju.

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

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

Jednak w przypadku zastosowania znacznika formatu walutowego {% currency_format event|lookup:"$value" %}, liczba jest wyświetlana z symbolem waluty i prawidłową liczbą miejsc po przecinku:

Aby użyć znacznika formatu walutowego, 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 walutowego 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

Istnieją 2 miejsca, w których można ustawić format waluty dla wiadomości:

Dla całego konta
Przejdź do: Ustawienia > Organizacja > Język firmowy i format regionalny i wybierz Język firmowy.
Dla określonej wiadomości
Wybierz inny format waluty dla pojedynczej wiadomości na 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 i 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 odbiorców. Dają one potężne możliwości personalizacji wiadomości pod kątem każdego odbiorcy.

Instrukcje warunkowe „if”

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

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 drugą linię. 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 darmową wysyłkę i darmowe 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 internetowej, aby zdobywać 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 e-maila zobaczy tylko jedną wiadomość – przy pierwszym spełnieniu warunku.

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 for musi zawierać następujące elementy:

Otwierający znacznik {% for … %}, który zawiera alias wiersza (item w powyższym przykładzie) i kolekcję wierszy (event.shopping_cart_items w powyższym przykładzie).
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 i wbudowany edytor tekstu

Po dodaniu określonych instrukcji warunkowych do bloku tekstowego mogą one zniknąć z wbudowanego edytora tekstu. Kod jest nadal obecny – po prostu pozostaje 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ę