Magic editor - skriptování

Základy skriptování

Jak vložím skript do kampaně?

Jak obalím strukturu, nebo prvek skriptem?

Jak nastavím oslovení podle křestního jména?

Jak nastavím oslovení podle pohlaví?

Jak nastavím oslovení dle pohlaví rozšířené o titul a příjmení?

Jak nastavím oslovení podle příjmení uprostřed textu?

Jak nastavím "Vážený pane Nováku, Vážená paní Nováková"?

Jak nastavím "Milý Romane, Milá Jano"?

Jak nastavím "Dobrý den, Romane | Dobrý den, Jano, | Dobrý den,"?

Jak nastavím skloňování podle pohlaví (vybral, vybrala, vybrali)?

Jak na vykání / tykání?

Marketing je především o budování vztahů. A proto je vhodné, pokud je to možné, komunikovat se zákazníky personalizovaně, lidsky. V tomto směru vám může být neocenitelným pomocníkem skriptování, díky kterému dokážete přizpůsobit obsah daného prvku (a tím i celé kampaně) parametrům příjemce.  

Základy skriptování

Než začnete používat jednotlivé skripty, je určitě dobré si ukázat, jaká je jejich logika a jak se vlastně skládají jednotlivé části dohromady. Jako příklad poslouží skript, jehož cílem je, aby ověřil, zda má kontakt vyplněno pole oslovení a pokud tomu tak je, aby jej správně doplnil.

V první řadě je potřeba si uvědomit, že obsah umístěný mezi {% if ... %} a {% endif %} se vypíše do šablony, pouze pokud je splněna zadaná podmínka, kdežto text mimo skript je vypsán vždy. To znamená, že pokud splněna není, vypíše se pouze věta Dobrý den, jak se máte?

Rozeberme si vše ještě podrobněji:

Dobrý den, – Jak již bylo řečeno, tento text se vypíše vždy, ať je podmínka splněna nebo ne.

{% if df_salution %} – Každá podmínka vždycky začínána if. Část df_salution je název systémového pole pro oslovení (tato pole naleznete vypsána níže). Dohromady tedy tento zápis znamená, že podmínka bude vyhodnocovat, zda je toto pole u kontaktu vyplněno.

{{ df_salution }} , – Pokud tomu tak je, bude jeho obsah vypsán v tomto místě. Čárka je opět text, který bude vypsán vždy.

{% endif %} – Ukončení podmínky.

jak se máte? – Tento text už není součástí skriptu a bude proto vypsán vždy, ať je podmínka splněna nebo ne.

Pokud je tedy podmínka splněna, může zobrazené oslovení vypadat následovně:

Dobrý den, Karle, jak se máte? – Pro kontakt, který se jmenuje Karel.

Dobrý den, Jano, jak se máte? – Pro kontakt, který se jmenuje Jana.

V předchozím příkladu jste použili obsah již existujícího pole. Co když však chcete danou větu (a uvedený skript) ještě rozšířit o oslovení milý pane/milá paní, pro které žádné pole neexistuje? V takovém případě se budete řídit polem pohlaví, protože pouze na základě obsahu tohoto pole je možno stanovit, zda budete oslovovat muže nebo ženy. Samozřejmě i nyní musíte počítat s variantou, že dané pole neobsahuje žádný záznam a tomu větu přizpůsobit. 

Rozeberme si vše ještě podrobněji:

Dobrý den, – Tento text se vypíše vždy, ať je podmínka splněna nebo ne.

{% if df_gender == "M" %} – Každá podmínka vždycky začíná na if. Část df_gender je název systémového pole pro pohlaví (tato pole naleznete vypsána níže). Část ==“M“ pak určuje konkrétní hodnotu, kterou dané pole musí obsahovat, aby danou podmínku splnilo. Dohromady tedy tento zápis znamená, že podmínka bude vyhodnocovat, zda je toto pole u kontaktu vyplněno a zda obsahuje pohlaví muž (M).

milý pane – Pokud je podmínka splněna, následuje tento text…

{{ df_salution }} , – …a pozdrav, který bude vypsán v tomto místě.

Takto je skript čten v případě, že podmínku splňuje (tedy je jako pohlaví vyplněno muž). Jestliže však podmínku nesplňuje, je celá sekvence přeskočena a přechází se k sekvenci další.

{% elseif df_gender == "F" %} – Nyní podmínka začíná na elseif, protože ji ověřujeme pouze v případě, že není splněna podmínka předchozí. df_gender je opět název systémového pole pro pohlaví (tato pole naleznete vypsána níže). Část ==“F“ pak určuje konkrétní hodnotu, kterou dané pole musí obsahovat, aby danou podmínku splnilo. Dohromady tedy tento zápis znamená, že podmínka bude vyhodnocovat, zda je toto pole u kontaktu vyplněno a zda obsahuje pohlaví žena (F).

milá paní – Pokud je podmínka splněna, následuje tento text…

{{ df_salution }} , – …a pozdrav, který bude vypsán v tomto místě.

A pokud není splněna ani tato podmínka (kontakt nemá v poli pohlaví vyplněno nic), je opět zmíněná sekvence přeskočena.

{% else %} – V jiném případě

{% endif %} – Konec skriptu.

jak se máte? – Tento text už není součástí skriptu a bude proto vypsán vždy, ať je podmínka splněna nebo ne.

Výsledek tedy může vypadat následovně:

1) V případě, že má kontakt v systémovém poli uvedeno pohlaví muž a jméno Karel – Dobrý den, milý pane Karle, jak se máte?

2) V případě, že má kontakt v systémovém poli uvedeno pohlaví žena a jméno Jana – Dobrý den, milá paní Jano, jak se máte?

3) V případě, že nemá kontakt v systémovém poli uvedeno žádné pohlaví – Dobrý den, jak se máte?

Výchozí pole kontaktu

Vlastní pole kontaktu

Vlastní pole jsou dostupná v proměnných s názvy cf_IDPOLE. Vlastní pole ID 1 je dostupné jako cf_1, vlastní pole ID 321 je dostupné jakocf_321. Vlastní pole složená z několika hodnot (Seznam checkboxů) budou vypsána jako seznam všech hodnot oddělených čárkou.

Vložení skriptu do kampaně

Samotné vložení skriptu do kampaně může proběhnout v Magic editoru dvěma způsoby. Buď je možno vložit skript do prvku text jako jeho součást, nebo skriptem obalit celou strukturu (prvek).

Vložení skriptu jako textu

Pokud potřebujete pomocí skriptu modifikovat text, či vkládat do již vytvořeného textu obsahy polí kontaktu, využijete tuto možnost. Stačí tedy nejdříve do šablony vložit prvek text (1) a poté do něj potřebný skript (2).

V případě ukázkového skriptu dostanete tento výsledek:

Kontakt má uvedeno jako pohlaví muž a jmenuje se Roman. Pole oslovení tedy obsahuje tvar „Romane“. 

Kontakt má uvedeno jako pohlaví žena a jmenuje se Petra. Pole oslovení tedy obsahuje tvar „Petro“. 

Kontakt nemá uvedeno pohlaví a tedy ani oslovení. Jak však vidíte, pozdrav i tak dává smysl.

Skripty můžete samozřejmě kombinovat s dalším textem, je také možno mít v jednom textu i více skriptů najednou.

Obalení struktury (prvku) skriptem

Obecně lze pomocí skriptu ovlivnit, jaký obsah se bude kontaktu v kampani zobrazovat, na základě nastavených kritérií. To znamená, že nemusíte skriptování omezovat pouze na text, ale můžete měnit i zobrazování jiných prvků. Tato možnost může být zajímavá například tehdy, pokud chcete zobrazit jiný obsah pro muže (1), ženy (2) či kontakty bez uvedeného pohlaví (3), jako v následujícím příkladu.

Prvek obalíte skriptem tak, že na něj kliknete a na záložce Pokročilé nastavíte začátek skriptu a jeho konec.

U prvního obrázku je podmínkou, že se zobrazí pouze kontaktům, které mají nastaveno jako pohlaví Muž. Skript tedy bude nastaven jako na obrázku níže.

Začátek skriptu: {% if df_gender == "M" %}

Konec skriptu: prázdný

Pokud je podmínka splněna, zobrazí se obrázek určený mužům. Pokud ne, ověříte další možnost, kterou je pohlaví Žena. Kliknete tedy na obrázek určený ženám a opět jej na záložce Pokročilé obalíte skriptem.

Začátek skriptu: {% elseif df_gender == "F" %}

Konec skriptu: prázdný

Třetí možností je, že pohlaví není vůbec vyplněno. V takovém případě přichází na řadu obrázek s univerzální nabídkou, který opět obalíte skriptem.

Protože neexistuje žádná další možnost, kterou by pole Pohlaví mohlo obsahovat, skript na konci zakončíte.

Začátek skriptu: {% else %}

Konec skriptu: {% endif %}

Výsledný e-mail bude tedy po odeslání vypadat jinak pro Romana (muže)...

... jinak pro Petru (ženu)...

... a jinak pro kontakty bez uvedeného pohlaví.

Další příklady skriptování

Níže uvádíme další časté příklady práce se skripty při tvorbě kampaní.

Oslovení jménem

Vysvětlení: Krásný den, (pokud máme jméno, oslov jménem), pokud ne, oslov Krásný den,

Výsledek: Krásný den, Petro, Krásný den,

Oslovení dle pohlaví

Výsledek: Milý Petře. Milá Petro.

Oslovení dle pohlaví rozšířené o titul a příjmení

Vysvětlení:

Pokud chcete používat malé písmeno v oslovení vážená (např. uprostřed věty) je třeba skript upravit:

Výsledek:

Dobrý den, pane doktore Nováku, jak se máte?

Dobrý den, paní doktorko Nováková, jak se máte?

Oslovení podle příjmení uprostřed textu

Vysvětlení:

{{df_salutiongender|lower}} je oslovení podle příjemní s malým v ve slově vážený

{{df_salutionsurname}} je oslovení podle příjmení

Výsledek:

Děkujeme, vážený pane Nováku, za Váš zájem.

Děkujeme, vážená paní Nováková, za Váš zájem.

Rozšířené oslovení podle příjmení

Vysvětlení:

Pokud je muž, oslov Vážený pane, pokud je žena, oslov Vážená paní, pokud nemáme u kontaktu oslovení, oslov Vážení.

Výsledek:

Vážený pane Nováku, Vážená paní Nováková, Vážení

Vysvětlení:

Vážený pane + příjmení, Vážená paní + příjmení (v případě podmínky známého pohlaví a příjmení), neznámý/á - Vážení (v případě, že neznáme pohlaví nebo příjmení)

Výsledek: 

Vážený pane Nováku, Vážená paní Nováková, pakliže nemáme pohlaví nebo příjmení - Vážení, 

Milý + mužské jméno, Milá + ženské jméno, Dobrý den (v případě, že jméno uvedeno není)

Výsledek: Muž: Milý + jméno, žena: milá + jméno, neznámý/á - Dobrý den,  

Dobrý den + mužské jméno, dobrý den + ženské jméno, neznámý/á - Dobrý den,

Výsledek: Dobrý den, Karle, Dobrý den, Jano, Dobrý den,

Chcete-li mít text rozdělený podle muže/ženy/neuvedeno

Výsledek: Jsem ráda, že jste si vybral/ vybrala/vybrali moje služby.

Jak na tykání / vykání

Samozřejmě lze pomocí skriptování oddělit tykání a vykání konkrétní osobě. V takovém případě si vytvoříme vlastní pole (třeba rozbalovací nabídka), kde bude u kontaktu určeno, zda mu tykáme či vykáme. Následně pak snadno toto pole (v tomto příkladu ID 100) vložíme do skriptu.

Vlastní pole obsahuje Tykat: Zdravím Tě + jméno, Vykat: Zdravím Vás + jméno, Neobsahuje nic: Dobrý den + jméno,

V případě, že je text e-mailu obsáhlý a je v něm oslovení mnohokrát, lze také rozdělit kontakty do dvou seznamů (Tykat/Vykat) a vytvořit dvě rozdílné kampaně. K tomu můžete použít segmentaci nebo podmínku v Automatizaci.

Výsledek: Zdravím Tě Karle, (tykání) Zdravím Vás Jano, (vykání) Dobrý den Petře, (údaj chybí).