KWIGA Palīdzības centrs Pakalpojumi, integrācijas, API, iestatījumi Vispārējs iestatījums Mainīgo izmantošana projektā, pieejamo mainīgo saraksts

Mainīgo izmantošana projektā, pieejamo mainīgo saraksts

Raksti:

pirms 8 mēnešiem • Atjaunināts

Šajā rakstā skaidrots, kā izmantot mainīgos savā projektā — kur tos pielietot, kādi dati ir pieejami un kā tos izmantot automatizācijai un personalizācijai. Iekļauts saraksts ar aprakstiem un piemēriem e-pastiem, tīmekļa āķiem, pogām, nodarbībām un citiem elementiem.

Vispārīga informācija par mainīgajiem

Mainīgie ir ērts veids, kā ievietot personalizētus datus dažādos jūsu projekta elementos. Tos var izmantot šādās vietās:

1. Webhooki automatizācijās

Mainīgos var ievietot:

URL tīmekļa āķim, piemēram:
https://example.com/hook?user={user.email}
pieprasījuma ķermeņa parametros
virsrakstos

Tas ļauj automātiski nodot personiskos datus trešo pušu pakalpojumiem.

2. CTA (Call to Action)

Pogās un saitēs mainīgos var izmantot, lai:

personalizētu pogas tekstu
nodotu datus caur saitēm, piemēram, lietotāja ID vai UTM tagus

3. Parametros

Mainīgos var izmantot formu parametros vai citos elementos:

lietotāja e-pasts
abonementa ID
unikāli kodi un tagi
jebkurš cits mainīgais, kas pieejams kontekstā

4. Pāradresācijas saitē (ja netiek izmantota pāreja uz apmaksu)

Mainīgos var manuāli pievienot pāradresācijas saitē:

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

5. Veiksmīgas piedāvājuma apmaksas novirzīšanas saite

Novirzīšanas saitē pēc veiksmīgas piedāvājuma apmaksas ir pieejami mainīgie no blokiem contact.*, order.* un payment.*

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

5. Nodarbību infoblokos

Mainīgie un nosacījumu bloki darbojas infobloku tekstos. Piemēram:

Uzruna pēc vārda: Sveiks, {user.first_name}!
Kursa nosaukuma, datuma, statusa utt. attēlošana.
Kontakta dati: {contact.name}, {contact.email} un citi lauki
Pašreizējās nodarbības dati: {lesson.title}, {lesson.slug} un citi nodarbības lauki
Nosacījumu bloki @if/@endif: rādīt atšķirīgu saturu atkarībā no tā, vai kontaktam ir tags, piekļuve piedāvājumam utt.

6. Vēstulēs

Mainīgo izmantošana e-pastos ļauj padarīt saziņu personalizētāku un efektīvāku. Ar tādu mainīgo palīdzību kā {имя}, {дата} vai {название курса} e-pasts izskatās personīgi adresēts klientam. Tas palielina uzticēšanos, iesaisti un varbūtību, ka lietotājs izlasīs e-pastu līdz galam vai veiks nepieciešamo darbību. Turklāt mainīgie vienkāršo masveida sūtījumu automatizāciju, nezaudējot individuālu pieeju.

7. Paziņojumos

Konfigurējot paziņojumus automatizācijas darbībās, mainīgie ļauj dinamiski ievietot informāciju paziņojumos, piemēram, lietotāja vārdu, pasūtījuma numuru vai piedāvājuma nosaukumu. Tas vienkāršo un paātrina paziņojumu izveides procesu, padarot tos intuitīvākus un pielāgojamākus dažādiem scenārijiem.

Pieejamo mainīgo saraksts

Pieejamo mainīgo saraksts, kas pieejami visās vietās, kur var izmantot mainīgos.

Mainīgais	Vērtība
contact.id	Kontakta ID
contact.user_id	Lietotāja ID
contact.first_name	Kontakta vārds
contact.last_name	Kontakta uzvārds
contact.middle_name	Kontakta tēvavārds
contact.name	Kontakta pilns vārds
contact.email	Kontakta e-pasts
contact.phone	Kontakta tālrunis
contact.country	Kontakta valsts. Piemēram: Ukraina
contact.timezone	Kontakta laika zona. Piemēram: Europe/Kyiv
contact.currency	Kontakta valūta. Piemēram: USD
contact.city	Kontakta pilsēta
contact.utm_source	Kontakta unikālo utm_source saraksts (atdalītājs ", ")
contact.utm_medium	Unikālo utm_medium kontaktu saraksts (atdalītājs ", ")
contact.utm_campaign	Unikālo utm_campaign kontaktu saraksts (atdalītājs ", ")
contact.utm_term	Unikālo utm_term kontaktu saraksts (atdalītājs ", ")
contact.utm_content	Unikālo utm_content kontaktu saraksts (atdalītājs ", ")
contact.field_<id>	Pielāgotie lauki (apraksts zemāk)
datetime	Datums un laiks UTC formātā YYYY-MM-DD HH:mm:ss
contact.visit_source	Apmeklējuma avots
Šie mainīgie ir pieejami veiksmīgas piedāvājuma apmaksas novirzīšanas saitē.

Pielāgoti lauki

{contact.field_<id>}

Piemērs {contact.field_123}

<id> - lauka id, kuru var iegūt kontaktu lauku iestatījumos (piemērs https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Kā mainīt mainīgā vērtību

Pēc mainīgā var pievienot opcijas, lai mainītu tā izskatu: pievienotu tekstu, padarītu burtus lielus vai formatētu datumu.

Vispārīgais formāts: {variable|option:value|option}. Piemēram: {order.id|prefix:ORDER-} vai {payment.paid_at|format:DD.MM.YYYY}.

Ko vēlaties iegūt	Ko rakstīt
Pievienot tekstu pirms vērtības	`{order.id\|prefix:ORDER-}` -> sanāks `ORDER-123`
Pievienot tekstu pēc vērtības	`{order.id\|suffix:-EU}` -> sanāks `123-EU`
Padarīt numuru fiksēta garuma	`{payment.number\|pad:6}` -> sanāks `000001`
Aizpildīt nevis ar nullēm, bet ar savu simbolu	`{payment.number\|pad:6\|padchar:_}` -> sanāks `_____1`
Padarīt visus burtus lielus	`{contact.city\|upper}` -> `KYIV`
Padarīt visus burtus mazus	`{contact.city\|lower}` -> `kyiv`
Padarīt lielo tikai pirmo burtu	`{contact.city\|ucfirst}` -> `Kyiv`
Rādīt datumu vajadzīgajā formātā	`{payment.paid_at\|format:DD.MM.YYYY}` -> sanāks `24.12.2026`

Ja vēlaties savu datuma veidni, gatavos apzīmējumus var apskatīt atvērtajās rokasgrāmatās: variantiem kā DD.MM.YYYY, MMMM YYYY, dddd derēs Carbon dokumentācija. Variantiem kā Y-m-d un H:i:s derēs oficiālā PHP dokumentācija.

Svarīgi: ja tiek izmantots pad, vispirms vērtība tiek papildināta līdz vajadzīgajam garumam, un tikai pēc tam tiek piemērotas pārējās opcijas.

Nosacījumu bloki @if / @endif

Ļauj rādīt vai paslēpt teksta daļu atkarībā no nosacījuma. Ja nosacījums ir patiess, bloks tiek parādīts; ja nē — pilnībā noņemts.

Sintakse: @if(nosacījums)...teksts...@endif

Piemērs:
@if({contact.has|offer:123})Iegūstiet piekļuvi materiāliem@endif

Nosacījums iekš @if() ir jebkurš mainīgais, kas atgriež true vai false. Pašlaik tiek atbalstīts {contact.has|...} (kontakta piederības pārbaude).

Nosacījums contact.has — kontakta pārbaude

Ļauj pārbaudīt, vai kontakts atbilst noteiktiem nosacījumiem. Atgriež true vai false. Parasti tiek izmantots kopā ar nosacījumu blokiem @if/@endif.

Sintakse: {contact.has|tips:vērtība}

Tips	Vērtība	Apraksts
`offer`	Piedāvājuma ID	Kontaktam ir piekļuve piedāvājumam
`order`	Pasūtījuma ID	Kontaktam ir pasūtījums ar šādu ID
`product`	Produkta ID	Kontaktam ir piekļuve produktam
`tag`	Taga ID vai nosaukums	Kontaktam ir tags (tiek atbalstīta kirilica un atstarpes nosaukumā)
`list`	Saraksta ID	Kontakts ir iekļauts sarakstā
`course`	Kursa ID	Kontakts ir pierakstīts kursam
`marathon`	Kursa ID	Pseidonīms priekš course (maratons — kursa apakštips)
`webinar`	Vebināra ID	Kontaktam ir piekļuve vebināram
`closed_group`	Slēgtās grupas ID	Kontaktam ir piekļuve slēgtajai grupai

Var norādīt vairākus nosacījumus, izmantojot | — tiem visiem jāizpildās vienlaikus (AND loģika). Piemēram: {contact.has|offer:123|tag:VIP}

Lietošanas piemēri:

{contact.has\|offer:123}	pārbauda piedāvājuma ar ID 123 esamību
{contact.has\|tag:VIP}	pārbauda tagu pēc nosaukuma
{contact.has\|tag:тест тег}	tags ar atstarpi un kirilicu
{contact.has\|offer:123\|tag:VIP}	abi nosacījumi vienlaikus (AND)

Mainīgie, kurus var papildus izmantot CTA

parametros
pāradresācijas saitē (ja netiek izmantota pāreja uz apmaksu)

Mainīgais	Vērtība
first_name	Vārds no pieteikuma
last_name	Uzvārds no pieteikuma
middle_name	Pieteikuma tēvavārds
name	Pilns vārds no pieteikuma
email	Email no pieteikuma
phone	Telefons no pieteikuma
field_<id>	Pieteikuma pielāgotie lauki Tālrunis (apraksts zemāk)
utm_source	utm_source - konkrēti tam apmeklējumam, no kura tika atstāts pieteikums
utm_medium	utm_medium - konkrēti tam apmeklējumam, no kura tika atstāts pieteikums
utm_campaign	utm_campaign - konkrēti tam apmeklējumam, no kura tika atstāts pieteikums
utm_term	utm_term - konkrēti tam apmeklējumam, no kura tika atstāts pieteikums
utm_content	utm_content - konkrēti tam apmeklējumam, no kura tika atstāts pieteikums
widget_landing	Url galvenajai lapai, no kuras tika nosūtīts pieteikums
widget_landign_referer	Referer, kas bija galvenajā lapā, kad tika nosūtīts pieteikums
Arī noteiktās formās var būt pieejami mainīgie, kas aprakstīti zemāk sadaļā Mainīgie pieejami automatizācijas tīmekļa āķos Pēc pasūtījuma ({order.}) - Ja izvēlēts formas variants Piekļuve produktam (Pilna piekļuve/Pēc piedāvājuma) Pēc produkta({product.}) - Ja izvēlēts formas variants Piekļuve produktam + Pilna piekļuve Pēc piedāvājuma ({offer.*}) - Ja izvēlēts formas variants Piekļuve produktam + Pēc piedāvājuma

Pielāgoti lauki

{field_<id>}

Piemērs {contact.field_123}

<id> - lauka id, kuru var iegūt kontaktu lauku iestatījumos (piemērs https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Ja lapā, kurā ievietots CTA vai Kwiga skripts apmeklējumu izsekošanai, bija apmeklējumi ar utm atzīmēm, un klients atstāja pieteikumu galvenajā lapā jau bez utm atzīmēm, tad šajos mainīgajos tās nebūs. Bet tās būs pieejamas mainīgajos {contact.utm_...}, kas aprakstīti augstāk.

Mainīgie, kas pieejami automatizācijas tīmekļa āķos (url, parametri, vēstules)