Centrum pomocy Kwiga Usługi, integracje, API, Ustawienia Ustawienia ogólne Używanie zmiennych w projekcie, lista dostępnych zmiennych

Używanie zmiennych w projekcie, lista dostępnych zmiennych

Artykuły:

1 miesiąc temu • Zaktualizowane

W tym artykule wyjaśniamy, jak używać zmiennych w swoim projekcie — gdzie je stosować, jakie dane są dostępne i jak wykorzystywać je do automatyzacji i personalizacji. Zawiera listę z opisami i przykładami dla e-maili, webhooków, przycisków, lekcji i innych elementów.

Ogólne informacje o zmiennych

Zmienne to wygodny sposób na zastąpienie spersonalizowanych danych w różnych elementach projektu. Można ich używać w następujących miejscach:

1. Webhooki w automatyzacjach

Zmienne mogą być zastępowane:

W adresie URL elementu webhook, na przykład:
https://example.com/hook?user={{user.email}}
w parametrach treści żądania lub nagłówkach

Umożliwia to automatyczne przekazywanie danych osobowych do usług stron trzecich.

2. CTA (wezwanie do działania)

W przyciskach i linkach zmienne mogą być używane do:

Personalizacja tekstu przycisku
przesyłanie danych za pośrednictwem łącza, np. identyfikatora użytkownika lub znaczników UTM

3. W parametrach

Zmienne mogą być używane w parametrach formularzy lub innych elementów:

e-mail użytkownika
identyfikator subskrypcji
unikalne kody i znaczniki
każda inna zmienna dostępna w kontekście

4. W linku przekierowującym (jeśli nie jest używane przejście płatności)

Możesz dodać zmienne ręcznie do linku przekierowującego:

https://my.site.com/thanks?email={{user.email}}&course={{course.title}}

5. W blokach informacyjnych lekcji

Zmienne działają w tekstach infobloków. Na przykład:

Zwracanie się po imieniu: Cześć, {{user.first_name}}!
Wyświetla nazwę kursu, datę, status itp.

6. W listach

Używanie zmiennych w listach sprawia, że komunikacja jest bardziej spersonalizowana i skuteczna. Używanie zmiennych takich jak {{imię}}, {{data}} lub {{tytuł kursu}} sprawia, że wiadomość e-mail wygląda na spersonalizowaną dla klienta. Zwiększa to zaufanie, zaangażowanie i prawdopodobieństwo, że użytkownik dokończy wiadomość e-mail lub podejmie pożądane działanie. Zmienne ułatwiają również automatyzację masowych wysyłek bez utraty spersonalizowanego charakteru.

Lista dostępnych zmiennych

Lista dostępnych zmiennych, które są dostępne we wszystkich miejscach, w których można używać zmiennych.

Zmienna	Znaczenie
{contact.id}	Kontakt Id
{contact.user_id}	Identyfikator użytkownika
{contact.first_name}	Nazwa kontaktu
{contact.last_name}	Nazwa kontaktu
{contact.name}	Imię i nazwisko osoby kontaktowej
{kontakt.email}	Kontakt Email
{contact.phone}	Numer telefonu kontaktowego
{contact.country}	Kraj kontaktu. Na przykład: Ukraina
{contact.timezone}	Nazwa kontaktu. Na przykład: Europa/Kijów
{contact.currency}	Waluta kontaktu. Na przykład: USD
{contact.city}	Miasto kontaktu
{contact.utm_source}	Lista unikalnych utm_source kontaktu (separator ", ")
{contact.utm_medium}	Lista unikalnych utm_mediów kontaktu (separator ", ")
{contact.utm_campaign}	Lista unikalnych utm_campaigns kontaktu (separator ", ")
{contact.utm_term}	Lista unikalnych utm_term kontaktu (separator ", ")
{contact.utm_content}	Lista unikalnych utm_content kontaktu (separator ", ")
{contact.field_<id>}	Pola niestandardowe (opis poniżej)
{data}	Data i godzina w UTC w formacie RRRR-MM-DD GG:mm:ss

Pola niestandardowe

{contact.field_<id>}

Przykład {contact.field_123}

<id> - identyfikator pola, który można uzyskać w ustawieniach pola kontaktu (przykład https://sampleschool.kwiga.com/expert/crm/contacts?view=settings ).

Zmienne, które można dodatkowo wykorzystać w wezwaniach do działania

w parametrach
w linku przekierowującym (jeśli nie jest używane przejście płatności)

Zmienna	Znaczenie
{first_name}	Nazwa z aplikacji
{last_name}	Nazwa z aplikacji
{nazwa}	Imię i nazwisko z aplikacji
{email}	Wiadomość e-mail z aplikacji
{telefon}	Numer telefonu z aplikacji
{utm_source}	utm_source - w szczególności wizyta, z której wysłano żądanie
{utm_medium}	utm_medium - konkretnie wizyta, z której wysłano żądanie
{utm_campaign}	utm_campaign - konkretnie wizyta, z której wysłano żądanie
{utm_term}	utm_term - konkretnie wizyta, z której wysłano żądanie
{utm_content}	utm_content - konkretnie wizyta, z której wysłano żądanie
{widget_landing}	Adres URL strony docelowej, z której wysłano aplikację
{widget_landign_referer}	Odsyłacz, który znajdował się na stronie docelowej podczas składania wniosku
Również w niektórych formach mogą być dostępne zmienne, które opisano poniżej w sekcji Zmienne dostępne w webhookach automatyzacji Według zamówienia ({order.}) - jeśli wybrano opcję formularza dostępu do produktu (Pełny dostęp/Oferta). Według produktu({product.}) - jeśli wybrano opcję formularza Dostęp do produktu + Pełny dostęp Według oferty ({offer.*}) - jeśli wybrano opcję formularza Dostęp do produktu + Według oferty

Ważne! Jeśli na stronie, na której umieszczono CTA lub skrypt Kwiga do śledzenia wizyt, były wizyty z tagami utm, a klient pozostawił żądanie na stronie docelowej bez tagów utm, nie będą one dostępne w tych zmiennych. Będą one jednak dostępne w zmiennych {contact.utm_...} opisanych powyżej.