KWIGA súgóközpont Szolgáltatások, integrációk, API, Beállítások Általános beállítás Változók használata a projektben, az elérhető változók listája

Változók használata a projektben, az elérhető változók listája

Cikkek:

7 hónapja • Frissítve

Ez a cikk bemutatja, hogyan használhatók a változók a projektben – hol alkalmazhatók, milyen adatok érhetők el, és hogyan használhatók automatizálásra és személyre szabásra. Tartalmaz egy listát leírásokkal és példákkal e-mailekhez, webhookokhoz, gombokhoz, leckékhez és egyebekhez.

Általános információ a változókról

A változók kényelmes módot kínálnak arra, hogy személyre szabott adatokat illesszen be a projekt különböző elemeibe. Ezeket az alábbi helyeken lehet használni:

1. Webhookok az automatizálásokban

A változók behelyettesíthetők:

a webhook URL-jében, például:
https://example.com/hook?user={user.email}
a kérés törzsének paramétereiben
a fejlécekben

Ez lehetővé teszi a személyes adatok automatikus továbbítását külső szolgáltatásokba.

2. CTA (Call to Action)

A gombokban és linkekben a változók az alábbiakra használhatók:

a gomb szövegének személyre szabására
adatok átadására linkeken keresztül, például felhasználóazonosító vagy UTM-címkék

3. Paraméterekben

A változók használhatók űrlapok vagy más elemek paramétereiben:

a felhasználó email-címe
előfizetésazonosító
egyedi kódok és címkék
bármely más változó, amely elérhető az adott kontextusban

4. Az átirányítási linkben (ha nincs fizetésre irányítás)

A változókat kézzel is hozzáadhatja az átirányítási linkhez:

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

5. Az ajánlat sikeres kifizetése utáni átirányítási linkben

Az ajánlat sikeres kifizetése utáni átirányítási linkben a contact.*, order.* és payment.* blokkok változói érhetők el

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

6. Az leckék információs blokkjaiban

A változók és a feltételes blokkok az infóblokkok szövegein belül működnek. Például:

Név szerinti megszólítás: Szia, {user.first_name}!
A kurzus címének, dátumának, állapotának stb. megjelenítése
Kapcsolati adatok: {contact.name}, {contact.email} és más mezők
Feltételes blokkok @if/@endif: különböző tartalom megjelenítése attól függően, hogy a kapcsolathoz van-e címke rendelve, van-e hozzáférése az ajánlathoz stb.

7. E-mailekben

A változók használata az e-mailekben lehetővé teszi, hogy a kommunikáció személyesebb és hatékonyabb legyen. Az olyan változók segítségével, mint a {nev}, a {datum} vagy a {kurzus_neve}, az e-mail úgy hat, mintha személyesen a kliensnek szólna. Ez növeli a bizalmat, az elköteleződést és annak valószínűségét, hogy a felhasználó végigolvassa az e-mailt vagy végrehajtja a kívánt műveletet. Emellett a változók megkönnyítik a tömeges kiküldések automatizálását az egyéni megközelítés elvesztése nélkül.

8. Értesítésekben

Az értesítések automatizálási műveletekben történő beállításakor a változók lehetővé teszik az információk dinamikus beillesztését az értesítésekbe, például a felhasználó nevét, a rendelési számot vagy az ajánlat nevét. Ez egyszerűsíti és felgyorsítja az értesítések létrehozásának folyamatát, intuitívabbá és rugalmasabbá téve azokat a különböző forgatókönyvekhez.

Elérhető változók listája

Az elérhető változók listája, amelyek minden olyan helyen használhatók, ahol változók alkalmazhatók.

Változó	Érték
contact.id	Kapcsolat ID
contact.user_id	Felhasználó ID
contact.first_name	Kapcsolat keresztneve
contact.last_name	Kapcsolat vezetékneve
contact.middle_name	Kapcsolat apai neve
contact.name	Kapcsolat teljes neve
contact.email	Kapcsolat e-mail címe
contact.phone	Kapcsolat telefonszáma
contact.country	Kapcsolat országa. Például: Ukrajna
contact.timezone	Kapcsolat időzónája. Például: Europe/Kyiv
contact.currency	Kapcsolat pénzneme. Például: USD
contact.city	Kapcsolat városa
contact.utm_source	A kapcsolat egyedi utm_source értékeinek listája (elválasztó: ", ")
contact.utm_medium	A kapcsolat egyedi utm_medium értékeinek listája (elválasztó: ", ")
contact.utm_campaign	A kapcsolat egyedi utm_campaign értékeinek listája (elválasztó: ", ")
contact.utm_term	A kapcsolat egyedi utm_term értékeinek listája (elválasztó: ", ")
contact.utm_content	A kapcsolat egyedi utm_content értékeinek listája (elválasztó: ", ")
contact.field_<id>	Egyéni mezők (leírás alább)
datetime	Dátum és idő UTC-ben YYYY-MM-DD HH:mm:ss formátumban
contact.visit_source	Látogatás forrása
Ezek a változók az ajánlat sikeres kifizetése utáni átirányítási linkben érhetők el.

Egyéni mezők

{contact.field_<id>}

Példa {contact.field_123}

<id> - a mező azonosítója, amely a kapcsolatmezők beállításaiban szerezhető meg (példa https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

A változó értékének módosítása

A változó után opciókat lehet hozzáadni, hogy megváltoztassa a megjelenését: szöveget hozzáfűzni, nagybetűssé tenni, vagy formázni a dátumot.

Általános forma: {variable|option:value|option}. Például: {order.id|prefix:ORDER-} vagy {payment.paid_at|format:DD.MM.YYYY}.

Mit szeretne kapni	Mit kell írni
Szöveg hozzáadása az érték elé	`{order.id\|prefix:ORDER-}` -> eredmény: `ORDER-123`
Szöveg hozzáadása az érték után	`{order.id\|suffix:-EU}` -> eredmény: `123-EU`
A szám fix hosszúságúvá tétele	`{payment.number\|pad:6}` -> eredmény: `000001`
Ne nullákkal, hanem saját karakterrel töltse fel	`{payment.number\|pad:6\|padchar:_}` -> eredmény: `_____1`
Az összes betű nagybetűssé tétele	`{contact.city\|upper}` -> `KYIV`
Az összes betű kisbetűssé tétele	`{contact.city\|lower}` -> `kyiv`
Csak az első betű legyen nagybetűs	`{contact.city\|ucfirst}` -> `Kyiv`
A dátum megjelenítése a kívánt formában	`{payment.paid_at\|format:DD.MM.YYYY}` -> eredmény: `24.12.2026`

Ha saját dátumsablont szeretne, a kész jelöléseket megnézheti a nyilvános dokumentációkban: az olyan formátumokhoz, mint DD.MM.YYYY, MMMM YYYY, dddd, megfelelő a Carbon dokumentációja. Az olyan formátumokhoz, mint Y-m-d és H:i:s, megfelelő a hivatalos PHP dokumentáció.

Fontos: ha a pad használatban van, az érték először a szükséges hosszra egészül ki, és csak ezután kerülnek alkalmazásra a többi opciók.

Feltételes blokkok @if / @endif

Lehetővé teszik a szöveg egy részének megjelenítését vagy elrejtését egy feltételtől függően. Ha a feltétel igaz, a blokk megjelenik; ha nem, teljesen eltűnik.

Szintaxis: @if(feltétel)...szöveg...@endif

Példa:
@if({contact.has|offer:123})Szerezzen hozzáférést az anyagokhoz@endif

A @if() belsejében lévő feltétel bármely változó lehet, amely true vagy false értéket ad vissza. Jelenleg a {contact.has|...} támogatott (a kapcsolat megfelelőségének ellenőrzése).

A contact.has feltétel — kapcsolat ellenőrzése

Lehetővé teszi annak ellenőrzését, hogy a kapcsolat megfelel-e bizonyos feltételeknek. true vagy false értéket ad vissza. Általában a @if/@endif feltételes blokkokkal együtt használják.

Szintaxis: {contact.has|típus:érték}

Típus	Érték	Leírás
`offer`	Ajánlat azonosítója	A kapcsolat hozzáfér az ajánlathoz
`order`	Rendelés azonosítója	A kapcsolatnak van ilyen azonosítójú rendelése
`product`	Termékazonosító	A kapcsolat hozzáfér a termékhez
`tag`	A címke azonosítója vagy neve	A kapcsolat rendelkezik címkével (cirill betűk és szóközök a névben támogatottak)
`list`	Lista azonosítója	A kapcsolat szerepel a listában
`course`	Kurzusazonosító	A kapcsolat be van iratkozva a kurzusra
`marathon`	Kurzusazonosító	A course álneve (a maraton a kurzus egyik altípusa)
`webinar`	Webinár azonosítója	A kapcsolat hozzáfér a webinárhoz
`closed_group`	Zárt csoport azonosítója	A kapcsolat hozzáfér a zárt csoporthoz

Több feltétel is megadható a | jellel — mindegyiknek egyszerre kell teljesülnie (AND logika). Például: {contact.has|offer:123|tag:VIP}

Használati példák:

{contact.has\|offer:123}	ellenőrzi a 123 azonosítójú ajánlat meglétét
{contact.has\|tag:VIP}	ellenőrzi a címkét név alapján
{contact.has\|tag:тест тег}	címke szóközzel és cirill betűkkel
{contact.has\|offer:123\|tag:VIP}	mindkét feltétel egyszerre (AND)

A CTA-ban kiegészítően használható változók

a paraméterekben
az átirányítási hivatkozásban (ha nincs fizetésre irányítás használatban)

Változó	Érték
first_name	Keresztnév az űrlapbeküldésből
last_name	Vezetéknév az űrlapbeküldésből
middle_name	Apai név az űrlapbeküldésből
name	Teljes név az űrlapbeküldésből
email	E-mail az űrlapbeküldésből
phone	Telefonszám az űrlapbeküldésből
field_<id>	Egyéni mezők Telefon az űrlapbeküldésből (leírás alább)
utm_source	utm_source - pontosan abból a látogatásból, amelyből az űrlapbeküldés történt
utm_medium	utm_medium - pontosan abból a látogatásból, amelyből az űrlapbeküldés történt
utm_campaign	utm_campaign - pontosan abból a látogatásból, amelyből az űrlapbeküldés történt
utm_term	utm_term - pontosan abból a látogatásból, amelyből az űrlapbeküldés történt
utm_content	utm_content – pontosan annak a látogatásnak az adata, amelyből az érdeklődői jelentkezés érkezett
widget_landing	Annak a landing oldalnak az URL-je, ahonnan a jelentkezést elküldték
widget_landign_referer	Az a referer, amely a landing oldalon volt, amikor a jelentkezést elküldték
Bizonyos űrlapokban az alább, az automatizálási webhookokban elérhető Változók részben leírt változók is elérhetők lehetnek Rendelés szerint ({order.}) - Ha az űrlaptípusnál a Termékhozzáférés lehetőség van kiválasztva (Teljes hozzáférés/Ajánlat szerint) Termék szerint ({product.}) - Ha az űrlaptípusnál a Termékhozzáférés + Teljes hozzáférés lehetőség van kiválasztva Ajánlat szerint ({offer.*}) - Ha az űrlaptípusnál a Termékhozzáférés + Ajánlat szerint lehetőség van kiválasztva

Egyéni mezők

{field_<id>}

Példa {field_123}

<id> - a mező azonosítója, amely a kapcsolatmezők beállításaiban szerezhető meg (példa https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Ha azon az oldalon, ahol a CTA vagy a Kwiga látogatáskövető szkriptje el van helyezve, voltak utm címkével érkező látogatások, és az ügyfél már utm címkék nélkül küldött be jelentkezést a landing oldalon, akkor ezekben a változókban nem fognak szerepelni. De elérhetők lesznek a fent leírt {contact.utm_...} változókban.

Az automatizálási webhookokban elérhető változók (url, paraméterek, e-mailek)