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:

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.


W tym artykule:


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 webhooka, na przykład:
    https://example.com/hook?user={user.email}
    w parametrach ciała żądania lub 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.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
name Pełne imię z wniosku
email Email z wniosku
phone Telefon z wniosku
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ę

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 CTA formularza

Zmienna Wartość
cta.id ID CTA formularza
cta.uuid UUID CTA formularza
cta.title Nazwa CTA formularza
cta_request.form_data Lista danych wprowadzonych przez użytkownika (oddzielone nowymi liniami)
Lista może być uzupełniana.

Dostępne przy wystąpieniu następujących zdarzeń:

  • Pozostawiono zgłoszenie CTA

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

Zmienna Wartość
referrer Referrer z pierwszej znanej wizyty kontaktu (Kwiga / landing z CTA)
initial_page Url pierwszej znanej wizyty kontaktu (Kwiga / landing z CTA)
reg_from Url strony, z której nastąpiła rejestracja (Kwiga / landing z CTA)
tags Tagi kontaktu (separator ", ")
description Opis zdarzenia, które uruchomiło automatyzację. Na przykład: Kontaktowi dodano tag test_tag

Zmienne produktu

Zmienna Wartość
product.id ID produktu
product.title Nazwa produktu
product.productable_type Typ produktu. Mogą być takie opcje: course, webinar, closed_group, custom_product
product.productable_id ID kursu/webinaru/zamkniętej grupy/produktu niestandardowego

Dostępne przy wystąpieniu następujących zdarzeń:

  • Dostęp do produktu otwarty
  • Dostęp do produktu zamknięty
  • Zarejestrowano na webinar
  • Kurs zakończony
  • Przejście quizu
  • Anulowanie poprzedniego wyniku quizu
  • Quiz przeszedł w status
  • Start dostępu w subskrypcji
  • Koniec dostępu w subskrypcji
  • Rozpoczął oglądanie lekcji
  • Obejrzał lekcję
  • Otwarty dostęp do lekcji
  • Praktyka na lekcji zakończona

Zmienne zamówienia

Zmienna Wartość
order.id ID zamówienia
order.price Cena końcowa. Przykład 10.99
order.currency_code Waluta zamówienia w formacie kodu. Przykład: USD
order.currency_symbol Waluta zamówienia w formacie symbolu. Przykład: $
order.currency_short_title Waluta zamówienia w skróconej nazwie. Przykład: usd
order.order_stage_id ID statusu lejka
order.order_stage_title Nazwa statusu lejka
order.funnel_id ID lejka
order.funnel_title Nazwa lejka
order.paid_status Status płatności zamówienia not_paid / partial_paid / paid
order.paid_status_title Status płatności słowami po angielsku
Lista może być uzupełniana.

Dostępne przy wystąpieniu następujących zdarzeń:

  • Subskrypcja rozpoczęta
  • Subskrypcja przedłużona
  • Pomyślna płatność za zamówienie
  • Nowe zamówienie
  • Pomyślna płatność za ofertę
  • Zwrot płatności za ofertę
  • Dostęp do produktu otwarty
  • Start dostępu w subskrypcji
  • Koniec dostępu w subskrypcji

Zmienne płatności

Zmienna Wartość
payment.id ID płatności
payment.price Cena płatności
payment.currency_code Waluta płatności w formacie kodu. Przykład: USD
payment.currency_symbol Waluta płatności w formacie symbolu. Przykład: $
payment.currency_short_title Waluta płatności w skróconej nazwie. Przykład: usd
payment.created_at Data utworzenia płatności. Format YYYY-MM-DD HH:mm:ss
payment.paid_at Data płatności. Format YYYY-MM-DD HH:mm:ss
payment.schedule_payment_at Planowana data płatności. Format YYYY-MM-DD HH:mm:ss
платіж.номер Numer porządkowy płatności w zamówieniu
Lista może być uzupełniana.

Dostępne przy wystąpieniu następujących zdarzeń:

  • Pomyślna płatność za ofertę
  • Zwrot płatności za ofertę

Zmienne oferty

Zmienna Wartość
offer.id ID oferty
offer.title Nazwa oferty
Lista może być uzupełniana.

Dostępne przy wystąpieniu następujących zdarzeń:

  • Pomyślna płatność za ofertę
  • Zwrot płatności za ofertę
  • Przyjęto darmową ofertę
  • Subskrypcja rozpoczęta
  • Subskrypcja przedłużona
  • Pomyślna płatność za zamówienie
  • Nowe zamówienie
  • Dostęp do produktu otwarty
  • Start dostępu w subskrypcji
  • Koniec dostępu w subskrypcji

Zmienne subskrypcji produktu

Zmienna Wartość
subscription.id ID subskrypcji produktu
subscription.start_at Data rozpoczęcia subskrypcji. YYYY-MM-DD HH:mm:ss
subscription.end_at Ostateczna data zakończenia subskrypcji. YYYY-MM-DD HH:mm:ss
subscription.order_end_at Data zakończenia subskrypcji, uwzględniając tylko opłacone płatności. YYYY-MM-DD HH:mm:ss
subscription.paid_at Data pierwszej płatności za subskrypcję. YYYY-MM-DD HH:mm:ss
Lista może być uzupełniana.

Dostępne przy wystąpieniu następujących zdarzeń:

  • Dostęp do produktu otwarty
  • Start dostępu w subskrypcji
  • Koniec dostępu w subskrypcji

Zmienne próby przejścia quizu

Zmienna Wartość
quiz_attempt.id ID próby
quiz_attempt.number_version Numer wersji przejścia
quiz_attempt.quiz_id ID quizu
quiz_attempt.course_id ID kursu
quiz_attempt.course_lesson_id ID lekcji
quiz_attempt.status_id ID statusu
quiz_attempt.status Status w formie tekstowej
quiz_attempt.scores Zdobyte punkty
quiz_attempt.created_at Początek próby. Format YYYY-MM-DD HH:mm:ss
quiz_attempt.finished_at Koniec próby. Format YYYY-MM-DD HH:mm:ss
quiz_attempt.count_questions Liczba pytań w quizie
quiz_attempt.count_questions_incorrect Liczba pytań, na które udzielono błędnych odpowiedzi
quiz_attempt.count_questions_correct Liczba poprawnie udzielonych odpowiedzi
quiz.title Nazwa quizu
Lista może być uzupełniana.

Dostępne przy wystąpieniu następujących zdarzeń:

  • Przejście quizu
  • Anulowanie poprzedniego wyniku quizu
  • Quiz przeszedł w status

Zmienne lekcji

Zmienna Wartość
lesson.id ID lekcji
lesson.title Nazwa lekcji
Lista może być uzupełniana.

Dostępne przy wystąpieniu następujących zdarzeń:

  • Przejście quizu
  • Anulowanie poprzedniego wyniku quizu
  • Quiz przeszedł w status
  • Rozpoczął oglądanie lekcji
  • Obejrzał lekcję
  • Otwarty dostęp do lekcji
  • Praktyka na lekcji zakończona