Seznamy kontaktů

Seznamy kontaktů

Import kontaktů z nahraného souboru

Při vytváření nového seznamu kontaktů nahraj soubor ve formátu CSV nebo XLS(x). Připrav ho podle těchto pravidel.

CSV soubor

  • Formát souboru: CSV. Přípona musí být .csv.
  • Kódování nastav na UTF-8. Jiná kódování fungují také, ale mohou být problematická pro diakritiku.
  • Sloupce odděl středníky.
  • Má seznam více sloupců? První řádek musí být hlavička (názvy sloupců oddělené čárkami). Seznam obsahuje jen e-mailové adresy? Hlavička není povinná — stačí jedna adresa na řádek.
  • Názvy sloupců v hlavičce: pouze malá písmena, číslice a podtržítko. Žádná diakritika, žádné mezery (nahraď podtržítkem „_“).
  • Hlavička musí obsahovat název email — slouží jako unikátní identifikátor zákazníka. Máš vlastní ID kontaktů? Pojmenuj sloupec id.
  • Časový údaj musí být ve formátu YYYY-MM-DD a namapovaný jako typ datum. Jinak filtrování kontaktů nebude fungovat správně.
  • Hodnoty můžeš ohraničit uvozovkami — umožňuje to použít oddělovač (středník) v datech. Potřebuješ uvozovku uvnitř? Zdvoj ji („“) a celou hodnotu ohraničuj uvozovkami. Mezi oddělovači (středník) a uvozovkou nesmí být žádné znaky ani mezery. Příklady viz níže.

XLS soubor (excelová tabulka)

Používej co nejjednodušší tabulky s čistými daty. Vyhni se makrům, skriptům, filtrování, externím datům a kontingenčním tabulkám — data se nemusí naimportovat správně.

  • Používá se pouze první list.
  • Každý kontakt je na jednom řádku.
  • První řádek obsahuje hlavičku (názvy sloupců).
  • Názvy sloupců v hlavičce: pouze malá písmena, číslice a podtržítko. Žádná diakritika, žádné mezery.
  • Sloupec s e-mailovou adresou musí mít v hlavičce název email.
  • Číselné hodnoty musí být jednoduché a nesmějí začínat nulou (01 se interpretuje jinak než 1).
  • Časový údaj musí být ve formátu YYYY-MM-DD a namapovaný jako typ datum.

Příklady CSV souborů

CSV s více sloupci:

id;email;firstname;salutation;registration_date
1;one@email.com;Ondřej;Ondro;2016-03-14
2;two@email.com;Karel;Karle;2015-06-13
3;three@email.com;Josef;Pepo;2014-07-27
4;four@email.com;Marek;Marku;2000-12-31

Jednoduchý soubor — jeden e-mail na řádek, bez hlavičky:

one@email.com
two@email.com
three@email.com
four@email.com
five@email.com

Příklady práce s uvozovkami:

email;favorite_product;firstname
one@email.com;Produkt;Ondřej
two@email.com;“Produkt“;Ondřej
three@email.com;“Produkt; který obsahuje oddělovač“;Ondřej
four@email.com;“Produkt který „“obsahuje““ uvozovky“;Ondřej

Příklady XLS souborů

XLS s více sloupci:

customer_idemailfirstnamesalutationregistration_date
1one@email.comOndřejOndro2016-03-14
2two@email.comKarelKarle2015-06-13
3three@email.comJosefPepo2014-07-27
4four@email.comMarekMarku2000-12-31

Tabulka pouze s e-maily (v první buňce může být i hlavička email):

one@email.com
two@email.com
three@email.com
four@email.com

Pravidelný import

Nastav pravidelně aktualizovaný seznam kontaktů, který stahuje data z tvého serveru. S nastavením ti pomůžeme — napiš nebo zavolej na kontakty v patičce.

Automatické přidávání kontaktů

Kontakty lze přidávat automaticky a průběžně. Máš dvě možnosti:

  • REST API: Tvoje aplikace/web volá naše API při různých událostech — třeba při registraci nového zákazníka. Záznam se vytvoří automaticky, bez ručního přidávání.
    API cally jsou popsané zde.
  • Formulář: Ke každému seznamu lze vytvořit formulář pro sběr kontaktů. Email Machine vygeneruje základní HTML kód, který si upravíš podle potřeby. Správu najdeš v detailu seznamu v záložce Formulář.
    Nemáš kam formulář vložit? Vytvoř landing page v modulu Webové stránky. Více zde.