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:

3 tygodnie 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 wstawianie spersonalizowanych danych do różnych elementów twojego projektu. Mogą być używane w takich miejscach:

1. Webhooki w automatyzacjach

Zmienne można wstawiać:

w URL webhook, na przykład:
https://example.com/hook?user={user.email}
w parametrach ciała żądania
w nagłówkach

To pozwala na automatyczne przekazywanie danych osobowych do zewnętrznych serwisów.

2. CTA (Call to Action)

W przyciskach i linkach zmienne można używać do:

personalizacji tekstu przycisku
przekazywania danych przez linki, na przykład ID użytkownika lub tagi UTM

3. W parametrach

Zmienne można używać w parametrach formularzy lub innych elementów:

email użytkownika
ID subskrypcji
unikalne kody i tagi
dowolna inna zmienna dostępna w kontekście

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

Można dodać zmienne ręcznie w linku przekierowania:

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

5. W infoblokach lekcji

Zmienne działają wewnątrz tekstów infobloków. Na przykład:

Zwracanie się po imieniu: Cześć, {user.first_name}!
Wyświetlanie nazwy kursu, daty, statusu itp.

6. W wiadomościach

Użycie zmiennych w wiadomościach pozwala na bardziej spersonalizowaną i efektywną komunikację. Dzięki zmiennym, takim jak {имя}, {дата} lub {название курса} wiadomość wygląda na personalnie skierowaną do klienta. To zwiększa zaufanie, zaangażowanie i prawdopodobieństwo, że użytkownik przeczyta wiadomość do końca lub wykona potrzebną akcję. Ponadto, zmienne ułatwiają automatyzację masowych wysyłek bez utraty indywidualnego podejścia.

Lista dostępnych zmiennych

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

Zmienna	Wartość
contact.id	ID kontaktu
contact.user_id	ID użytkownika
contact.first_name	Imię kontaktu
contact.last_name	Nazwisko kontaktu
contact.middle_name	Drugie imię kontaktu
contact.name	Pełne imię kontaktu
contact.email	Email kontaktu
contact.phone	Telefon kontaktu
contact.country	Kraj kontaktu. Na przykład: Ukraina
contact.timezone	Strefa czasowa kontaktu. Na przykład: Europe/Kyiv
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_medium kontaktu (separator ", ")
contact.utm_campaign	Lista unikalnych utm_campaign 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)
datetime	Data i czas w UTC w formacie YYYY-MM-DD HH:mm:ss
contact.visit_source	Źródło wizyty

Pola niestandardowe

{contact.field_<id>}

Przykład {contact.field_123}

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

Custom fields example

Zmienne, które można dodatkowo używać w CTA

w parametrach
w linku przekierowania (jeśli nie jest używane przejście do płatności)

Zmienna	Wartość
first_name	Imię z wniosku
last_name	Nazwisko z wniosku
middle_name	Drugie imię z wniosku
name	Pełne imię z wniosku
email	Email z wniosku
phone	Telefon z wniosku
field_<id>	Pola niestandardowe Telefon z wniosku (opis poniżej)
utm_source	utm_source - konkretnej wizyty, z której został złożony wniosek
utm_medium	utm_medium - konkretnej wizyty, z której został złożony wniosek
utm_campaign	utm_campaign - konkretnej wizyty, z której został złożony wniosek
utm_term	utm_term - konkretnej wizyty, z której został złożony wniosek
utm_content	utm_content - konkretnej wizyty, z której został złożony wniosek
widget_landing	Url landing page, z której wysłano wniosek
widget_landign_referer	Referer, który był na landing page, kiedy wysłano wniosek
Również w określonych formularzach mogą być dostępne zmienne opisane poniżej w Zmiennych dostępnych w webhookach automatyzacji Na zamówienie ({order.}) - Jeśli wybrano opcję formularza Dostęp do produktu (Pełny dostęp/Na ofertę) Na produkt({product.}) - Jeśli wybrano opcję formularza Dostęp do produktu + Pełny dostęp Na ofertę ({offer.*}) - Jeśli wybrano opcję formularza Dostęp do produktu + Na ofertę

Pola niestandardowe

{field_<id>}

Przykład {contact.field_123}

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

Custom fields example

Jeśli na stronie, gdzie umieszczono CTA lub skrypt Kwiga do śledzenia odwiedzin, były odwiedziny z metkami utm, a klient złożył zamówienie na landing page'u już bez metek utm, to w tych zmiennych będą one nieobecne. Ale będą dostępne w zmiennych {contact.utm_...}, które opisano powyżej.

Zmienne dostępne w webhookach automatyzacji (url, parametry, e-maile)