Po kliknutí na nod se zobrazí menu s několika položkami (v závislosti na konkrétním nodu).
- Upravit (Edit) - po kliknutí se zobrazí okno pro editaci nodu. Stejné okno se zobrazí po dvojitém kliknutí na nod jako takový.
- Smazat (Delete) - po kliknutí se zobrazí upozornění s dotazem, zda má být nod skutečně smazán. Pokud uživatel smazání potvrdí, je nod smazán.
- Kopírovat (Copy) - po kliknutí je nod zkopírován (včetně jeho nastavení)
- Zobrazit (View) - zobrazí vzorek dat, která jsou v nodu zpracovávána a počet příjemců, kteří:
- Jsou aktuálně zpracováváni
- Byli úspěšně zpracováni
- Nebyli zpracováni
- Spustit (Run) - spustí běh scénáře (zobrazuje se pouze u spouštěče “Now”)
V editoru je k dispozici několik kategorií nodů:
Trigger se nespustí zapnutím celého scénáře, nýbrž kliknutím na tlačítko “RUN”. Přepínač pro spuštění/zastavení scénáře v pozici (viz. obrázek níže) indikuje, že scénář byl spuštěn ručně, nikoli jinými spouštěči. Pro další editace je poté opět potřeba scénář “vypnout”.
Čas ukončení je vždy stejný jako čas zahájení, tzn. pokud je čas zahájení pondělí v 16:30 a den ukončení je pátek, bude v pátek scénář spuštěn také v 16:30.
V jednom nodu je možné naplánovat více jednorázových bezobslužných spuštění, tedy v různé dny i různé časy, nebo např. v různé časy v rámci jednoho dne.
Nod má několik režimů, které lze vybrat z nabídky pro “Run on Events”:
Subscribe to recipient list → když se příjemce přihlásí do vybraného seznamu příjemců, vstoupí do scénáře.
K tomu dochází pouze v případě, že se příjemce přihlásil prostřednictvím formuláře pro přihlášení k odběru nebo byl přidán prostřednictvím API volání mailkit.mailinglist.adduser.
Email read → když příjemce otevře e-mail z vybrané kampaně nebo rozesílky, vstoupí do scénáře. Příjemce může do scénáře vstoupit pouze jednou.
Pokud je vybrána jedna kampaň, je možné vybrat konkrétní rozesílku/rozesílky. Pokud je vybráno více kampaní, nelze již konkrétní rozesílky vybrat.
Poznámka: Pokud v účtu nejsou zatím žádné odeslané kampaně, nabídka pro výběr kampaní se nezobrazí.
Email click → když příjemce klikne na odkaz v e-mailu z vybrané kampaně nebo konkrétní rozesílky, vstoupí do scénáře. Příjemce může do scénáře vstoupit pouze jednou.
Pokud je vybrána jedna kampaň, je možné vybrat konkrétní rozesílku/rozesílky. Pokud je vybráno více kampaní, není výběr rozesílek k dispozici.
Hodnota vyplněná v poli “Link” je porovnávána s odkazy v rozesílce/rozesílkách jako string s operátorem “contains”, tzn. pokud chcete pracovat s konkrétním linkem, je potřeba vyplnit jeho celou URL - např. https://www.mailkit.com/cz/podpora/dokumentace/
Pokud byste do pole “Link” vyplnili hodnotu https://www.mailkit.com, bude scénář reagovat na prokliknutí kteréhokoli odkazu v e-mailu, který vedl na naše webové stránky.
Pokud do pole "Link" zadáte jako hodnotu *, bude scénář reagovat na prokliknutí kteréhokoli odkaz v odeslaném e-mailu.
Poznámka: Pokud v účtu nejsou zatím žádné odeslané kampaně, nabídka pro výběr kampaní se nezobrazí.
Operation Execute → v tomto režimu vstupují do scénáře příjemci z nodu Operace - Execute z jiného vybraného scénáře.
Event API → tento režim reaguje na eventy stejným způsobem, jako remarketingová kampaň. Může reagovat na dokončené nebo nedokončené eventy po nastaveném čase. Výstupem jsou data z eventu, která jsou v datových strukturách Event a EventItem a mohou být použita v šabloně stejně jako v remarketingové kampani.
API → příjemce bude vložen do scénáře API voláním mailkit.journeys.trigger.
Do pole „Event tag“ je potřeba vložit hodnotu parametru „event_tag“ z API volání. Vložení názvu tagu do pole “Event tag” je nutné potvrdit enterem. Do pole je možné vložit více štítků událostí.
Zdroje dat (SOURCES)
Tyto nody jsou nejčastěji používány pro vkládání příjemců do scénářů, ale umožňují také, aby data příjemců, kteří již scénářem procházejí, byla v daném bodě scénáře obohacena o data z různých zdrojů.
Obohacování dat
První zdroj v každém scénáři je tzv. primární zdroj, a všechny zdroje, které jej následují, obohacují data příjemců z primárního zdroje.
Výjimka: On Event spouštěč – protože je tento node také zdrojem dat příjemců (i přesto, že není v kategorii zdrojů), je považován za primární zdroj a každý následující zdroj jej obohacuje.
V případě několika po sobě jdoucích zdrojů, je ten primární vyznačen tmavým okrajem.
DELIVERY FEED (Zdroj doručování)
Tento nod vkládá do scénáře příjemce z delivery feedu nebo obohacuje data příjemců, kteří již scénářem procházejí.
SQL
Umožňuje přístup k datům v konkrétním SQL datovém zdroji. Po výběru SQL datového zdroje se zobrazí seznam jednotlivých sloupců, lze tedy vybrat sloupec, ve kterém je uložen e-mail.
Po výběru scénáře a nodu Operace-Collect v něm se vytvoří spojení a všichni příjemci z vybraného scénáře se přesunou do zdroje Collect v aktuálním (spravovaném) scénáři → tím dojde k vyprázdnění nodu Operace - Collect v propojeném scénáři.
Další příjemci přicházející do nodu Operace - Collect v propojeném scénáři budou okamžitě přesunuti do zdroje Collect v upravovaném scénáři.
EVENT
Tento zdroj obohacuje data příjemců daty z eventů - funguje stejně jako Events plug-in do šablon.
Musí jej předcházet node, který má jako výstup recipientská data (tedy buď zdroje, nebo On Event spouštěč), protože aby bylo možné vyhledat příslušný event, je třeba znát e-mailovou adresu.
Název – pojmenování nodu
URL – URL webhooku
HTTP metoda – lze vybrat jednu z následujících metod:
- GET (defaultní metoda)
- POST
- PUT
- DELETE
- PATCH
Autentifikace – pokud je potřeba volání zabezpečit/autentifikovat, zadejte uživatelské jméno a heslo
Parametry (pro metody POST/PUT/PATCH) – lze použít/předat proměnné ze scénářů, např.:
param1=[VAR recipient.city]¶m2=[VAR recipient.customs.custom_1]
Typ obsahu – lze vybrat jeden z daných typů:
- application/json
- application/xml
- application/x-www-form-urlencoded
- text/plain
Regulární výraz – v případě strukturovaných odpovědí ve formě JSON nebo XML je konverze jasná a struktura bude k dispozici beze změny. V případě ostatních odpovědí lze definovat regulární výraz pro zachycení konkrétních dat (není dostupné pro typy application/json a application/xml).
Název instance – pro snadnější vyhledání dat v datové struktuře můžete zadat název instance webhooku.Pokud název není zadán, bude instance označena pomocí hodnoty v poli actual_node v datech daného WEBHOOK nodu.
Data získaná z webhooku budou ve scénáři uložena do struktury scenario.webhooks, kterou následně můžete použít v šabloně vašeho e-mailu.
QUERY BUILDER
Tento nod umožňuje použít seznam příjemců a aplikovat na něj segmentační pravidla uložená ve 4. kroku při filtrování příjemců nebo v průběhu nastavování podmíněného doručení.
Název – pojmenování nodu
Seznam příjemců – vyberte seznam příjemců, na který mají být pravidla aplikována
Query – vyberte jedno z uložených pravidel, které bude aplikováno na výše vybraný seznam příjemců. Všechna uložená pravidla najdete v UI Mailkitu v menu Profil → Dotazy, kde můžete případně další pravidla přidávat, nebo stávající editovat či mazat.
Existují tři skupiny operátorů:
TEXT – pro operace s textovými hodnotami
- je stejné (equal)
- není stejné (not equal)
- začíná (begins with)
- nezačíná (doesn't begin with)
- končí (ends with)
- nekončí (not ends with)
- obsahuje (contains)
- neobsahuje (doesn't contain)
Příklad: recipient.city je stejné (equal) Červené Pečky -> budou vyhledány záznamy s hodnotou „Červené Pečky“, „Cervené Pecky“, „cervené pečky“, „ČERVENÉ Pečky“ a další
- je prázdné (is empty)
- není prázdné (is not empty)
- přesně odpovídá (exact match)
- přesně neodpovídá (not exact match)
Příklad: recipient.city přesně odpovídá (exact match) Červené Pečky -> budou vyhledány pouze záznamy s hodnotou „Červené Pečky“, nikoli záznamy „Cervené Pecky“, „cervené pečky“, „ČERVENÉ Pečky“ a další
ČÍSLO – pro operace s číselnými hodnotami
- = (rovná se/equal)
- != (nerovná se/not equal)
- < (menší/less) – POZOR, menší než jakékoli číslo je i prázdná hodnota
- <= (menší nebo rovno/less or equal) – POZOR, menší než jakékoli číslo je i prázdná hodnota
- > (větší/greater)
- >= (větší nebo rovno/greater or equal)
DATUM A ČAS – pro operace s časovými údaji
- je stejné (equal)
- není stejné (not equal)
- před (before) – vyhledá hodnoty s údajem menším (dřívějším) než je porovnávaná hodnota. POZOR, menší než jakýkoli časový údaj je i prázdná hodnota
- není před (not before) – vyhledá hodnoty s údajem, který je větší (pozdější) nebo roven porovnávané hodnotě
- po (after) – vyhledá hodnoty s údajem větším (pozdějším) než je porovnávaná hodnota.
- není po (not after) – vyhledá hodnoty s údajem, který je menší (dřívější) nebo roven porovnávané hodnotě. POZOR, menší než jakýkoli časový údaj je i prázdná hodnota
Při práci s časovými údaji (s použitím operátorů pro časové údaje) se porovnává pomocí intervalů (INTERVAL) - viz obrázek výše. Jako interval můžete použít hodnoty YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE a SECOND.
K filtrování nad hodnotou v poli (např. vlastní pole příjemce) můžete pracovat s hodnotami:
- [YEAR] – aktuální rok
- [MONTH] – aktuální měsíc
- [DAY] – aktuální den
- [HOUR], [MIN], [SEC] – hodina, minuta, vteřina
- [CURDATE] – aktuální datum (ve formátu YYYY-MM-DD, tedy např. 2025-10-20)
- [CURTIME] – aktuální čas (ve formátu HH:MM:SS, tedy např. 14:30:45)
- [NOW] – aktuální datum a čas (např. 2025-10-20 14:30:45)
- [DAYOFMONTH] – pořadí (číslo) dne v měsíci
- [DAYOFWEEK] – pořadí (číslo) dne v týdnu (0=pondělí, 6=neděle)
- [DAYOFYEAR] – pořadí (číslo) dne v roce
- [QUARTER] – pořadí (číslo) čtvrtletí v roce
- [WEEK] – pořadí (číslo) týdne v roce
- [MONTHNAME] – název měsíce v angličtině (January, February...)
- [DAYNAME] – název dne v angličtině (Monday, Tuesday...)
- [MONTHNAME_SHORT] – zkrácený název měsíce v angličtině (Jan, Feb...)
- [DAYNAME_SHORT] – zkrácený název dne v angličtině (Mon, Tue...)
-> na základě podmínky na obrázku výše budou vybráni příjemci, kteří mají ve vlastním poli předvčerejší datum (datum o 2 dny menší než je aktuální datum (CURDATE)). Je možné pracovat i s náhodným čísly, např:
"recipient.custom_field.custom_1" BEFORE "date_eu|[CURDATE] - INTERVAL [RAND 30] DAY"
-> na základě této podmínky bude porovnávána hodnota ve vlastním poli 1 (kde je datum uloženo ve formátu date_eu (DD.MM.YYYY) s aktuálním datem mínus náhodný počet dní (1-30)
Pro práci s časovými údaji je nutné, aby údaje v poli (např. vlastní pole) u příjemců byly v některém z podporovaných formátů:
- datetime – např. 2024-01-12 12:13:14 nebo 2024/01/12 12:13:14
- date_us – např. 2024-01-12 nebo 2024/01/12
- date_us_short – např. 24-01-12
- date_eu – např. 01.12.2024
- date_eu_short – např. 01.12.24
- date_eu_dm – např. 01.12.
- date – např. 2024-01-12 nebo 2024/01/12
- date_dm2 – např. 31/12
- date_md – např. 12/31
- time – např. 12:13:14 (je používán 24hodinový formát)
Proměnná může být buď vepsána ručně (při psaní se postupně nabízejí proměnné odpovídající zadávanému textu), nebo může být vybrána ze seznamu dostupných proměnných, které lze zobrazit tlačítkem 
TIP: V nodu CONDITION (Podmínka) můžete porovnávat i hodnoty příjemce v rámci jeho dat. Pokud byste např. chtěli vybrat příjemce, pro které platí, že hodnota ve vlastním poli 6 je větší než hodnota ve vlastní poli 7, pak bude podmínka vypadat takto:
recipient.custom_fields.custom_6 je větší (greater) [VAR recipient.custom_fields.custom_7]
Práce s poli
Zatímco při aplikaci podmínky na seznam příjemců (data o příjemcích) systém automaticky prochází všechny záznamy (příjemce) v seznamu příjemců, u SQL datových zdrojů či Eventových struktur je to trochu složitější.
Různým zápisem tak můžete různých výsledků:
Jednoduché pole ([*])
- např. Events[*].currency –> systém projde pole "currency" u všech událostí (Eventů)
Vnořená pole ([*]…[*])
- např. Events[*].EventItems[*].price –> systém projde všechny události (Eventy) a v nich ve všech položkách polem "price"
Indexovaná pole ([0])
- např. Events[0].currency –> systém projde pole "currency" u první ([0]) události (Eventu)
Příklad struktury události:
'Events' => [# 1 záznam v poli Events]
{
'first_name' => 'aaa',
'currency' => 'CZK',
'gender' => '',
'status' => 'finish',
'items_amount' => '200.0000',
'ID_workflow_event' => 11699290,
'email' => 'jiri+1@mailkit.eu',
'items_count' => 2,
'status_url' => '',
'decimal_separator' => '',
'description' => '',
'language' => 'en',
'promo' => '',
'promo_teaser' => '',
'order_no' => '',
'invoice_no' => '',
'modify_date' => '2025-07-23 09:55:04',
'invoice_url' => '',
'create_date' => '2025-07-23 09:55:04',
'promo_value' => '',
'event_tag' => 'kosik',
'return_url' => '',
'thank_you' => '',
'last_name' => 'kkk'
'EventItems' => [# 2 záznamy v poli EventItems]
{
'teaser' => '',
'item_available' => '',
'name' => '',
'date' => '2025-07-23 09:55:04',
'item_curr' => 'CZK',
'price' => '100.0000',
'product_id' => 'A001',
'product_category' => '',
'item_total' => '100.0000',
'product_cat_url' => '',
'product_url' => '',
'ID_workflow_event_item' => 62757504,
'item_qty' => '1.0000',
'description' => '',
'item_discount' => '',
'price_orig' => '0.0000',
'image_url' => ''
},
{
'product_id' => 'B001',
'price' => '100.0000',
'teaser' => '',
'item_curr' => 'CZK',
'date' => '2025-07-23 09:55:05',
'name' => '',
'item_available' => '',
'description' => '',
'item_qty' => '1.0000',
'image_url' => '',
'price_orig' => '0.0000',
'item_discount' => '',
'item_total' => '100.0000',
'product_category' => '',
'ID_workflow_event_item' => 62757505,
'product_url' => '',
'product_cat_url' => ''
}
],
}
],
Pro podmínkování nad událostmi pak můžete použít různé zápisy:
- Events[*].EventItems[*].price –> systém projde všechny události (Eventy) a v nich ve všech položkách polem "price"
- Events[0].EventItems[*].price –> systém projde 1. událost ([0]) a v ní všechny ([*]) položky EventItems.price
- Events[0].EventItems[0].price –> systém projde 1. událost ([0]) a v ní první ([0]) položku EventItems.price
Nod má 2 výstupy - TRUE (pravda) a FALSE (nepravda). První výstup vždy nese hodnotu TRUE. Pokud poté znovu kliknete ve výstupu z nodu, objeví se větev s hodnotu FALSE.
Další praktické tipy:
PŘÍJEMCE V E-MAILU KLIKNUL POUZE JEDNOU
Někdy může nastat situace, že budete chtít ošetřit, aby bylo vyhodnoceno pouze 1. kliknutí příjemce (např. v situaci, kdy pošlete e-mail se soutěžní otázkou a chcete, aby byla vyhodnocena pouze 1. odpověď příjemce)
Abyste mohli kliknutí vyhodnotit, musíte znát ID nodu s e-mailem, který byl příjemcům odeslán a ve kterém kliknutí sledujete –> to zjistíte kliknutím na „UKÁZAT“ u nodu EMAIL jako hodnotu parametru scenario – actual_node
Pak už stačí jen nastavit podmínku (CONDITION), ve které použijete proměnnou „scenario.click_XXXX“, kde XXXX je číslo nodu s e-mailem (viz výše)
• příjemci, kteří podmínku splní (je to jejich první kliknutí) pokračují do větve TRUE
• příjemci, kteří podmínku nesplňují (kliknuli víckrát) pokračují do větve FALSE a v našem případě scénář opouští
Základní rozdíl mezi podmínkou a A/B splitem je, že A/B split může mít několik výstupů, zatímco podmínka pouze dva. Příjemci v uzlu jsou rozděleni minimálně do 2 skupin, maximálně do 11 skupin (10 + kontrolní skupina). Každá skupina je procentem z celku, součet musí být vždy 100 %, jinak nelze nod uložit. Příjemci jsou do skupin rozdělování zcela náhodně.
Pokud uživatel potřebuje více limitů, může je řetězit jeden po druhém. Existují dva výstupy, pod limit (TRUE) a nad limit (FALSE).
Příklad: Pokud je limit nastaven na 100 příjemců za 1 hodinu, prvních 100 příjemců, kteří do nodu vstoupí, bude odesláno na podlimitní výstup (TRUE), všichni ostatní příjemci poté budou odesláni na nadlimitní výstup (FALSE). Po uplynutí 1 hodiny od příchodu prvního příjemce se limit vynuluje pro dalších 100 příjemců.
SET (Nastavit)
Nastavení atributů ve struktuře příjemce (jméno, příjmení, vlastní pole atd.) - jde o stejné atributy, se kterými se pracuje v 1. kroku podmíněného doručení/filtrování příjemců.
Pokud příjemce již nějakou hodnotu v atributu má, bude přepsána. V nodu vždy existuje alespoň jeden atribut, který bude nastaven, a nelze jej smazat.
Kromě konkrétních statických hodnot lze atributy nastavovat i pomocí proměnných:
Základní časové údaje:
- [YEAR] –> bude vložena hodnota odpovídající aktuálním roku (např. 2025)
- [MONTH] –> bude vložena hodnota (číslo) odpovídající aktuálnímu měsíci, tedy hodnoty 01 až 12
- [DAY] –> bude vložena hodnota (číslo) odpovídající aktuálnímu dni v měsíci, tedy hodnoty 01 až 31
- [HOUR] –> bude vložena hodnota (číslo) odpovídající aktuální hodině, tedy hodnoty 00 až 23
- [MIN] –> bude vložena hodnota (číslo) odpovídající aktuální minutě, tedy hodnoty 00 až 59
- [SEC] –> bude vložena hodnota (číslo) odpovídající aktuální vteřině, tedy hodnoty 00 až 59
Formátové údaje o datu a času:
- [CURDATE] –> bude vložena hodnota odpovídající aktuálnímu datu ve formátu YYYY‑MM‑DD (např. 2025‑10‑20)
- [CURTIME] –> bude vložena hodnota odpovídající aktuálnímu času ve formátu HH:MM:SS (např. 14:30:45)
- [NOW] –> bude vložena hodnota odpovídající aktuálnímu datu a času (např. 2025‑10‑20 14:30:45)
Rozšířené časové údaje:
- [DAYOFMONTH] –> bude vložena hodnota (číslo) odpovídající pořadí aktuálního dne v měsíci, tedy hodnoty 1 až 31
- [DAYOFWEEK] –> bude vložena hodnota (číslo) odpovídající pořadí aktuálního dne v týdnu (0=pondělí, 6=neděle)
- [DAYOFYEAR] –> bude vložena hodnota (číslo) odpovídající pořadí aktuálního dne v roce (1-365/366)
- [QUARTER] –> bude vložena hodnota (číslo) odpovídající pořadí aktuálního čtvrtletí v roce (1-4)
- [WEEK] –> bude vložena hodnota (číslo) odpovídající pořadí aktuálního týdne v roce (1-53)
Názvy dní a měsíců:
- [DAYNAME] –> bude vložen celý název (text) aktuálního dne v týdnu v angličtině (Monday, Tuesday...)
- [DAYNAME_SHORT] –> bude vložen zkrácený název (text) aktuálního dne v týdnu v angličtině (Mon, Tue...)
- [MONTHNAME] –> bude vložen celý název (text) aktuálního měsíce v angličtině (January, February...)
- [MONTHNAME_SHORT] –> bude vložen zkrácený název (text) aktuálního měsíce v angličtině (Jan, Feb...)
Náhodná hodnota:
- [RAND x] –> bude vloženo náhodné celé číslo s hodnotou 1 až x
Speciální operace s texty a čísly:
- [INCR x] –> zvýší existující hodnotu (číslo) o zadanou hodnotu x
- [APP text] –> připojí zadaný text k existující hodnotě (přidaný text bude oddělený mezerou)
–> např. díky zápisu [APP [DAY].[MONTH].[YEAR]] bude ke stávající hodnotě přidáno aktuální datum
- [CLEAR] –> smaže hodnotu (nastaví prázdný textový řetězec)
Je také možné použít hodnotu jednoho pole jako hodnotu pro jiné pole – např. pokud bychom třeba chtěli do CUSTOM7 nastavit hodnotu z pole pro Jméno (First Name), lze použít [VAR recipient.first_name] jako hodnotu.
Příjemci si uchovávají všechna data, která získali v aktuálním scénáři, takže je lze použít například v nodu CONDITION (Podmínka) v jiném (následujícím) scénáři. Nod EXECUTE nemá výstup, protože příjemci, kteří do něj vstupují, jsou přesunuti do jiného scénáře.
V jednom scénáři může být více těchto nodů, které shromažďují příjemce v různých okamžicích jejich průchodu scénářem. Příjemci zůstávají v nodu maximálně 6 měsíců – jsou tedy průběžně do nodu ukládáni, nebo z něj mazáni (po uplynutí 6 měsíců) –> to znamená, že každý příjemce bude mít nastavenou dobu a po uplynutí této doby bude z nodu odstraněn.
Výběrem tohoto nodu (dle jeho názvu) v nodu Zdroje dat - COLLECT v aktuálním, nebo jiném scénáři přesunete všechny dosud shromážděné příjemce do tohoto zdrojového nodu. Po propojení mezi zdrojovým nodem a operačním nodem se při každém spuštění scénáře přesunou všichni shromáždění příjemci z operačního nodu do zdrojového. Node COLLECT tedy nemá výstup.
Název – pojmenování nodu
Doba – čas, po který bude příjemce „čekat“ v nodu WAIT. Po uplynutí času příjemce pokračuje do dalšího (následujícího) nodu ve scénáři.
Ukončit při události – doba čekání v nodu může být zkrácena, pokud nastane některá z činností/událostí:
- Vypnuté –> doba čekání nebude zkrácena a všichni příjemci nod opustí až uplynutí nastaveného času.
- Přihlášení k odběru → pokud je u příjemce zaznamenán (nový) souhlas, pokračuje okamžitě do následujícího nodu
- Přečtení e-mailu → pokud příjemce otevře e-mail z vybrané kampaně, pokračuje okamžitě do následujícího nodu.
- Pokud je vybrána pouze jedna kampaň, je nutné vybrat konkrétní rozesílku/rozesílky, případně zvolit „Vybrat všechny zprávy“, pak budou zahrnuty i všechny budoucí rozesílky, které budou z vybrané kampaně odeslány po spuštění scénáře.
- Pokud je vybráno více kampaní, nelze již konkrétní rozesílky vybrat a budou zahrnuty všechny (i budoucí) rozesílky vybraných kampaní.
- Kliknutí v e-mailu → pokud příjemce klikne na odkaz v e-mailu z vybrané kampaně, pokračuje okamžitě do následujícího nodu.
- Odkaz (RegExp) = okno pro vložení linku nebo regulárního výrazu. Vyplněná hodnota je porovnávána s odkazy v rozesílce/rozesílkách jako string s operátorem „contains“, tzn. pokud chcete pracovat s konkrétním linkem, je potřeba vyplnit jeho celou URL - např. https://www.mailkit.com/cz/podpora/dokumentace/
- Pokud byste jako hodnotu vyplnili „https://www.mailkit.com“, bude scénář reagovat na prokliknutí kteréhokoli odkazu v e-mailu, který vedl na naše webové stránky.
- Pokud do pole zadáte jako hodnotu *, bude scénář reagovat na prokliknutí kteréhokoli odkaz v odeslaném e-mailu.
- Pokud je vybrána jedna kampaň, je možné vybrat konkrétní rozesílku/rozesílky, případně zvolit „Vybrat všechny zprávy“, pak budou zahrnuty i všechny budoucí rozesílky, které budou z vybrané kampaně odeslány po spuštění scénáře.
- Pokud je vybráno více kampaní, není výběr rozesílek k dispozici.
- Odkaz (RegExp) = okno pro vložení linku nebo regulárního výrazu. Vyplněná hodnota je porovnávána s odkazy v rozesílce/rozesílkách jako string s operátorem „contains“, tzn. pokud chcete pracovat s konkrétním linkem, je potřeba vyplnit jeho celou URL - např. https://www.mailkit.com/cz/podpora/dokumentace/
- API událostí → tento režim reaguje na eventy stejným způsobem, jako remarketingová kampaň. Pokud je tedy u příjemce, který čeká v nodu WAIT, zaznamenána vybraná událost, opustí WAIT nod před uplynutím nastavené doby. Systém může reagovat na dokončené nebo nedokončené eventy s vybraným štítkem (tagem) po nastaveném čase.
- API → čekání může být předčasně ukončeno API voláním mailkit.journeys.trigger. Vložení názvu tagu do pole “Štítek události” je nutné potvrdit enterem. Do pole je možné vložit více štítků událostí.
Pokud žádná z událostí/činností v průběhu stanovené „doby“ nenastane, příjemce pokračuje do následujícího nodu po jejím uplynutí.
REACTION
Vyhodnocuje reakce v e-mailové zprávě odeslané z předchozího/předchozích nodů EMAIL v daném scénáři (tzn. jednoho z EMAIL nodu, který nodu REACTION předchází).
Nod REACTION nemusí bezprostředně navazovat na nod EMAIL, například mezi nimi může být nod WAIT.
Název – pojmenování nodu
Read (ANO/NE) – po vybrání jednoho konkrétního nodu EMAIL z rolovací nabídky bude vyhodnoceno, zda příjemce e-mail četl, nebo ne.
Click – bude vyhodnocováno kliknutí v odeslaném e-mailu vybraném u položky “Read”
- ANO → můžete zadat konkrétní odkaz, nebo regulární výraz, který bude vyhodnocen. Hodnota je porovnávána s odkazy v odeslaném e-mailu jako string s operátorem „contains“, tzn.:
- pokud chcete pracovat s konkrétním linkem, je potřeba vyplnit jeho celou URL - např. https://www.mailkit.com/cz/podpora/dokumentace/,
- pokud byste vyplnili hodnotu https://www.mailkit.com, bude scénář vyhodnocovat prokliknutí kteréhokoli odkazu v e-mailu, který vedl na naše webové stránky
- pokud pole zůstane prázdné, bude systém reagovat na všechny odkazy v odeslaném e-mailu, tzn. pokud příjemce klikne na jakýkoli odkaz v definovaném odeslaném e-mailu, podmínku splní.
- NE → kliknutí v odeslaném e-mail nebude vyhodnocováno, tzn. je irelevantní, zda příjemce v odeslaném e-mailu kliknul, nebo nikoli.
Vyhodnocení podmínky pro „Click“ je aktivní pouze v případě, kdy je podmínka „Read“ nastavena na hodnotu „ANO“
Nod REACTION má podobně jako nod CONDITON (Podmínka) 2 výstupy - TRUE (pravda) a FALSE (nepravda). První výstup vždy nese hodnotu TRUE. Pokud poté znovu kliknete ve výstupu z nodu, objeví se větev s hodnotu FALSE.
Na rozdíl od SET nodu, který pouze nastavuje hodnoty, TRANSFORM nod aplikuje transformační funkce na existující data a ukládá výsledky do scénáře.
Výsledky transformace jsou uloženy ve větvi „transform“ a lze je také použít k úpravě dat ve větvi „recipient“ (v detailu příjemce – lze upravit standardní pole u příjemce kromě e-mailu a systémových údajů (ID email, ID recipient, consent_date a consent).
Název (Title) – pojmenování nodu
Transformace – vyberte typ/způsob transformace dat
Název (Name) – pojmenování hodnoty (výstupu) transformace ve větvi transform – pokud chcete např. výsledek transformace propsat jako hodnotu do šablony, použijte zápis [% scenario.transform.nazev %], kde nazev je pojmenování, které použijete v nastavení nodu.
Zdroj – výběr zdrojové proměnné pro transformaci
Cíl– název pole ve větvi transform, kam budou transformovaná data uložena
Další pole pro nastavení transformace se zobrazí v závislosti na vybraném typu/způsobu transformace
Seznam transformací
TEXTOVÉ TRANSFORMACE
uppercase – převede text na VELKÁ PÍSMENA
lowercase – převede text na malá písmena
capitalize – první písmeno velké, zbytek malá (pokud by text obsahoval více slov, bude po transformaci první písmeno prvního slova velké, všechna ostatní písmena (u všech dalších slov) budou malá)
title case – každé slovo začíná velkým písmenem
trim – odstraní mezery na začátku a na konci (pokud by text obsahoval více slov budou odstraněny pouze mezery před prvním a za posledním slovem, nikoli mezery mezi jednotlivými slovy)
ltrim – odstraní mezery vlevo (pokud by text obsahoval více slov budou odstraněny pouze mezery před prvním slovem)
rtrim – odstraní mezery vpravo (pokud by text obsahoval více slov budou odstraněny pouze mezery za posledním slovem)
reverse – obrátí pořadí znaků
length – vrátí délku řetězce
substr – extrahuje část řetězce
- Začátek – kolik znaků z řetězce (počítáno zleva) bude odstraněno, resp. za kterým znakem má extrakce začít (započítány jsou i mezery, včetně těch na začátku (před prvním slovem))
- Délka – počet znaků, které budou extrahovány, včetně mezer (jedná se o maximální počet znaků, které může funkce vrátit)
Příklad č. 1:
zdrojový řetězec = dokumentace
začátek = 4
délka = 5
–> výsledek transformace = menta
Příklad č. 2:
zdrojový řetězec = dokumentace
začátek = 9
délka = 5
–> výsledek transformace = ce (délka extrahovaného řetězce měla být 5 znaků, nicméně extrakce začala až po 9. znaku, tudíž zbyly už jen 2 znaky, a proto je výsledkem transformace pouze řetězec „ce“)
TEXTOVÉ OPERACE
replace – nahradí text
- Najít – řetězec, který má být vyhledán ve zdrojové proměnné (POZOR, při vyhledávání systém hledá pouze přesnou shodu, tzn. jsou rozlišována malá a velká písmena a je zohledňována diakritika –> pokud zadáte pro vyhledávání text „červená“, operace ve zdrojové proměnné nahradí pouze tento přesný text, naopak texty jako „cervena“ nebo „ČERVENÁ“ vyhledány a nahrazeny nebudou a jako výsledek operace bude uložena hodnota zdrojové proměnné)
- Nahradit – řetězec, kterým má být řetězec vyhledaný ve zdrojové proměnné nahrazen
split – rozdělí zdrojový text oddělovačem a jako výsledek operace vrátí hodnotu na konkrétní pozici
- Oddělovač – znak (mezera, čárka, středník nebo jakýkoliv jiný znak), v jehož místě bude zdrojový text „rozstřižen“.
- Pozice (index) – číselná hodnota (celé číslo větší nebo 0), určující konkrétní pozici ve zdrojovém textu vzhledem k oddělovači. Text před prvním oddělovačem má pozici (index) 0, text za prvním oddělovačem (a zároveň před druhým oddělovačem, pokud existuje) na pozici (index) 1, atd.
Příklad č. 1:
zdrojový řetězec = jan,novak,praha
oddělovač = , (čárka)
→ pozice (index) 0 = jan
→ pozice (index) 1 = novak
→ pozice (index) 2 = praha
Příklad č. 2:
zdrojový řetězec = Jan Novak Praha
oddělovač = $
→ pozice (index) 0 = Jan Novak Praha (znak $ se ve zdrojovém řetězci Jan Novak Praha vůbec nevyskytuje. Funkce split tedy nemá kde řetězec rozdělit a vrátí seznam s jediným prvkem – původním řetězcem. Index 0 pak vrátí právě ten první (a jediný) prvek)
→ pozice (index) 1 = prázdná hodnota (funkce split vrátí seznam s jediným prvkem (Jan Novak Praha), takže index 1 neexistuje (seznam má pouze index 0).
join – spojí prvky pole (seznamu) do jednoho textového řetězce, mezi jednotlivé prvky vloží zadaný oddělovač.
- Oddělovač – znak (pomlčka, čárka, mezera nebo jakýkoliv jiný znak), který se vloží mezi jednotlivé prvky při jejich spojování
Příklad č. 1:
zdrojové pole = ["jan", "novak", "praha"]
oddělovač = , (čárka)
→ výsledek = jan,novak,praha
Příklad č. 2:
zdrojové pole = [1, 2, 3, 4]
oddělovač = - (spojovník)
→ výsledek = 1-2-3-4
Příklad č. 3:
zdrojové pole = ["Jan"]
oddělovač = , (čárka)
→ výsledek = Jan (pole má jen jeden prvek, není co spojovat, takže se oddělovač nikde nepoužije)
Rozdíl oproti split: split rozstřihne text na jednotlivé kusy podle oddělovače, join je opačná operace – vezme již rozdělené kusy (pole) a slepí je zpátky do jednoho textu, přičemž oddělovač je ten znak, který se mezi jednotlivé kusy vloží.
pad left – přidání (doplnění zleva) jednoho nebo více (stejných) znaků na začátek textového řetězce (před 1. znak), dokud řetězec nedosáhne předem definované celkové délky
- Délka – definice celkové délky řetězce. Pokud je zdrojový řetězec kratší, než je definovaná délka, bude před něj přidán příslušný počet (stejných) znaků tak, aby řetězec dosáhl požadované délky. Pokud je zdrojový řetězec delší, než je požadovaná (definovaná) délka, nebude přidán žádný znak a výsledkem operace bude původní (zdrojová) hodnota.
- Znak – znak, který má být (opakovaně) přidán na začátek zdrojového řetězce (před 1. znak). Přidán může být jakýkoli znak včetně mezery.
Příklad č. 1:
zdrojový řetězec = Mailkit
délka = 10
znak = X
–> výsledek operace = XXXMailkit
Příklad č. 2:
zdrojový řetězec = Mailkit
délka = 5
znak = X
–> výsledek operace = Mailkit
Příklad č. 3:
zdrojový řetězec = (žádná hodnota/prázdné pole)
délka = 5
znak = X
–> výsledek operace = XXXXX
pad right – přidání (doplnění zprava) jednoho nebo více (stejných) znaků na konec textového řetězce (za poslední znak), dokud řetězec nedosáhne předem definované celkové délky
- Délka – definice celkové délky řetězce. Pokud je zdrojový řetězec kratší, než je definovaná délka, bude za něj (na jeho konec) přidán příslušný počet (stejných) znaků tak, aby řetězec dosáhl požadované délky. Pokud je zdrojový řetězec delší, než je požadovaná (definovaná) délka, nebude přidán žádný znak a výsledkem operace bude původní (zdrojová) hodnota.
- Znak – znak, který má být (opakovaně) přidán na konec zdrojového řetězce (za poslední znak). Přidán může být jakýkoli znak včetně mezery.
Příklad č. 1:
zdrojový řetězec = Mailkit
délka = 10
znak = X
–> výsledek operace = MailkitXXX
Příklad č. 2:
zdrojový řetězec = Mailkit
délka = 5
znak = X
–> výsledek operace = Mailkit
Příklad č. 3:
zdrojový řetězec = (žádná hodnota/prázdné pole)
délka = 5
znak = X
–> výsledek operace = XXXXX
HASH A KÓDOVÁNÍ
md5 – vrátí MD5 hash zdrojové proměnné
sha1 – vrátí SHA1 hash zdrojové proměnné
base64 encode – vrátí Base64-enkódovanou hodnotu zdrojové proměnné
base64 decode – vrátí Base64-dekódovanou hodnotu zdrojové proměnné
url encode – vrátí URL enkódovanou podobu zdrojové proměnné
url decode – vrátí URL dekódovanou podobu zdrojové proměnné
ČÍSELNÉ OPERACE
abs – vrátí absolutní hodnotu zdrojové proměnné.
→ pokud hodnota zdrojové proměnné = 2.2356, vrátí operace hodnotu 2.2356
→ pokud hodnota zdrojové proměnné = -2.2356, vrátí operace hodnotu 2.2356
→ pokud hodnota zdrojové proměnné = 2,2356, vrátí operace hodnotu 2
→ pokud hodnota zdrojové proměnné = -2,2356, vrátí operace hodnotu 2
→ pokud je hodnota zdrojové proměnné text, vrátí operace hodnotu 0
→ pokud zdrojová proměnná nemá žádnou hodnotu (pole je prázdné), vrátí operace hodnotu 0
round – zaokrouhluje číslo na zadaný počet desetinných míst. Pokud bude operace zaokrouhlovat např. na 3 desetinná místa, pak platí:
→ pokud hodnota zdrojové proměnné = 2, vrátí operace hodnotu 2.000
→ pokud hodnota zdrojové proměnné = -2, vrátí operace hodnotu -2.000
→ pokud hodnota zdrojové proměnné = 2.2356, vrátí operace hodnotu 2.236
→ pokud hodnota zdrojové proměnné = -2.2356, vrátí operace hodnotu -2.236
→ pokud hodnota zdrojové proměnné = 2,2356, vrátí operace hodnotu 2.000
→ pokud hodnota zdrojové proměnné = -2,2356, vrátí operace hodnotu -2.000
→ pokud je hodnota zdrojové proměnné text, vrátí operace hodnotu 0.000
→ pokud zdrojová proměnná nemá žádnou hodnotu (pole je prázdné), vrátí operace hodnotu 0.000
ceil – zaokrouhluje číslo nahoru na celá čísla
→ pokud hodnota zdrojové proměnné = 2, vrátí operace hodnotu 2
→ pokud hodnota zdrojové proměnné = -2, vrátí operace hodnotu -2
→ pokud hodnota zdrojové proměnné = 2.2356, vrátí operace hodnotu 3
→ pokud hodnota zdrojové proměnné = -2.2356, vrátí operace hodnotu -2
→ pokud hodnota zdrojové proměnné = 2,2356, vrátí operace hodnotu 2
→ pokud hodnota zdrojové proměnné = -2,2356, vrátí operace hodnotu -2
→ pokud je hodnota zdrojové proměnné text, vrátí operace hodnotu 0
→ pokud zdrojová proměnná nemá žádnou hodnotu (pole je prázdné), vrátí operace hodnotu 0
floor – zaokrouhluje číslo dolů na celá čísla
→ pokud hodnota zdrojové proměnné = 2, vrátí operace hodnotu 2
→ pokud hodnota zdrojové proměnné = -2, vrátí operace hodnotu -2
→ pokud hodnota zdrojové proměnné = 2.2356, vrátí operace hodnotu 2
→ pokud hodnota zdrojové proměnné = -2.2356, vrátí operace hodnotu -3
→ pokud hodnota zdrojové proměnné = 2,2356, vrátí operace hodnotu 2
→ pokud hodnota zdrojové proměnné = -2,2356, vrátí operace hodnotu -2
→ pokud je hodnota zdrojové proměnné text, vrátí operace hodnotu 0
→ pokud zdrojová proměnná nemá žádnou hodnotu (pole je prázdné), vrátí operace hodnotu 0
add – operace přičte nastavenou hodnotu. Lze přičítat i desetinná čísla. Pokud bude operace ke zdrojové proměnné přičítat např. hodnotu 2.56, pak platí:
→ pokud hodnota zdrojové proměnné = 2, vrátí operace hodnotu 4.56
→ pokud hodnota zdrojové proměnné = -2, vrátí operace hodnotu 0.56
→ pokud hodnota zdrojové proměnné = 2.2356, vrátí operace hodnotu 4.7956
→ pokud hodnota zdrojové proměnné = -2.2356, vrátí operace hodnotu 0.3244
→ pokud hodnota zdrojové proměnné = 2,2356, vrátí operace hodnotu 4.56
→ pokud hodnota zdrojové proměnné = -2,2356, vrátí operace hodnotu 0.56
→ pokud je hodnota zdrojové proměnné text, vrátí operace hodnotu 2.56
→ pokud zdrojová proměnná nemá žádnou hodnotu (pole je prázdné), vrátí operace hodnotu 2.56
subtract – operace odečte nastavenou hodnotu od zdrojové proměnné. Lze odčítat i desetinná čísla. Pokud bude operace od zdrojové proměnné odečítat např. hodnotu 2.55, pak platí:
→ pokud hodnota zdrojové proměnné = 2, vrátí operace hodnotu -0.55
→ pokud hodnota zdrojové proměnné = -2, vrátí operace hodnotu -4.55
→ pokud hodnota zdrojové proměnné = 2.2356, vrátí operace hodnotu -0.3144
→ pokud hodnota zdrojové proměnné = -2.2356, vrátí operace hodnotu -4.7856
→ pokud hodnota zdrojové proměnné = 2,2356, vrátí operace hodnotu -0.55
→ pokud hodnota zdrojové proměnné = -2,2356, vrátí operace hodnotu -4.55
→ pokud je hodnota zdrojové proměnné text, vrátí operace hodnotu -2.55
→ pokud zdrojová proměnná nemá žádnou hodnotu (pole je prázdné), vrátí operace hodnotu -2.55
multiply – operace vynásobí zdrojovou proměnnou nastavenou hodnotou. Lze násobit i desetinným číslem. Pokud bude operace zdrojovou proměnnou násobit např. hodnotou 2.55, pak platí:
→ pokud hodnota zdrojové proměnné = 2, vrátí operace hodnotu 5.1
→ pokud hodnota zdrojové proměnné = -2, vrátí operace hodnotu -5.1
→ pokud hodnota zdrojové proměnné = 2.2356, vrátí operace hodnotu 5.70078
→ pokud hodnota zdrojové proměnné = -2.2356, vrátí operace hodnotu -5.70078
→ pokud hodnota zdrojové proměnné = 2,2356, vrátí operace hodnotu 5.1
→ pokud hodnota zdrojové proměnné = -2,2356, vrátí operace hodnotu -5.1
→ pokud je hodnota zdrojové proměnné text, vrátí operace hodnotu 0
→ pokud zdrojová proměnná nemá žádnou hodnotu (pole je prázdné), vrátí operace hodnotu 0
divide – operace vydělí zdrojovou proměnnou nastavenou hodnotou. Lze dělit i desetinným číslem. Pokud bude operace zdrojovou proměnnou dělit např. hodnotou 2.5, pak platí:
→ pokud hodnota zdrojové proměnné = 2, vrátí operace hodnotu 0.8
→ pokud hodnota zdrojové proměnné = -2, vrátí operace hodnotu -0.8
→ pokud hodnota zdrojové proměnné = 2.2356, vrátí operace hodnotu 0.89424
→ pokud hodnota zdrojové proměnné = -2.2356, vrátí operace hodnotu -0.89424
→ pokud hodnota zdrojové proměnné = 2,2356, vrátí operace hodnotu 0.8
→ pokud hodnota zdrojové proměnné = -2,2356, vrátí operace hodnotu -0.8
→ pokud je hodnota zdrojové proměnné text, vrátí operace hodnotu 0
→ pokud zdrojová proměnná nemá žádnou hodnotu (pole je prázdné), vrátí operace hodnotu 0
modulo – vrací zbytek po celočíselném dělení dvou čísel. Pokud bude operace zdrojovou proměnnou dělit např. hodnotou 3, pak platí:
→ pokud hodnota zdrojové proměnné = 10, vrátí operace hodnotu 1
→ pokud hodnota zdrojové proměnné = -10, vrátí operace hodnotu 2
→ pokud hodnota zdrojové proměnné = 11.18, vrátí operace hodnotu 2
→ pokud hodnota zdrojové proměnné = -11.18, vrátí operace hodnotu 1
→ pokud hodnota zdrojové proměnné = 11,18, vrátí operace hodnotu 2
→ pokud hodnota zdrojové proměnné = -11,18, vrátí operace hodnotu 1
→ pokud je hodnota zdrojové proměnné text, vrátí operace hodnotu 0
→ pokud zdrojová proměnná nemá žádnou hodnotu (pole je prázdné), vrátí operace hodnotu 0
power – operace umocní zdrojovou proměnnou nastavenou hodnotou. Lze umocňovat i desetinným číslem. Pokud bude operace zdrojovou proměnnou umocňovat např. hodnotou 2, pak platí:
→ pokud hodnota zdrojové proměnné = 2, vrátí operace hodnotu 4
→ pokud hodnota zdrojové proměnné = -2, vrátí operace hodnotu 4
→ pokud hodnota zdrojové proměnné = 2.2356, vrátí operace hodnotu 4.99790736
→ pokud hodnota zdrojové proměnné = -2.2356, vrátí operace hodnotu 4.99790736
→ pokud hodnota zdrojové proměnné = 2,2356, vrátí operace hodnotu 4
→ pokud hodnota zdrojové proměnné = -2,2356, vrátí operace hodnotu 4
→ pokud je hodnota zdrojové proměnné text, vrátí operace hodnotu 0
→ pokud zdrojová proměnná nemá žádnou hodnotu (pole je prázdné), vrátí operace hodnotu 0
DATUM A ČAS
format date – převede časové razítko (UNIX timestamp – tj. počet vteřin od 1970) na požadovaný formát data (a času)
Příklad:
zdrojový řetězec = 1685439686
formát data: výstupní formát transformace: např. %Y-%m-%d (standardní zástupné znaky pro formátování najdete ZDE)
Výsledek transformace –> 2023-05-30
parse timestamp – inverzní operace k format date –> převede zdrojovou hodnotu (datum/čas) na UNIX timestamp (počet vteřin od 1970)
Příklad:
zdrojový řetězec = 2023-05-30 11:41:26
formát data/čas ve zdrojovém řetězci: %Y-%m-%d %H:%M:%S (standardní zástupné znaky pro formátování najdete ZDE)
Výsledek transformace –> 1685439686
OPERACE S POLEM
array unique – odstraní z pole (seznamu) duplicitní hodnoty a vrátí nové pole, ve kterém se každá hodnota vyskytuje pouze jednou.
- Zdroj – pole (seznam) hodnot, ze kterého se mají odstranit duplicity.
- Jméno proměnné – název, pod kterým se výsledné (očištěné) pole uloží pro další použití.
Příklad č. 1:
zdrojové pole = ["jablko", "hruška", "jablko", "banán", "hruška"]
→ výsledek = ["jablko", "hruška", "banán"]
Příklad č. 2:
zdrojové pole = [1, 2, 2, 3, 4, 4, 4]
→ výsledek = [1, 2, 3, 4]
Příklad č. 3:
zdrojové pole = ["auto", "dům", "kolo", "strom"]
→ výsledek = ["auto", "dům", "kolo", "strom"] (pole neobsahuje žádné duplicitní hodnoty, takže se nic neodstraní a výsledek je stejný jako zdroj)
array sort – seřadí prvky pole (seznamu) a vrátí nové, seřazené pole.
- Zdroj – pole (seznam) hodnot, které se mají seřadit (vzestupně)
- Jméno proměnné – název, pod kterým se výsledné pole uloží pro další použití.
- Řadit jako
- Text – pokud zdroj obsahuje textové i číselné hodnoty, textové hodnoty bude seřazeny jako první a teprve poté budou následovat čísla. S čísly se bude pracovat jako s textem, tzn. pokud zdrojové pole obsahuje hodnoty 1,24,11,3,2 budou seřazeny jako text, tj. 1,11,2,24,3 (pokud budou řazeny vzestupně).
- Čísla – pokud zdroj obsahuje textové i číselné hodnoty, budou nejdříve seřazeny číselné hodnoty a až poté textové. S čísly se bude pracovat jako s čísly, tzn. pokud zdrojové pole obsahuje hodnoty 1,24,11,3,2 budou seřazeny jako čísla, tj. 1,2,3,11,24 (pokud budou řazeny vzestupně).
- Pořadí
- Vzestupně (od nejmenšího po největší, resp. od A do Z)
- Sestupně (od největšího po nejmenší, resp. od Z do A)
Příklad č. 1 (čísla, vzestupně):
zdrojové pole = [5, 2, 8, 1, 4]
→ výsledek = [1, 2, 4, 5, 8]
Příklad č. 2 (text, vzestupně (abecedně)):
zdrojové pole = ["banán", "chléb", "jablko", "hruška", "citron", "cukr", "houska", "banán"]
→ výsledek =["banán", "banán", "citron", "cukr", "houska", "hruška", "chléb", "jablko"]
Příklad č. 3:
zdrojové pole: [1,"auto",11,5,2,22,"kolo","autíčko","noha"19,"auticko","bicykl","zebra",13]
→ výsledek
- Text, vzestupně = ['auticko','autíčko','auto','bicykl','kolo','noha','zebra',1,11,13,19,2,22,5]
- Text, sestupně = ['zebra','noha','kolo','bicykl','auto','autíčko','auticko',5,22,2,19,13,11,1]
- Čísla, vzestupně = [1,2,5,11,13,19,22,'auticko','autíčko','auto','bicykl','kolo','noha','zebra']
- Čísla, sestupně = [22,19,13,11,5,2,1,'zebra','noha','kolo','bicykl','auto','autíčko','auticko']
array reverse – obrátí pořadí prvků v poli (seznamu), tedy poslední prvek se stane prvním, předposlední druhým atd., a vrátí nové pole s obráceným pořadím.
- Zdroj – pole (seznam) hodnot, jehož pořadí se má obrátit
- Jméno proměnné – název, pod kterým se výsledné (obrácené) pole uloží pro další použití.
Příklad č. 1:
zdrojové pole = [1, 2, 3, 4, 5]
→ výsledek = [5, 4, 3, 2, 1]
Příklad 2:
zdrojové pole =["podzim", "jaro", "zima", "léto"]
→ výsledek = ["léto", "zima", "jaro", "podzim"]
Příklad č. 3 (mix textu a čísel, s opakovaným prvkem):
zdrojové pole = ["auto", 3, "dům", "dům", 7]
→ výsledek = [7, "dům", "dům", 3, "auto"]
Rozdíl oproti array sort: array sort seřadí prvky podle jejich hodnoty (např. abecedně nebo číselně), kdežto array reverse pořadí prvků nijak nehodnotí – jen ho otočí přesně naopak, bez ohledu na to, jaké hodnoty prvky mají.
array count – zjistí, kolik prvků (elementů) pole (seznam) obsahuje, a vrátí toto číslo jako výsledek
- Zdroj – pole (seznam) hodnot
- Jméno proměnné – název, pod kterým se výsledek uloží pro další použití.
Příklad č. 1:
zdrojové pole = [4, 9, 2, 7, 5]
→ výsledek = 5
Příklad č. 2:
zdrojové pole = ["auto", "dům", "kolo"]
→ výsledek = 3
Příklad 3 (mix textu a čísel s opakovaným prvkem):
zdrojové pole = ["jablko", 3, "jablko", 8]
→ výsledek = 4
array first – vrátí první prvek (element) pole (seznamu), tedy ten, který má index (pozici) 0.
- Zdroj – pole (seznam) hodnot
- Jméno proměnné – název, pod kterým se výsledek uloží pro další použití.
Příklad č. 1:
zdrojové pole = [4, 9, 2, 7, 5]
→ výsledek = 4
Příklad č. 2:
zdrojové pole = ["auto", "dům", "kolo"]
→ výsledek = auto
Příklad č. 3 (mix textu a čísel s opakovaným prvkem):
zdrojové pole = ["jablko", 3, "jablko", 8]
→ výsledek = jablko
array last – vrátí poslední prvek (element) pole (seznamu), tedy ten, který má nejvyšší index (poslední pozici v pořadí).
- Zdroj – pole (seznam) hodnot, z něhož se má vzít poslední prvek.
- Jméno proměnné – název, pod kterým se výsledná hodnota (poslední prvek) uloží pro další použití.
Příklad č. 1:
zdrojové pole = [4, 9, 2, 7, 5]
→ výsledek = 5
Příklad č. 2:
zdrojové pole = ["auto", "dům", "kolo"]
→ výsledek = kolo
Příklad č. 3 (mix textu a čísel s opakovaným prvkem):
zdrojové pole = ["jablko", 3, "jablko", 8]
→ výsledek = 8
array slice – extrahuje (vyjme) z pole (seznamu) jeho určitou část, a to podle zadané počáteční pozice a délky, a vrátí novou, kratší část pole.
- Zdroj – pole (seznam) hodnot, z něhož má být část extrahována
- Jméno proměnné – název, pod kterým se výsledná hodnota uloží pro další použití.
- Začátek – kolik pozic z pole bude odstraněno, resp. za kterou pozicí má extrakce začít (číselná hodnota (celé číslo, 0 nebo větší), určující pozici (index), od které se má výřez pole začít. Stejně jako u split, první prvek pole má pozici (index) 0.
- Délka – číselná hodnota, určující počet prvků, které se mají od pozice start vzít do výsledného výřezu.
Příklad č. 1:
zdrojové pole = [10, 20, 30, 40, 50]
začátek = 1
délka = 3
→ výsledek = [20, 30, 40]
Příklad č. 2:
zdrojové pole = ["auto", "dům", "kolo", "strom", "lampa"]
začátek = 0
délka = 2
→ výsledek = ["auto", "dům"]
Příklad č. 3:
zdrojové pole = ["jaro", "léto", "podzim", "zima"]
začátek = 2
délka = 5
→ výsledek = ["podzim", "zima"] (od pozice 2 zbývají v poli jen dva prvky, takže i když délka žádá 5, vrátí se jen to, co v poli reálně existuje)
PODMÍNĚNÉ TRANSFORMACE
default – nastaví výchozí (defaultní) hodnotu pro zdrojové proměnné, které jsou prázdné. Pro zdrojové proměnné s jakoukoli hodnotou (hodnotu je i „mezera“) vrátí operace zdrojovou hodnotu (v případě „mezery“ jako zdrojové proměnné vrátí také „mezeru“)
- Hodnota – hodnota, která bude výsledkem transformace u prázdných zdrojových proměnných
if empty/if null – nahrazuje prázdné hodnoty
- Hodnota – hodnota, kterou budou nahrazeny prázdné hodnoty
„prázdné" pole může znamenat dvě různé věci:
- Pole tam vůbec není (klíč chybí, nikdo ho nikdy nevyplnil)
- Pole tam je, ale je prázdné (obsahuje "")
–> default – default doplní „hodnotu“ v obou případech
–> if empty – zafunguje úplně stejně jako default
–> if null – zafunguje jen v případě, kdy žádné pole neexistuje. Prázdné pole (obsahuje "") nechá prázdné.
Příklad:
Když prázdno (obsahuje "") je legitimní odpověď, kterou nechcete přepsat – např. pole „poznámka k objednávce":
–> zákazník napsal poznámku → chcete znát její text
–> zákazník ji nechal prázdnou → to je platná informace, žádnou poznámku nemá → chcete nechat prázdno
–> pole vůbec nepřišlo (rozbitý feed, chybějící klíč v API) → tady chcete informaci, že chybí data
(default by dva poslední případy posoudil stejně a nerozeznali byste tak situace, kdy „zákazník nic nenapsal“ od „feed je rozbitý“.
DATOVÉ TYPY
string (řetězec) – text, posloupnost znak. Vždy je v uvozovkách.
number (číslo) – číselná hodnota, se kterou se dá počítat (sčítat, násobit,...).
boolean (logická hodnota) – může nabývat pouze hodnoty: true (pravda) nebo false (nepravda)
json (JavaScript Object Notation) – strukturovaný formát používaný na seskupování dat dohromady (objekty a pole), který je složený ze stringů, čísel, boolean hodnot a dalších objektů/polí.
to string – převede hodnotu zdrojové proměnné na textový řetězec (string)
to number – převede zdrojovou proměnnou na číslo
→ pokud hodnota zdrojové proměnné = 2,2356, vrátí operace hodnotu 2
→ pokud hodnota zdrojové proměnné = -2,2356, vrátí operace hodnotu -2
→ pokud je hodnota zdrojové proměnné text, vrátí operace hodnotu 0
→ pokud zdrojová proměnná nemá žádnou hodnotu (pole je prázdné), vrátí operace hodnotu 0
to boolean – převést na boolean hodnoty:
–> pokud je pole prázdné, vrátí 0
–> pokud pole NENÍ prázdné, vrátí 1
to json – převede zdrojovou hodnotu (proměnnou, pole nebo i celý objekt) na text ve formátu JSON, tedy do standardizovaného textového zápisu, který lze snadno přenášet nebo dále zpracovávat.
Příklad č. 1 (pole):
zdrojová hodnota = ["jablko", "hruška", "banán"]
→ výsledek = ["jablko","hruška","banán"] (jako text)
Příklad č. 2 (jednoduchá hodnota):
zdrojová hodnota = 42
→ výsledek = 42 (jako text)
Příklad č. 3 (objekt s klíči a hodnotami):
zdrojová hodnota = jméno = "Jan", věk = 30
→ výsledek = {"jméno":"Jan","věk":30} (jako text)
Rozdíl oproti to string: to string převede na text jen jednotlivou hodnotu, kdežto to json umí serializovat i složitější struktury (pole, objekty s více klíči a hodnotami) do jednoho přesně definovaného textového formátu, který si zachovává strukturu původních dat.
from json – provede deserializaci z JSONu
zdrojová hodnota = text obsahující platný JSON string.
→ výsledek = textový řetězec v JSON formátu převede zpětna skutočnou datovou strukturu (objekt/pole), s kterou je dále možné pracovat.
Příklad:
zdrojová hodnota = '{"jmeno":"Ján","vek":30}' → objekt { jmeno: "Ján", vek: 30 }
→ výsledek = struktura, kde jméno = "Jan" a věk = 30 (dá se pak adresovat např. vysledek.jmeno)
to xml/from xml – obdobně jako to json/from json, s tím rozdílem, že tyto transformace pracují s XML formátem
GENERÁTORY
generate uuid – generuje UUID (univerzálně unikátní identifikátor) ve verzi 1, která vychází z času + MAC adresy serveru, ve formátu:
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
kde X jsou písmena a číslice, např.:
550e8400-e29b-11d4-a716-446655440000
→ 32 hex znaků rozdělených pomlčkami do skupin 8-4-4-4-12, tzn. celkem 36 znaků včetně pomlček
generate random string – generuje náhodný textový řetězec
- Délka – počet znaků v generovaném řetězci (maximální hodnota je 100, pokud zadáte hodnotu vyšší bude řetězec automaticky zkrácen na 100 znaků)
- Sada znaků – zde můžete zadat sadu znaků, které se mají pro generování textového řetězce použít:
- pokud zadáte např.: ABC123, vygeneruje se náhodný textový řetězec o stanovené délce, který bude složen pouze z těchto znaků (v různém pořadí, znaky se samozřejmě mohou opakovat)
- pokud pole necháte prázdné, použije se defaultní nastavení a budou použita velká a malá písmena bez diakritiky a číslice, tzn. A-Z, a-z a 0-9.
generate random number – generuje náhodné celé číslo v nastaveném rozsahu hodnot. Lze zadat hodnoty od 0 do 1015, záporné hodnoty nejsou podporovány.
- Min – minimální hodnota
- Max – maximální hodnota
Odešle vybranou e-mailovou kampaň. Aby bylo možné kampaň ve scénáři použít, musí být v pokročilém nastavení kampaně povolen scénářový režim.
Kampaň s nastaveným scénářovým režimem není možné poslat jinak než ze scénáře.
Před samotným odesláním je třeba příjemce uložit/aktualizovat o údaje ze scénáře. Proto je potřeba vybrat seznam příjemců. Pokud má příjemce zůstat na stejném seznamu, ze kterého do scénáře přišel, vyberte první položku „* Recipient origin“.
SMS
Odešle vybranou SMS kampaň. Aby bylo možné kampaň ve scénáři použít, musí být v pokročilém nastavení kampaně povolen scénářový režim.
Před samotným odesláním je třeba příjemce uložit/aktualizovat o údaje ze scénáře. Proto je potřeba vybrat seznam příjemců. Pokud má příjemce zůstat na stejném seznamu, ze kterého do scénáře přišel, vyberte první položku „* Recipient origin“.
Nod MANAGE má několik režimů, které lze vybrat z rozbalovací nabídky:
Vložit (Insert) —> příjemci, kteří dosáhnou tohoto nodu, budou vloženi do vybraného seznamu příjemců.
Přesunout (Move) —> v tomto režimu bude příjemce přesouván z jednoho seznamu příjemců do druhého.
Pokud je vybráno „* Recipient origin“, bude příjemce přesunut ze seznamu, ve kterém se aktuálně nacházel, do vybraného seznamu.
Smazat (Delete) —> příjemce bude odstraněn z vybraného seznamu. Pokud je vybrán „* Recipient origin“, bude příjemce odstraněn ze seznamu, ve kterém se aktuálně nacházel.
Odhlásit (Unsubscribe) —> příjemce bude odhlášen
