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 miesiące 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.

7. W powiadomieniach

Podczas konfigurowania powiadomień w działaniach automatyzacji, zmienne pozwalają dynamicznie wstawiać informacje do powiadomień, na przykład imię użytkownika, numer zamówienia lub nazwę oferty. To upraszcza i przyspiesza proces tworzenia powiadomień, czyniąc je bardziej intuicyjnymi i elastycznymi dla różnych scenariuszy.

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)