Centrum pomoci KWIGA Služby, integrácie, API, Nastavenia Všeobecné nastavenia Používanie premenných v projekte, zoznam dostupných premenných

Používanie premenných v projekte, zoznam dostupných premenných

Články:

pred 11 mesiacmi • Aktualizované

Tento článok vysvetľuje, ako používať premenné vo vašom projekte – kde ich použiť, aké údaje sú k dispozícii a ako ich využiť na automatizáciu a personalizáciu. Obsahuje zoznam s popismi a príkladmi pre e-maily, webhooky, tlačidlá, lekcie a ďalšie.

Všeobecné informácie o premenných

Premenné sú praktický spôsob, ako vložiť personalizované údaje do rôznych prvkov vášho projektu. Môžete ich použiť napríklad na týchto miestach:

1. Webhooky v automatizáciách

Premenné môžete vložiť:

do URL webhooku, napríklad:
https://example.com/hook?user={user.email}
do parametrov tela požiadavky
do hlavičiek

Umožňuje to automaticky odosielať osobné údaje do služieb tretích strán.

2. CTA (výzva na akciu)

V tlačidlách a odkazoch môžete premenné použiť na:

personalizáciu textu tlačidla
prenos údajov prostredníctvom odkazov, napríklad ID používateľa alebo značiek UTM

3. V parametroch

Premenné môžete použiť v parametroch formulára alebo iných prvkoch:

e-mail používateľa
ID predplatného
jedinečné kódy a značky
akúkoľvek inú premennú dostupnú v kontexte

4. V odkaze na presmerovanie (ak sa nepoužíva prechod na platbu)

Premenné môžete do odkazu na presmerovanie pridať manuálne:

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

5. V odkaze na presmerovanie po úspešnej platbe za ponuku

V odkaze na presmerovanie po úspešnej platbe za ponuku sú dostupné premenné z blokov contact.*, order.* a payment.*

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

5. V informačných blokoch lekcie

V textoch informačných blokov fungujú premenné aj podmienené bloky. Napríklad:

Oslovenie menom: Ahoj, {user.first_name}!
Zobrazenie názvu kurzu, dátumu, stavu atď.
Kontaktné údaje: {contact.name}, {contact.email} a ďalšie polia
Údaje aktuálnej lekcie: {lesson.title}, {lesson.slug} a ďalšie polia lekcie
Podmienené bloky @if/@endif: zobrazujú rôzny obsah podľa toho, či má kontakt značku, prístup k ponuke atď.

6. V e-mailoch

Používanie premenných v e-mailoch robí komunikáciu osobnejšou a efektívnejšou. Vďaka premenným, ako sú {name}, {date} alebo {course_name}, e-mail pôsobí, akoby bol osobne adresovaný klientovi. Zvyšuje to dôveru, zapojenie a pravdepodobnosť, že používateľ e-mail dočíta až do konca alebo vykoná požadovanú akciu. Premenné navyše zjednodušujú automatizáciu hromadných e-mailových kampaní bez straty individuálneho prístupu.

7. V oznámeniach

Pri nastavovaní oznámení v akciách automatizácie vám premenné umožňujú dynamicky vkladať do oznámení informácie, ako je meno používateľa, číslo objednávky alebo názov ponuky. Zjednodušuje a urýchľuje to proces vytvárania oznámení, vďaka čomu sú intuitívnejšie a prispôsobiteľné rôznym scenárom.

Zoznam dostupných premenných

Zoznam dostupných premenných prístupných na všetkých miestach, kde je možné používať premenné.

Premenná	Hodnota
contact.id	ID kontaktu
contact.user_id	ID používateľa
contact.first_name	Meno kontaktu
contact.last_name	Priezvisko kontaktu
contact.middle_name	Stredné meno kontaktu
contact.name	Celé meno kontaktu
contact.email	E-mail kontaktu
contact.phone	Kontaktný telefón
contact.country	Krajina kontaktu. Napríklad: Ukrajina
contact.timezone	Časové pásmo kontaktu. Napríklad: Europe/Kyiv
contact.currency	Mena kontaktu. Napríklad: USD
contact.city	Mesto kontaktu
contact.utm_source	Zoznam jedinečných utm_source kontaktu (oddeľovač ", ")
contact.utm_medium	Zoznam jedinečných utm_medium kontaktu (oddeľovač ", ")
contact.utm_campaign	Zoznam jedinečných utm_campaign kontaktu (oddeľovač ", ")
contact.utm_term	Zoznam jedinečných utm_term kontaktu (oddeľovač ", ")
contact.utm_content	Zoznam jedinečných utm_content kontaktu (oddeľovač ", ")
contact.field_<id>	Vlastné polia (popis nižšie)
datetime	Dátum a čas vo formáte UTC YYYY-MM-DD HH:mm:ss
contact.visit_source	Zdroj návštevy
Tieto premenné sú dostupné v odkaze na presmerovanie po úspešnej platbe za ponuku.

Vlastné polia

{contact.field_<id>}

Príklad {contact.field_123}

<id> - ID poľa, ktoré môžete získať v nastaveniach poľa kontaktu (príklad https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Ako zmeniť hodnotu premennej

Za premennú môžete pridať možnosti na zmenu jej vzhľadu: pripojiť text, zmeniť písmená na veľké alebo naformátovať dátum.

Všeobecný tvar: {variable|option:value|option}. Napríklad: {order.id|prefix:ORDER-} alebo {payment.paid_at|format:DD.MM.YYYY}.

Čo chcete dosiahnuť	Čo napísať
Pridať text pred hodnotu	`{order.id\|prefix:ORDER-}` -> výsledkom bude `ORDER-123`
Pridať text za hodnotu	`{order.id\|suffix:-EU}` -> výsledkom bude `123-EU`
Nastaviť pevnú dĺžku čísla	`{payment.number\|pad:6}` -> výsledkom bude `000001`
Doplniť vlastným znakom namiesto núl	`{payment.number\|pad:6\|padchar:_}` -> výsledkom bude `_____1`
Zmeniť všetky písmená na veľké	`{contact.city\|upper}` -> `KYIV`
Zmeniť všetky písmená na malé	`{contact.city\|lower}` -> `kyiv`
Zmeniť na veľké iba prvé písmeno	`{contact.city\|ucfirst}` -> `Kyiv`
Zobraziť dátum v požadovanom formáte	`{payment.paid_at\|format:DD.MM.YYYY}` -> výsledkom bude `24.12.2026`

Ak chcete vlastný vzor formátu dátumu, môžete si pozrieť pripravené tokeny vo verejnej dokumentácii: pre formáty ako DD.MM.YYYY, MMMM YYYY, dddd vám pomôže dokumentácia Carbon. Pre formáty ako Y-m-d a H:i:s použite oficiálnu dokumentáciu PHP.

Dôležité: ak sa použije pad, hodnota sa najprv doplní na požadovanú dĺžku a až potom sa použijú ostatné možnosti.

Podmienené bloky @if / @endif

Umožňujú zobraziť alebo skryť časť textu v závislosti od podmienky. Ak je podmienka pravdivá, blok sa zobrazí; ak nie, úplne sa odstráni.

Syntax: @if(condition)...text...@endif

Príklad:
@if({contact.has|offer:123})Získajte prístup k materiálom@endif

Podmienka vnútri @if() je ľubovoľná premenná, ktorá vracia true alebo false. Momentálne je podporované {contact.has|...} (kontrola členstva kontaktu).

Podmienka contact.has — kontrola kontaktu

Umožňuje skontrolovať, či kontakt spĺňa určité podmienky. Vracia true alebo false. Zvyčajne sa používa spolu s podmienenými blokmi @if/@endif.

Syntax: {contact.has|type:value}

Typ	Hodnota	Popis
`offer`	ID ponuky	Kontakt má prístup k ponuke
`order`	ID objednávky	Kontakt má objednávku s týmto ID
`product`	ID produktu	Kontakt má prístup k produktu
`tag`	ID alebo názov štítku	Kontakt má štítok (podporovaná je cyrilika a medzery v názve)
`list`	ID zoznamu	Kontakt je v zozname
`course`	ID kurzu	Kontakt je zapísaný v kurze
`bootcamp`	ID kurzu	Alias pre course (bootcamp je podtypom course)
`webinar`	ID webinára	Kontakt má prístup k webináru
`closed_group`	ID uzavretej skupiny	Kontakt má prístup k uzavretej skupine

Môžete zadať viacero podmienok oddelených znakom | — všetky musia byť splnené súčasne (logika AND). Napríklad: {contact.has|offer:123|tag:VIP}

Príklady použitia:

{contact.has\|offer:123}	kontroluje prítomnosť ponuky s ID 123
{contact.has\|tag:VIP}	kontroluje štítok podľa názvu
{contact.has\|tag:тест тег}	štítok s medzerou a cyrilikou
{contact.has\|offer:123\|tag:VIP}	obe podmienky súčasne (AND)

Premenné, ktoré možno navyše použiť v CTA

v parametroch
v odkaze na presmerovanie (ak sa nepoužíva prechod na platbu)

Premenná	Hodnota
first_name	Meno z formulára
last_name	Priezvisko z formulára
middle_name	Prostredné meno z formulára
name	Celé meno z formulára
email	E-mail z formulára
phone	Telefón z formulára
field_<id>	Vlastné polia Telefón z formulára (popis nižšie)
utm_source	utm_source – konkrétne z návštevy, pri ktorej bol formulár odoslaný
utm_medium	utm_medium – konkrétne z návštevy, pri ktorej bol formulár odoslaný
utm_campaign	utm_campaign – konkrétne z návštevy, pri ktorej bol formulár odoslaný
utm_term	utm_term – konkrétne z návštevy, pri ktorej bol formulár odoslaný
utm_content	utm_content – konkrétne z návštevy, pri ktorej bol formulár odoslaný
widget_landing	URL vstupnej stránky, z ktorej bol formulár odoslaný
widget_landign_referer	Odporúčajúca stránka na vstupnej stránke pri odoslaní formulára
V niektorých formulároch môžu byť dostupné aj premenné popísané nižšie v časti Premenné dostupné vo webhookoch automatizácie Podľa objednávky ({order.}) - Ak je vybratá možnosť formulára Prístup k produktu (Úplný prístup/Podľa ponuky) Podľa produktu ({product.}) - Ak je vybratá možnosť formulára Prístup k produktu + Úplný prístup Podľa ponuky ({offer.*}) - Ak je vybratá možnosť formulára Prístup k produktu + Podľa ponuky

Vlastné polia

{field_<id>}

Príklad {contact.field_123}

<id> - ID poľa, ktoré môžete získať v nastaveniach poľa kontaktu (príklad https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Ak na stránke, na ktorej je umiestnený skript CTA alebo sledovací skript Kwiga, došlo k návštevám s UTM značkami a klient odoslal žiadosť na vstupnej stránke bez UTM značiek, v týchto premenných nebudú uvedené. Budú však dostupné v premenných {contact.utm_...}, ktoré sú popísané vyššie.

Premenné dostupné vo webhookoch automatizácie (URL, parametre, e-maily)