KWIGA centar za pomoć Usluge, integracije, API, Podešavanja Opšta podešavanja Korišćenje promenljivih u projektu, lista dostupnih promenljivih

Korišćenje promenljivih u projektu, lista dostupnih promenljivih

Članci:

pre 11 meseci • Ažurirano

Ovaj članak objašnjava kako da koristite promenljive u svom projektu – gde da ih primenite, koji su podaci dostupni i kako da ih koristite za automatizaciju i personalizaciju. Sadrži listu sa opisima i primerima za e-poruke, veb-hookove, dugmad, lekcije i još mnogo toga.

Opšte informacije o promenljivama

Promenljive su praktičan način za umetanje personalizovanih podataka u različite elemente vašeg projekta. Mogu se koristiti na mestima kao što su:

1. Webhookovi u automatizacijama

Promenljive se mogu umetnuti:

u URL webhooka, na primer:
https://example.com/hook?user={user.email}
u parametrima tela zahteva
u zaglavljima

To omogućava automatsko slanje ličnih podataka servisima trećih strana.

2. CTA (poziv na akciju)

U dugmadima i linkovima, promenljive se mogu koristiti za:

personalizaciju teksta dugmeta
prosleđivanje podataka putem linkova, kao što su ID korisnika ili UTM oznake

3. U parametrima

Promenljive se mogu koristiti u parametrima obrasca ili drugim elementima:

e-pošta korisnika
ID pretplate
jedinstveni kodovi i oznake
bilo koja druga promenljiva dostupna u kontekstu

4. U linku za preusmeravanje (ako se ne koristi prelazak na plaćanje)

Promenljive se mogu ručno dodati u link za preusmeravanje:

https://my.site.com/thanks?email={user.email}&course={course.title}

5. U linku za preusmeravanje nakon uspešnog plaćanja ponude

U linku za preusmeravanje nakon uspešnog plaćanja ponude dostupne su promenljive iz blokova contact.*, order.* i payment.*

Primer: https://my.site.com/success?order_id={order.id}&email={contact.email}&payment_price={payment.price}

5. U blokovima informacija o lekciji

Promenljive i uslovni blokovi rade unutar tekstova info-okvira. Na primer:

Obraćanje po imenu: Zdravo, {user.first_name}!
Prikazivanje naziva kursa, datuma, statusa itd.
Podaci za kontakt: {contact.name}, {contact.email} i druga polja
Podaci o trenutnoj lekciji: {lesson.title}, {lesson.slug} i druga polja lekcije
Uslovni blokovi @if/@endif: prikažite različit sadržaj u zavisnosti od toga da li kontakt ima oznaku, pristup ponudi itd.

6. U e-porukama

Korišćenje promenljivih u e-porukama čini komunikaciju personalizovanijom i efikasnijom. Uz promenljive kao što su {name}, {date} ili {course_name}, e-poruka izgleda kao da je lično upućena klijentu. To povećava poverenje, angažovanje i verovatnoću da će korisnik pročitati e-poruku do kraja ili izvršiti željenu radnju. Pored toga, promenljive pojednostavljuju automatizaciju masovnog slanja e-poruka bez gubitka individualnog pristupa.

7. U obaveštenjima

Kada podešavate obaveštenja u radnjama automatizacije, promenljive vam omogućavaju da dinamički umetnete informacije u obaveštenja, kao što su korisničko ime, broj porudžbine ili naziv ponude. To pojednostavljuje i ubrzava proces kreiranja obaveštenja, čineći ih intuitivnijim i prilagodljivijim različitim scenarijima.

Lista dostupnih promenljivih

Lista dostupnih promenljivih kojima se može pristupiti na svim mestima gde se promenljive mogu koristiti.

Promenljiva	Vrednost
contact.id	ID kontakta
contact.user_id	ID korisnika
contact.first_name	Ime kontakta
contact.last_name	Prezime kontakta
contact.middle_name	Srednje ime kontakta
contact.name	Puno ime kontakta
contact.email	E-pošta kontakta
contact.phone	Telefon za kontakt
contact.country	Zemlja kontakta. Na primer: Ukrajina
contact.timezone	Vremenska zona kontakta. Na primer: Europe/Kyiv
contact.currency	Valuta kontakta. Na primer: USD
contact.city	Grad kontakta
contact.utm_source	Lista jedinstvenih utm_source kontakta (razdvajač ", ")
contact.utm_medium	Lista jedinstvenih utm_medium kontakta (razdvajač ", ")
contact.utm_campaign	Lista jedinstvenih utm_campaign kontakta (razdvajač ", ")
contact.utm_term	Lista jedinstvenih utm_term kontakta (razdvajač ", ")
contact.utm_content	Lista jedinstvenih utm_content kontakta (razdvajač ", ")
contact.field_<id>	Prilagođena polja (opis ispod)
datetime	Datum i vreme u UTC formatu YYYY-MM-DD HH:mm:ss
contact.visit_source	Izvor posete
Ove promenljive su dostupne u linku za preusmeravanje nakon uspešne uplate ponude.

Prilagođena polja

{contact.field_<id>}

Primer {contact.field_123}

<id> - ID polja, koji se može dobiti u podešavanjima polja kontakta (primer https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Kako promeniti vrednost promenljive

Možete dodati opcije nakon promenljive da biste promenili njen izgled: dodali tekst, pretvorili slova u velika ili formatirali datum.

Opšti oblik: {variable|option:value|option}. Na primer: {order.id|prefix:ORDER-} ili {payment.paid_at|format:DD.MM.YYYY}.

Šta želite da dobijete	Šta da napišete
Dodajte tekst pre vrednosti	`{order.id\|prefix:ORDER-}` -> rezultat će biti `ORDER-123`
Dodajte tekst nakon vrednosti	`{order.id\|suffix:-EU}` -> rezultat će biti `123-EU`
Postavite fiksnu dužinu broja	`{payment.number\|pad:6}` -> rezultat će biti `000001`
Dopunite sopstvenim znakom umesto nulama	`{payment.number\|pad:6\|padchar:_}` -> rezultat će biti `_____1`
Pretvorite sva slova u velika	`{contact.city\|upper}` -> `KYIV`
Pretvorite sva slova u mala	`{contact.city\|lower}` -> `kyiv`
Napišite velikim samo prvo slovo	`{contact.city\|ucfirst}` -> `Kyiv`
Prikažite datum u potrebnom formatu	`{payment.paid_at\|format:DD.MM.YYYY}` -> rezultat će biti `24.12.2026`

Ako želite sopstveni obrazac formata datuma, možete proveriti gotove tokene u javnoj dokumentaciji: za formate kao što su DD.MM.YYYY, MMMM YYYY, dddd, pomoći će vam Carbon dokumentacija. Za formate kao što su Y-m-d i H:i:s, koristite zvaničnu PHP dokumentaciju.

Važno: ako se koristi pad, vrednost se prvo dopunjava do potrebne dužine, a tek onda se primenjuju ostale opcije.

Uslovni blokovi @if / @endif

Omogućavaju vam da prikažete ili sakrijete deo teksta u zavisnosti od uslova. Ako je uslov tačan, blok se prikazuje; ako nije, potpuno se uklanja.

Sintaksa: @if(condition)...tekst...@endif

Primer:
@if({contact.has|offer:123})Dobijte pristup materijalima@endif

Uslov unutar @if() je bilo koja promenljiva koja vraća true ili false. Trenutno je podržano {contact.has|...} (provera članstva kontakta).

Uslov contact.has — provera kontakta

Omogućava vam da proverite da li kontakt ispunjava određene uslove. Vraća true ili false. Obično se koristi zajedno sa uslovnim blokovima @if/@endif.

Sintaksa: {contact.has|type:value}

Tip	Vrednost	Opis
`offer`	ID ponude	Kontakt ima pristup ponudi
`order`	ID porudžbine	Kontakt ima porudžbinu sa ovim ID-jem
`product`	ID proizvoda	Kontakt ima pristup proizvodu
`tag`	ID ili naziv oznake	Kontakt ima oznaku (podržani su ćirilica i razmaci u nazivu)
`list`	ID liste	Kontakt je na listi
`course`	ID kursa	Kontakt je upisan na kurs
`bootcamp`	ID kursa	Alias za course (bootcamp je podtip course)
`webinar`	ID vebinara	Kontakt ima pristup vebinaru
`closed_group`	ID zatvorene grupe	Kontakt ima pristup zatvorenoj grupi

Možete navesti više uslova odvojenih sa | — svi moraju biti ispunjeni istovremeno (AND logika). Na primer: {contact.has|offer:123|tag:VIP}

Primeri upotrebe:

{contact.has\|offer:123}	proverava postojanje ponude sa ID-jem 123
{contact.has\|tag:VIP}	proverava oznaku po nazivu
{contact.has\|tag:тест тег}	oznaka sa razmakom i ćirilicom
{contact.has\|offer:123\|tag:VIP}	oba uslova istovremeno (AND)

Promenljive koje se dodatno mogu koristiti u CTA

u parametrima
u linku za preusmeravanje (ako se ne koristi prelazak na plaćanje)

Promenljiva	Vrednost
first_name	Ime iz prijave
last_name	Prezime iz prijave
middle_name	Srednje ime iz prijave
name	Puno ime iz prijave
email	E-pošta iz prijave
phone	Telefon iz prijave
field_<id>	Prilagođena polja Telefon iz prijave (opis ispod)
utm_source	utm_source – konkretno iz posete tokom koje je prijava poslata
utm_medium	utm_medium – konkretno iz posete tokom koje je prijava poslata
utm_campaign	utm_campaign – konkretno iz posete tokom koje je prijava poslata
utm_term	utm_term – konkretno iz posete tokom koje je prijava poslata
utm_content	utm_content – konkretno iz posete tokom koje je prijava poslata
widget_landing	URL odredišne stranice sa koje je prijava poslata
widget_landign_referer	Preporučilac koji je bio na odredišnoj stranici kada je prijava poslata
Takođe, u određenim obrascima mogu biti dostupne promenljive opisane u nastavku u odeljku Promenljive dostupne u webhookovima automatizacije Po porudžbini ({order.}) - Ako je izabrana opcija obrasca Pristup proizvodu (Pun pristup/Po ponudi) Po proizvodu ({product.}) - Ako je izabrana opcija obrasca Pristup proizvodu + Pun pristup Po ponudi ({offer.*}) - Ako je izabrana opcija obrasca Pristup proizvodu + Po ponudi

Prilagođena polja

{field_<id>}

Primer {contact.field_123}

<id> - ID polja, koji se može dobiti u podešavanjima polja kontakta (primer https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Ako je na stranici na kojoj je postavljen CTA ili Kwiga skript za praćenje bilo poseta sa utm oznakama, a klijent je poslao zahtev na odredišnoj stranici bez utm oznaka, one neće biti prisutne u ovim promenljivama. Ali biće dostupne u promenljivama {contact.utm_...}, koje su opisane iznad.

Promenljive dostupne u webhookovima automatizacije (URL, parametri, e-poruke)