PodporaZnalostní báze

Datové zdroje

Jednou z nejvýkonnějších vlastností platformy Mailkit je podpora pro externí datové zdroje. Datové zdroje mohou pomoci automatizovat mnoho různých činností - od aktualizací seznamu příjemců, získávání dynamického obsahu, načítání produktových informací až po řízení rozesílek.

data_sources-en.pngAbyste mohli začít automaticky aktualizovat vaše seznamy příjemců a obsah vašich kampaní, je nutné nejprve nastavit vaše datové zdroje. Mailkit v současné době podporuje datové zdroje ve formátech XML, RSS, JSON a CSV. Některé formáty všach mají omezené využití, např. formát RSS může být využit pouze pro získávání obsahu do šablony, zatím co CSV pouze pro aktualizaci seznamu příjemců. Datové zdroje ve formátu XML jsou nejuniverzálnější a mohou být použity jak pro aktualizaci seznamu příjemců, předávání obsahu do šablon, plnění SQL databáze produkty nebo řízení rozesílky.

Správa datových zdrojů se nalézá v hlavním menu Profil / Datové zdroje, kde naleznete jednotlivé datové zdroje rozdelěné do skupin Aktivní (aktivně užívané), Nepoužito (zdroje, které se delší dobu nepoužili) a Všechny.

Použití datových zdrojů k aktualizaci seznamu příjemců

Nový seznam příjemců můžete snadno vytvořit (nebo aktualizovat existující seznam) pomocí datového zdroje ve formátu XML, JSON nebo CSV. Výrazně doporučujeme dát přednost formátům XML a JSON před CSV, neboť první dva jsou tzv. strukturované formáty a tak jsou méně náchylné k chybám, zatím co drobná změna v souboru CSV může vést k nekonzistentním datům a promíchání údajů.

create_ds.pngZačněte kliknutím na tlačítko Přidat datový zdroj a zobrazí se vám dialogové okno, jehož obsah se bude průběžně aktualizovat tak, jak budete vybírat jednotlivá nastavení.

  • Název - název datového zdroje. Pokud bude datový zdroj sloužit pro seznam příjemců, dostane seznam příjemců shodné jméno. V případě, že datový zdroje bude sloužit pro získávání obsahu, pak tento název bude použit pro adresování zdroje v šablonách.
  • Popis - popis datového zdroje.
  • Zdroj - URL adresa, na které se nalézá XML, či RSS, jež má sloužit jako datový zdroj. Výrazně doporučujeme, abyste brali v potaz i bezpečnost datového zdroje a zajistili, že nebude přístupný neautorizovaným osobám a používal šifrování pomocí protokolu https kdykoliv se jedná o zdroj, který může obsahovat citlivé údaje.
  • Typ - typ datového zdroje. Možnosti jsou CSV, RSS, XML, SQL a JSON. Na základě této volby se vám následně zobrazí další možnosti nastavení.
  • Cíl (dostupné pouze pro XML zdroje) - umožňuje vybrat jakým způsobem budou data použita. Možnosti jsou Šablona, Seznam příjemců a Rozesílka.
  • Seznam příjemců (dostupné pouze pro zdroje seznamu příjemců CSV,JSON, XML) - umožňuje vám vybrat seznam příjemců, který bude aktualizován, případně založit nový seznam.
  • Autorizace - zaškrtněte v případě, že přístup k datovému zdroji vyžaduje autorizaci jménem a heslem.
  • Plánovaná aktualizace - umožňuje nastavit časový plán aktualizace datového zdroje. Nezapomeňte, že nestačí aby systém prováděl aktualizaci, ale je nezbytné aby i samotná data byla se stejnou (nebo vyšší) frekvencí aktualizována.
  • Automaticky aktualizovat - zvolte, pokud chcete aby došlo k aktualizaci před odesláním kampaně. Nezapomeňte však, že aktualizace opozdí samotné rozesílání kampaně o čas nezbytný ke zpracování datového zdroje.
  • Poslední aktualizace - informace o datu poslední aktualizace datového zdroje.

Nastavení vašeho datového zdroje budou uložena kliknutím na tlačítko Uložit. Datový zdroj pak bude připraven k dalšímu kroku - v případě datového zdroje pro seznam příjemců je potřeba nastavit přiřazení jednotlivých polí z datového zdroje k záznamům příjemce.

Jak připravit datový zdroj

Datový zdroj nemá pevně definovanou strukturu ale musí doržovat základní pravidla. Datové zdroje seznamu příjemců mohou být ve strukturovaných formátech XML a JSON, nebo nestrukturovaném CSV. Datové zdroje musí být v kódování UTF8 a zcela validní v souladu s odpovídajícím standardem - upozorňujeme na nutnost ošetřit správně zakodování znaků jako &, <, >, diakritiky a speciálních znaků. V případě formátu CSV pak je nutná velká opatrnost, neboť se jedná o nestrukturovaný formát ve kterém snadno může dojít k přidání,záměně či posunu sloupců a systém tuto změnu nebude schopen poznat.

Soubor datového zdroje musí být vystaven na URL dostupné ze serverů Mailkitu a zabezpečen proti přístupu třetích stran neboť se jedná o citlivé údaje. Zabezpečení je možné realizovat buď pomocí omezení přístupu pouze z IP adres Mailkitu (síť 185.136.200.0/22), nebo HTTP autentifikací pomocí jména a hesla.

Protože každý klient využívá jiný informační systém s jinými možnostmi, systém datových zdrojů je postaven maximálně univerzálně a nepředepisuje specificky strukturu požadovaných dat. Necháváme tedy na klientech jak pojmenují jednotlivé větve struktury a ty následně napárují k polím příjemce dle vlastních potřeb. Na datové zdroje se však vztahují jistá technická omezení:

  1. Plně validní XML, JSON nebo CSV
  2. V XML formátu nejsou podporovány attributy (např. first_name="Jana" gender="f" country="cz")
  3. Doporučené kódování znaků UTF8
  4. Nepoužívat znak "," jako oddělovač pro více hodnot, ale použít znak "|"
  5. Unikátním identifikátorem záznamu a zároveň jediným povinným polem je e-mailová adresa. Pokud bude více záznamů s totožnou e-mailovou adresou dojde k jejich vzájemnému přepsání
Pro jednodušší přípravu vašeho datového zdroje, jsme připravili orientační ukázky datových zdrojů a základních údajů obvyklých v oblasti e-commerce.

XML

<?xml version="1.0" encoding="utf-8"?>
<contacts>
  <contact>
    <email>email@sample.com</email>
    <client_id>ID</client_id>
    <first_name>Jméno</first_name>
    <last_name>Příjmení</last_name>
    <gender>m</gender>
    <mobile>+420xxxyyyzzz</mobile>
    <street>Ulice</street>
    <city>Město</city>
    <zip>12345</zip>
    <state>Kraj</state>
    <country>Země</country>
    <birthdate>DD.MM.RRRR</birthdate>
    <reg_date>DD.MM.RRRR</reg_date>
    <first_sale>DD.MM.RRRR</first_sale>
    <last_sale>DD.MM.RRRR</last_sale>
    <last_active>DD.MM.RRRR</last_active>
    <top_category>|ID|ID|ID|</top_category>
    <top_brands>|ID|ID|ID|</top_brands>
    <top_products>|ID|ID|ID|</top_products>
    <bonus_points>123</bonus_points>
  </contact>
</contacts>

JSON

[
	{
		"email":"email@sample.com",
		"client_id":"ID",
		"first_name":"Jméno",
		"last_name":"Příjmení",
		"gender":"m",
		"mobile":"+420xxxyyyzzz",
		"street":"Ulice",
		"city":"Město",
		"zip":"12345",
		"state":"Kraj",
		"country":"Země",
		"birthdate":"DD.MM.RRRR",
		"reg_date":"DD.MM.RRRR",
		"first_sale":"DD.MM.RRRR",
		"last_sale":"DD.MM.RRRR",
		"last_active":"DD.MM.RRRR",
		"top_category":"|ID|ID|ID|",
		"top_brands":"|ID|ID|ID|",
		"top_products":"|ID|ID|ID|",
		"bonus_points":"123"
	}
]
Jak již bylo napsáno, jediným povinným údajem je e-mail a všechny další údaje jsou nepovinné, nicméně důležité. Obecně platí pravidlo "čím více, tím lépe", ale také "nic se nesmí přehánět". Do datového zdroje by tak mělo příjít maximum dostupných údajů o příjemcích, které je možné pro vaše současné, ale i budoucí e-mailové kampaně využít. V této ukázce jsou následující údaje a jejich role:
  • email - bez e-mailu není kam e-maily posílat, takže zcela jednoznačně nutný údaj. Pokud však váš systém vygeneruje datový zdroj obsahující záznamy o všech klientech včetně těch, na které nemáte e-mailový kontakt nic se neděje - Mailkit tyto záznamy bude tiše ignorovat stejně jako záznamy s adresami v neplatném formátu
  • client_id - interní identifikátor zákazníka, např. klientské číslo, nebo číslo zákaznické karty
  • first_name a last_name - Jméno a Příjmení zákazníka, které je velice důležité nejen pro případné oslovení v mailu, ale má vliv i na doručitelnost zpráv neboť se používá v adrese příjemce. Jméno a příjmení v odeslaném mailu místo čisté adresy i lépe působí a pro některé antispamové filtry je i indikací vztahu k příjemci. Pokud váš systém nedokáže generovat odděleně jméno a příjemní je možné využít párování na pole Celé jméno (Fullname), které provede rozdělení do polí Jméno a Příjmení (jméno musí být první)
  • gender - pohlaví příjemce vám může posloužit nejen při oslovení, ale i např. pro segmentaci nebo jednoduché rozesílání duálních variant vašich kampaní - jiný design pro ženy a jiný pro muže. Hodnota pohlaví musí být ve tvaru m pro muže a f pro ženy. Důležitost znalosti pohlaví příjemce je často velice podceňována a přitom je ho možné snadno získat i automatizovanými metodami už při registraci, např. použitím služby genderize.io
  • mobile - mobilní telefon příjemce v mezinárodní podobě může posloužit k realizaci SMS kampaní a zvýšit tak váš zásah u příjemců, kteří nereagují na vaše e-mailové kampaně
  • street, city, zip, state, country - ulice, město, psč, kraj, země jsou všechno údaje které mohou posloužit k segmentaci kampaní, ale i personalizaci. Můžete tak např. v e-mailech přijemcům nabízet vyzvednutí zboží na nejbližši prodejně či pobočce pošty
  • birthdate - datum narození vám umožní realizovat kampaně s narozeninovými bonusy, narozeninová přání, atp. Formát data by měl odpovídat formátu, který budete následně využívat a pro výpočet výročí je nutné aby obsahoval nejen den a měsíc, ale i rok
  • reg_date a first_sale - datum registrace a prvního nákupu vašeho zákazníka do vašeho e-shopu vám umožní realizovat výroční kampaně či segmentovat příjemce podle těchto dat. Formát data by měl odpovídat formátování, které budette následně používat v kampaních
  • last_sale a last_active - znalost data posledního nákupu a poslední aktivity je důležitá pro vaše reaktivační kampaně, kampaně s dotazy na spokojenost a další poprodejní kampaně. Formát data by měl odpovídat formátování, které budette následně používat v kampaních
  • top_category, top_brandtop_products - nejoblíbenější kategorie, značky a produkty vám poslouží k segmentaci ale i k automatizaci obsahu vašich kampaní. V kombinaci s datovým zdrojem produktů pak umožní zcela automatizovaně vkládat do vašich kampaní personalizované produkty odpovídající zájmům příjemce z datového zdroje produktů
  • bonus_points - pokud máte bonusový program pro vaše klienty, je dobré jim stav bodů ukazovat v e-mailech a připomínat tak jejich výhody a možnosti jejich čerpání
Samozřejmě toto je jen část možných údajů a každá firma má jiná data a každý obor je specifický - právě proto Mailkit pracuje s datovými zdroji maximálně univerzálně a případné jejich rozšíření nebude mít vliv na funkčnost. Naopak - pokud začnete se základními údaji v datovém zdroji a až později jej obohatíte o další, stači pouze u datového zdroje nechat nově Zobrazit strukturu a provést párování nových větví struktury.

Import dat z datového zdroje

data_source_mapping.pngJakmile máte nastavený datový zdroj, je nutné přiřadit jednotlivé větvě zdroj k polím kontaktu. Pro přiřazení hodnot nebo zobrazení současného přiřazení klikněte na tlačítko Zobrazit strukturu. V tomto okamžiku dojde k analýze datového zdroje a zobrazí se jeho struktura a dostupná pole. Po přiřazení všech požadovaných polí klikněte na tlačítko Uložit. Po přiřazení polí je možné manuálně spustit import dat kliknutím na tlačítko Import. V případě, že tento zdroj byl nastaven aby použil nový seznam příjemců, dojde k jeho založení (se stejným názvem jako má datový zdroj) a dat z datového zdroje budou na pozadí importována.

Pokud jste u vašeho datového zdroje nastavili plánované aktualizace, bude probíhat pravidelná aktualizace podle tohoto plánu. V případě, že jste zvolili automatickou aktualizaci, dojde k aktulizaci vždy před rozesíláním kampaně, která využívá daný datový zdroj. Nezapomeňte však, že tato aktualizace může spozdit odeslání vaší kampaně i o několik minut, které může zabrat aktualizace datového zdroje. Obecně doporučujeme dát přednost plánované aktualizaci, před automatickou.

Použití XML & RSS datových zdrojů v šablonách

Nastavení XML & RSS datových zdrojů pro použití v šablonách je velmi podobné jako pro použití v seznamech příjemců, ale bez nutnosti přiřazování významů jednotlivých polí. Hodnoty jsou určeny řetězcem jmen v šabloně, proto je snadné nastavit jakýkoliv XML či RSS zdroj.

[% FOREACH data.DS_RSS_EXAMPLE -%]
<div>
	<a href="[% URL -%]"><img src="[% ENCLOSURE -%]" alt="[% TITLE -%]"></a>
	<a href="[% URL -%]">[% TITLE -%]</a>[% DESCRIPTION -%]
</div>
[% END -%]

Výše je uvedený příklad kódu šablony, pro kterou je použit RSS datový zdroj pojmenovaný EXAMPLE. Příkaz FOREACH vytváří smyčku pro parsování a nalezení všech záznamů. Každý ze standardních RSS tagů je snadno řešen a vložen do HTML kódu, což umožňuje výstup dat do šablony. Více informací viz. Šablony emailů.

Produktové datové zdroje

Datové zdroje je možné využít i pro přenos produktové nabídky do Mailkitu a následné použití produktových informací v kampaních. Právě zde se pak projevuje síla datových zdrojů a programovatelných šablon, která umožňuje kombinovat data z vícero zdrojů a zcela automatizovaně tak personalizovat obsah na míru jednotlivých příjemců.

Pro produktové informace je možné použít kterýkoliv z běžných formátů produktových feedů pro srovnávače Heureka, Zboží, Google a další, nebo generovat vlastní feed s potřebnými informacemi. Protože produktové feedy jsou velice rozsáhlé a je důležitá rychlost práce s daty v nich obsaženými, tyto datové zdroje se přenášejí přímo do SQL databáze a i tak je s nimi možné pracovat.

Pro nastavení produktového datového zdroje zvolte typ datového zdroje SQL a pokračujte v nastavování datového zdroje. V případě použití jednoho ze standardních formátů produktových feedů nejsou k dispozici žádné další možnosti nastavení. V případě, že vyberete vlastní formát, budete muset pomocí tlačítka Zobrazit strukturu nastavit jeden primární klíč a 3 indexovaná pole. V případě potřeby se neváhejte obrátit na zákaznickou podporu, která vám pomůže s nastavením produktového feedu a jeho následným využitím.

Datový zdroj rozesílky

Datové zdroje rozesílky (delivery feed) jsou speciální datové zdroje, jež slouží k předání strukturovaných informací pro realizaci rozesílky kampaně. Zatím co obvykle kampaň využívá stanovený seznam příjemců, na který probíhá její rozesílka dle nastavených pravidel, v případě datového zdroje rozesílky je kampaň rozesílána pouze na adresy uvedené v datovém zdroji. Jedná se o alternativu k API volání mailkit.sendmail_mass, tzn. způsob jak do Mailkitu dostávat vysoce strukturovaná data, např. z personalizačních systémů či CRM, jež se mají při odesílání kampaně zpracovat. Tyto feedy pak musí mít striktně definovanou strukturu ve formátu XML, která je velice podobná struktuře API volání mailkit.sendmail_mass.

<?xml version="1.0"?>
<deliveryFeed>
  <feedItem>
    <recipient>
    <email>recipient email (povinné)</email>
      <first_name>Jméno (volitelně)</first_name>
      <last_name>Prijmeni (volitelně)</last_name>
      <gender>M (volitelně)</gender>
      ... další standardní pole příjemce
    </recipient>
    <subject>subject (volitelně)</subject>
    <message_data>static message content (volitelně)</message_data>
    <attachment>
      <file_url>url (volitelně)</file_url>
      <file_url>url (volitelně)</file_url>
      <file_url>url (volitelně)</file_url>
    </attachment>
    <content>
      <!-- XML structured values (volitelně) example    -->
    </content>
  </feedItem>
</deliveryFeed>
Údaje o příjemcích v datovém zdroji rozesílky mají přednost před údaji o příjemci uloženými v seznamu příjemců a nahradí tyto hodnoty v průběhu doručování. Datový zdroj rozesílky tak může nejen řídit rozesílku, ale zároveň i sloužit jako cesta k aktualizaci seznamu příjemců.