Artykuły:
- Kontrola dostępu
- Jak wyłączyć logowanie przez media społecznościowe
- Jak ustawić logo (podgląd) swojego projektu dla komunikatorów
- Zmiana nazwy projektu (kabinetu) i innych ustawień publicznych
- Dodawanie swojej oferty na platformie Kwiga
- Jak połączyć dodatkowy projekt
- Jak ustawić określony język dla strony na Kwiga
- Powiadomienia otrzymywane przez uczniów
- Zmiana hasła i ustawienia logowania
- Zmiana danych osobowych
- Ustawienia nadawcy i adres odpowiedzi
- Ważne ustawienia
- Jak usunąć konto użytkownika
- Strona Prezentacyjna Projektu (Szkoły)
- Jak podłączyć własną domenę/subdomenę
- Używanie zmiennych w projekcie, lista dostępnych zmiennych
- Podłączenie własnej domeny (subdomeny) do wysyłki wiadomości e-mail
- Jak dodać publiczne informacje o projekcie i kanały kontaktu
- Ustawienia profilu ucznia
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)
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 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
Nie znalazłeś odpowiedzi? Skontaktuj się z usługą wsparcia za pośrednictwem czat online or Telegram