Articole:
- Access control
- How to disable login through social media
- How to set your project logo (preview) for messengers
- Changing the project (cabinet) name and other public settings
- Adăugarea ofertei dvs. pe platforma Kwiga
- How to connect an additional project
- How to set a specific language for a page on Kwiga
- Notificări primite de studenți
- Changing the password and login settings
- Changing personal information
- Sender settings and reply address
- Important settings
- Cum să ștergeți un cont de utilizator
- Project (School) Presentation Page
- Cum să legi un domeniu sau subdomeniu propriu
- Utilizarea variabilelor în proiect, listă de variabile disponibile
- Conectarea unui domeniu (subdomeniu) personalizat pentru trimiterea e-mailurilor
- Cum să adaugi informații publice despre proiect și canale de contact
- Setările profilului studentului
Acest articol explică modul de utilizare a variabilelor în proiectul tău — unde pot fi aplicate, ce date sunt disponibile și cum pot fi folosite pentru automatizare și personalizare. Include o listă cu descrieri și exemple pentru e-mailuri, webhook-uri, butoane, lecții și altele.
În acest articol:
Informații generale despre variabile
Variabilele sunt o modalitate convenabilă de a insera date personalizate în diferite elemente ale proiectului dvs. Ele pot fi utilizate în următoarele locuri:
1. Webhook-uri în automatizări
Variabilele pot fi inserate:
-
în URL-ul webhook-ului, de exemplu:
https://example.com/hook?user={user.email}
în parametrii corpului cererii sau în anteturi
Acest lucru permite transmiterea automată a datelor personale către servicii terțe.
2. CTA (Call to Action)
În butoane și linkuri, variabilele pot fi utilizate pentru:
-
personalizarea textului butonului
-
transmiterea datelor prin linkuri, de exemplu ID-ul utilizatorului sau etichete UTM
3. În parametri
Variabilele pot fi utilizate în parametrii formularelor sau altor elemente:
-
email-ul utilizatorului
-
ID-ul abonamentului
-
coduri și etichete unice
-
orice altă variabilă disponibilă în context
4. În linkul de redirecționare (dacă nu se folosește trecerea la plată)
Puteți adăuga variabile manual în linkul de redirecționare:
https://my.site.com/thanks?email={user.email}&course={course.title}
5. În infoblocurile lecțiilor
Variabilele funcționează în interiorul textelor infoblocurilor. De exemplu:
-
Adresare pe nume: Salut, {user.first_name}!
-
Afișarea numelui cursului, datei, statutului etc.
6. În scrisori
Utilizarea variabilelor în scrisori permite o comunicare mai personalizată și eficientă. Cu ajutorul variabilelor, cum ar fi {nume}, {data} sau {numele cursului}, scrisoarea pare personal adresată clientului. Acest lucru crește încrederea, implicarea și probabilitatea ca utilizatorul să citească scrisoarea până la capăt sau să efectueze acțiunea dorită. În plus, variabilele simplifică automatizarea trimiterilor în masă fără a pierde abordarea individuală.
Lista variabilelor disponibile
Lista variabilelor disponibile, care sunt disponibile în toate locurile unde se pot folosi variabile.
Variabilă | Valoare |
---|---|
contact.id | ID-ul contactului |
contact.user_id | ID-ul utilizatorului |
contact.first_name | Numele contactului |
contact.last_name | Prenumele contactului |
contact.name | Numele complet al contactului |
contact.email | Email-ul contactului |
contact.phone | Telefonul contactului |
contact.country | Țara contactului. De exemplu: Ucraina |
contact.timezone | Fusul orar al contactului. De exemplu: Europe/Kyiv |
contact.currency | Valuta contactului. De exemplu: USD |
contact.city | Orașul contactului |
contact.utm_source | Lista unică de utm_source a contactului (separator ", ") |
contact.utm_medium | Lista unică de utm_medium a contactului (separator ", ") |
contact.utm_campaign | Lista unică de utm_campaign a contactului (separator ", ") |
contact.utm_term | Lista unică de utm_term a contactului (separator ", ") |
contact.utm_content | Lista unică de utm_content a contactului (separator ", ") |
contact.field_<id> | Câmpuri personalizate (descriere mai jos) |
datetime | Data și ora în UTC în formatul YYYY-MM-DD HH:mm:ss |
contact.visit_source | Sursa vizitei |
Câmpuri personalizate
{contact.field_<id>}
Exemplu {contact.field_123}
<id> - id-ul câmpului, care poate fi obținut în setările câmpurilor de contact
(exemplu
https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)
Variabile care pot fi utilizate suplimentar în CTA
-
în parametri
-
în linkul de redirecționare (dacă nu se folosește trecerea la plată)
Variabilă | Valoare |
---|---|
first_name | Prenumele din cerere |
last_name | Numele de familie din cerere |
name | Numele complet din cerere |
Email din cerere | |
phone | Telefon din cerere |
utm_source | utm_source - specific vizitei de la care a fost lăsată cererea |
utm_medium | utm_medium - specific vizitei de la care a fost lăsată cererea |
utm_campaign | utm_campaign - specific vizitei de la care a fost lăsată cererea |
utm_term | utm_term - specific vizitei de la care a fost lăsată cererea |
utm_content | utm_content - specific vizitei de la care a fost lăsată cererea |
widget_landing | Url-ul landing page-ului de unde a fost trimisă cererea |
widget_landign_referer | Referer-ul care a fost pe landing page când a fost trimisă cererea |
De asemenea, în anumite formulare pot fi disponibile variabilele descrise mai jos în Variabile disponibile în webhook-urile de automatizare Pe comandă ({order.*}) - Dacă este selectată opțiunea de formular Acces la produs (Acces complet/Pe ofertă) Pe produs({product.*}) - Dacă este selectată opțiunea de formular Acces la produs + Acces complet Pe ofertă ({offer.*}) - Dacă este selectată opțiunea de formular Acces la produs + Pe ofertă |
Dacă pe pagina unde este plasat CTA sau scriptul Kwiga pentru urmărirea vizitelor au fost vizite cu etichete utm, iar clientul a lăsat o cerere pe landing page deja fără etichete utm, atunci în aceste variabile ele vor lipsi. Dar vor fi disponibile în variabilele {contact.utm_...}, care sunt descrise mai sus.
Variabile CTA formular
Variabilă | Valoare |
---|---|
cta.id | ID CTA formular |
cta.uuid | UUID CTA formular |
cta.title | Nume CTA formular |
cta_request.form_data | Listă de date introduse de utilizator (separate prin linii noi) |
Lista poate fi completată. |
Disponibile la declanșarea următoarelor evenimente:
- Cerere lăsată CTA
Variabile disponibile în webhook-urile automatizării (url, parametri)
Variabilă | Valoare |
---|---|
referrer | Referer de la prima vizită cunoscută a contactului (Kwiga / landing cu CTA) |
initial_page | Url-ul primei vizite cunoscute a contactului (Kwiga / landing cu CTA) |
reg_from | Url-ul paginii de unde s-a făcut înregistrarea (Kwiga / landing cu CTA) |
tags | Etichete de contact (separator ", ") |
description | Descrierea evenimentului care a declanșat automatizarea. De exemplu: Contactului i s-a adăugat eticheta test_tag |
Variabilele produsului
Variabilă | Valoare |
---|---|
product.id | ID produs |
product.title | Numele produsului |
product.productable_type | Tipul produsului. Pot fi următoarele opțiuni: course, webinar, closed_group, custom_product |
product.productable_id | ID curs/webinar/grup închis/produs personalizat |
Disponibile la declanșarea următoarelor evenimente:
- Acces la produs deschis
- Acces la produs închis
- Înregistrat la webinar
- Curs finalizat
- Trecerea chestionarului
- Anularea rezultatului anterior al chestionarului
- Chestionarul a trecut în status
- Start acces prin abonament
- Sfârșit acces prin abonament
- A început să vizioneze lecția
- A vizionat lecția
- Acces la lecție deschis
- Practica la lecție finalizată
Variabilele comenzii
Variabilă | Valoare |
---|---|
order.id | ID comandă |
order.price | Preț final. Exemplu 10.99 |
order.currency_code | Valuta comenzii în format cod. Exemplu: USD |
order.currency_symbol | Valuta comenzii în format simbol. Exemplu: $ |
order.currency_short_title | Valuta comenzii în denumire prescurtată. Exemplu: usd |
order.order_stage_id | ID status pâlnie |
order.order_stage_title | Numele statusului pâlniei |
order.funnel_id | ID pâlnie |
order.funnel_title | Numele pâlniei |
order.paid_status | Statusul plății comenzii not_paid / partial_paid / paid |
order.paid_status_title | Statusul plății în cuvinte în engleză |
Lista poate fi completată. |
Disponibile la declanșarea următoarelor evenimente:
- Abonament început
- Abonament prelungit
- Plata comenzii reușită
- Comandă nouă
- Plata ofertei reușită
- Returnarea plății pentru ofertă
- Acces la produs deschis
- Start acces prin abonament
- Sfârșit acces prin abonament
Variabilele plății
Variabilă | Valoare |
---|---|
payment.id | ID plată |
payment.price | Prețul plății |
payment.currency_code | Valuta plății în format cod. Exemplu: USD |
payment.currency_symbol | Valuta plății în format simbol. Exemplu: $ |
payment.currency_short_title | Valuta plății în denumire prescurtată. Exemplu: usd |
payment.created_at | Data creării plății. Format YYYY-MM-DD HH:mm:ss |
payment.paid_at | Data plății. Format YYYY-MM-DD HH:mm:ss |
payment.schedule_payment_at | Data planificată a plății. Format YYYY-MM-DD HH:mm:ss |
платіж.номер | Numărul de ordine al plății în comandă |
Lista poate fi completată. |
Disponibile la declanșarea următoarelor evenimente:
- Plata ofertei reușită
- Returnarea plății pentru ofertă
Variabilele ofertei
Variabilă | Valoare |
---|---|
offer.id | ID ofertă |
offer.title | Numele ofertei |
Lista poate fi completată. |
Disponibile la declanșarea următoarelor evenimente:
- Plata ofertei reușită
- Returnarea plății pentru ofertă
- Ofertă gratuită acceptată
- Abonament început
- Abonament prelungit
- Plata comenzii reușită
- Comandă nouă
- Acces la produs deschis
- Start acces prin abonament
- Sfârșit acces prin abonament
Variabilele abonamentului la produs
Variabilă | Valoare |
---|---|
subscription.id | ID abonament produs |
subscription.start_at | Data de început a abonamentului. YYYY-MM-DD HH:mm:ss |
subscription.end_at | Data finală de încheiere a abonamentului. YYYY-MM-DD HH:mm:ss |
subscription.order_end_at | Data de încheiere a abonamentului, luând în considerare doar plățile efectuate. YYYY-MM-DD HH:mm:ss |
subscription.paid_at | Data primei plăți a abonamentului. YYYY-MM-DD HH:mm:ss |
Lista poate fi completată. |
Disponibile la declanșarea următoarelor evenimente:
- Acces la produs deschis
- Start acces prin abonament
- Sfârșit acces prin abonament
Variabilele încercării de a trece testul
Variabilă | Valoare |
---|---|
quiz_attempt.id | ID încercare |
quiz_attempt.number_version | Numărul versiunii de trecere |
quiz_attempt.quiz_id | ID chestionar |
quiz_attempt.course_id | ID curs |
quiz_attempt.course_lesson_id | ID lecție |
quiz_attempt.status_id | ID status |
quiz_attempt.status | Status în formă text |
quiz_attempt.scores | Punctaj obținut |
quiz_attempt.created_at | Începutul încercării. Format YYYY-MM-DD HH:mm:ss |
quiz_attempt.finished_at | Sfârșitul încercării. Format YYYY-MM-DD HH:mm:ss |
quiz_attempt.count_questions | Numărul de întrebări din chestionar |
quiz_attempt.count_questions_incorrect | Numărul de întrebări la care s-a răspuns greșit |
quiz_attempt.count_questions_correct | Numărul de întrebări la care s-a răspuns corect |
quiz.title | Numele chestionarului |
Lista poate fi completată. |
Disponibile la declanșarea următoarelor evenimente:
- Trecerea chestionarului
- Anularea rezultatului anterior al chestionarului
- Chestionarul a trecut în status
Variabilele lecției
Variabilă | Valoare |
---|---|
lesson.id | ID lecție |
lesson.title | Numele lecției |
Lista poate fi completată. |
Disponibile la declanșarea următoarelor evenimente:
- Trecerea chestionarului
- Anularea rezultatului anterior al chestionarului
- Chestionarul a trecut în status
- A început să vizioneze lecția
- A vizionat lecția
- Acces la lecție deschis
- Practica la lecție finalizată