Centrul de asistență KWIGA Servicii, integrări, API, Setări Setări generale Utilizarea variabilelor în proiect, listă de variabile disponibile

Utilizarea variabilelor în proiect, listă de variabile disponibile

Articole:

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)

Custom fields example

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 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ă