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 3 měsíci • 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.

7. V oznámeních

Při nastavování oznámení v automatizačních akcích umožňují proměnné dynamicky vkládat informace do oznámení, například jméno uživatele, číslo objednávky nebo název nabídky. To zjednodušuje a urychluje proces vytváření oznámení, činí je intuitivnějšími a přizpůsobivějšími pro různé scénáře.

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)