KWIGA centrum nápovědy Služby, integrace, API, Nastavení Obecné nastavení Používání proměnných v projektu, seznam dostupných proměnných

Používání proměnných v projektu, seznam dostupných proměnných

Články:

před 2 týdny • Aktualizováno

Tento článek vysvětluje, jak používat proměnné ve vašem projektu — kde je uplatnit, jaká data jsou dostupná a jak je využít pro automatizaci a personalizaci. Obsahuje seznam s popisy a příklady pro e-maily, webhooky, tlačítka, lekce a další.

Obecné informace o proměnných

Proměnné jsou pohodlný způsob, jak vkládat personalizovaná data do různých prvků vašeho projektu. Mohou být použity na těchto místech:

1. Webhooky v automatizacích

Proměnné lze vkládat:

v URL webhooku, například:
https://example.com/hook?user={user.email}
v parametrech těla žádosti
v záhlaví

To umožňuje automaticky předávat osobní údaje do externích služeb.

2. CTA (Call to Action)

V tlačítkách a odkazech lze proměnné použít pro:

personalizaci textu tlačítka
předávání dat přes odkazy, například ID uživatele nebo UTM značky

3. V parametrech

Proměnné lze použít v parametrech formulářů nebo jiných prvků:

email uživatele
ID předplatného
unikátní kódy a značky
jakákoli jiná proměnná dostupná v kontextu

4. V odkazu přesměrování (pokud se nepoužívá přechod na platbu)

Proměnné lze ručně přidat do odkazu přesměrování:

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

5. V infoblocích lekcí

Proměnné fungují uvnitř textů infoblocích. Například:

Oslovení jménem: Ahoj, {user.first_name}!
Zobrazení názvu kurzu, data, stavu atd.

6. V e-mailech

Použití proměnných v e-mailech umožňuje učinit komunikaci více personalizovanou a efektivní. Pomocí proměnných, jako jsou {jméno}, {datum} nebo {název kurzu}, e-mail vypadá osobně adresovaný klientovi. To zvyšuje důvěru, zapojení a pravděpodobnost, že uživatel dočte e-mail do konce nebo provede požadovanou akci. Kromě toho proměnné usnadňují automatizaci hromadných rozesílek bez ztráty individuálního přístupu.

Seznam dostupných proměnných

Seznam dostupných proměnných, které jsou dostupné na všech místech, kde lze použít proměnné.

Proměnná	Hodnota
contact.id	ID kontaktu
contact.user_id	ID uživatele
contact.first_name	Jméno kontaktu
contact.last_name	Příjmení kontaktu
contact.middle_name	Prostřední jméno kontaktu
contact.name	Celé jméno kontaktu
contact.email	Email kontaktu
contact.phone	Telefon kontaktu
contact.country	Země kontaktu. Například: Ukrajina
contact.timezone	Časové pásmo kontaktu. Například: Europe/Kyiv
contact.currency	Měna kontaktu. Například: USD
contact.city	Město kontaktu
contact.utm_source	Seznam unikátních utm_source kontaktu (oddělovač ", ")
contact.utm_medium	Seznam unikátních utm_medium kontaktu (oddělovač ", ")
contact.utm_campaign	Seznam unikátních utm_campaign kontaktu (oddělovač ", ")
contact.utm_term	Seznam unikátních utm_term kontaktu (oddělovač ", ")
contact.utm_content	Seznam unikátních utm_content kontaktu (oddělovač ", ")
contact.field_<id>	Vlastní pole (popis níže)
datetime	Datum a čas v UTC ve formátu YYYY-MM-DD HH:mm:ss
contact.visit_source	Zdroj návštěvy

Vlastní pole

{contact.field_<id>}

Příklad {contact.field_123}

<id> - id pole, které lze získat v nastavení polí kontaktu (příklad https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Proměnné, které lze dodatečně použít v CTA

v parametrech
v odkazu přesměrování (pokud se nepoužívá přechod na platbu)

Proměnná	Hodnota
first_name	Jméno z žádosti
last_name	Příjmení z žádosti
middle_name	Prostřední jméno z žádosti
name	Celé jméno z žádosti
email	Email z žádosti
phone	Telefon z žádosti
field_<id>	Vlastní pole Telefon z žádosti (popis níže)
utm_source	utm_source - konkrétně té návštěvy, ze které byla podána žádost
utm_medium	utm_medium - konkrétně té návštěvy, ze které byla podána žádost
utm_campaign	utm_campaign - konkrétně té návštěvy, ze které byla podána žádost
utm_term	utm_term - konkrétně té návštěvy, ze které byla podána žádost
utm_content	utm_content - konkrétně té návštěvy, ze které byla podána žádost
widget_landing	Url vstupní stránky, ze které byla odeslána žádost
widget_landign_referer	Referer, který byl na vstupní stránce, když byla odeslána žádost
Také v určitých formulářích mohou být dostupné proměnné, popsané níže v Proměnných dostupných ve webhookách automatizace Podle objednávky ({order.}) - Pokud je vybrána varianta formuláře Přístup k produktu (Plný přístup/Podle nabídky) Podle produktu({product.}) - Pokud je vybrána varianta formuláře Přístup k produktu + Plný přístup Podle nabídky ({offer.*}) - Pokud je vybrána varianta formuláře Přístup k produktu + Podle nabídky

Vlastní pole

{field_<id>}

Příklad {contact.field_123}

<id> - id pole, které lze získat v nastavení polí kontaktu (příklad https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Pokud na stránce, kde je umístěn CTA nebo skript Kwiga pro sledování návštěv, byly návštěvy s utm značkami, a klient zanechal žádost na landing page již bez utm značek, pak v těchto proměnných budou chybět. Ale budou dostupné v proměnných {contact.utm_...}, které jsou popsány výše.

Proměnné dostupné ve webhooks automatizace (url, parametry, e-maily)