Integrace

Přenos kontaktů přes CSV

Kontakty z jakéhokoli nástroje, e-shopu nebo tabulky přenesete do SmartMaileru souborem CSV. Návod ukazuje, jak soubor připravit, jak rozdělit kontakty podle stavu a jak zkontrolovat výsledek importu.

Jak to funguje

  • Postup platí pro každý nástroj, který umí kontakty vyexportovat do CSV. Pro některé nástroje máme i samostatný návod, najdete je v rámečku Návody pro konkrétní nástroje.
  • Použijete běžný import kontaktů do adresáře: vyberete soubor, přiřadíte sloupce k polím adresáře a SmartMailer ukáže výsledek.
  • Import můžete zopakovat. Kontakt, který už v adresáři je, SmartMailer podle e-mailu najde a aktualizuje, nové kontakty přidá.

Postup krok za krokem

  1. 1

    Připravte adresáře ve SmartMaileru

    V menu Adresáře založte adresář příjemců a přidejte do něj pole pro údaje, které chcete přenést. Pole může být typu text, e-mail, telefon, číslo nebo datum. Pro odhlášky máte adresář typu Odhlášky s názvem Výchozí odhlášky.

  2. 2

    Vyexportujte kontakty i se stavem

    V původním nástroji vyexportujte kontakty do CSV, nejlépe v kódování UTF-8. Do exportu zahrňte stav kontaktu a údaje o souhlasu, pokud je nástroj eviduje. Umí-li nástroj exportovat každý stav zvlášť, využijte to.

  3. 3

    Rozdělte kontakty podle stavu

    Podle tabulky Stavy kontaktů rozdělte řádky do dvou souborů: přihlášené kontakty do souboru pro adresář příjemců, odhlášené, blokované a hard bounce do souboru pro adresář odhlášek. Nepotvrzené kontakty bez doloženého souhlasu nedávejte do žádného z nich.

  4. 4

    Naimportujte příjemce

    V adresáři příjemců klikněte na Importovat kontakty a vyberte soubor s přihlášenými kontakty. V okně Přiřazení sloupců zkontrolujte, ke kterému poli adresáře každý sloupec patří, a klikněte na Importovat.

  5. 5

    Naimportujte odhlášky

    Soubor s odhlášenými, blokovanými a hard bounce kontakty naimportujte stejně do adresáře Výchozí odhlášky. Kampaň ho pak vyloučí, jak popisuje tabulka stavů.

  6. 6

    Zkontrolujte výsledek

    Po importu SmartMailer ukáže, kolik kontaktů přibylo, kolik se aktualizovalo a které řádky se nenaimportovaly a proč. U souboru s víc než 1 000 řádky to najdete po dokončení v panelu Importy na pozadí na stránce kontaktů adresáře. V kampani pak tlačítko Spočítat příjemce ukáže, kolik adres zbyde po odečtení duplicit a vyloučených adresářů. Účet v původním nástroji nerušte, dokud nemáte import zkontrolovaný.

Jak má soubor vypadat

Na prvním řádku jsou názvy sloupců, na každém dalším jeden kontakt. Takhle vypadá malý soubor se souhlasem:

email,fname,lname,CONSENT_AT,CONSENT_SOURCE
jana@example.com,Jana,Nováková,2024-03-05 14:30:00,Formulář na webu
petr@example.com,Petr,"Svoboda, ml.",,
  • Soubor uložte v kódování UTF-8, značka BOM na začátku souboru nevadí. Soubor, který není platné UTF-8, SmartMailer načte jako Windows-1250, takže projdou i starší exporty z Excelu.
  • Hlavičkou je první neprázdný řádek. Sloupec se k poli adresáře přiřadí podle slugu nebo názvu pole a na velikosti písmen nezáleží.
  • Oddělovač sloupců SmartMailer pozná z hlavičky sám: středník, čárku, tabulátor nebo svislou čáru. Při importu ho nevybíráte, nastavení Oddělovač v CSV v předvolbách účtu platí jen pro export a vzorový soubor.
  • Hodnotu, která obsahuje oddělovač, uzavřete do uvozovek jako "Svoboda, ml." v ukázce.
  • Po výběru souboru se ukáže Přiřazení sloupců s prvním kontaktem ze souboru. Sloupce se stejným nebo obvyklým názvem jako pole jsou předvyplněné, ostatní mají volbu Nepřenášet. Sloupec s e-mailem je povinný a každé pole patří jen jednomu sloupci. V nabídce jsou i sloupce souhlasu, takže je přiřadíte i pod jiným názvem z exportu.
  • Hlavičku pro konkrétní adresář stáhnete v okně importu tlačítkem Stáhnout vzorový CSV.

Stavy kontaktů

Nástroje stavy pojmenovávají různě. Podle téhle tabulky rozhodnete, kam který kontakt patří.

Stav v původním nástroji Kam ve SmartMaileru
Aktivní, přihlášený, potvrzený Do adresáře příjemců.
Nepotvrzený, čeká na potvrzení Mezi příjemce jen s doloženým souhlasem, jinak nikam.
Odhlášený Do adresáře typu Odhlášky.
Blokovaný, na blacklistu, stížnost na spam Do adresáře typu Odhlášky.
Hard bounce, trvale nedoručitelný Do adresáře typu Odhlášky, mezi příjemce ne.
  • Kampaň vždy vyloučí adresář vybraný v poli Zapsat odhlášky do. U nové kampaně je v něm předvyplněný výchozí adresář odhlášek z nastavení projektu, a když žádný nastavený není, adresář Výchozí odhlášky.
  • Odhlášky v jiném adresáři kampaň vyloučí, jen když ho u ní vyberete v poli Vyloučit adresáře.
  • Pokud SmartMailer adresu už zná jako trvale nedoručitelnou, import ji do adresáře příjemců přidá, ale kampaň jí e-mail nepošle a Spočítat příjemce ji uvede mezi nedoručitelnými.

Co se CSV importem nepřenese

  • Kampaně, šablony a automatizace ani jejich statistiky. Ve SmartMaileru je založte znovu.
  • Historie rozesílek, otevření a prokliků jednotlivých kontaktů.
  • Štítky, skupiny a segmenty jako takové. Štítek nebo skupinu převeďte na sloupec a naimportujte do vlastního pole kontaktu. V kampani pak příjemce zúžíte v části Segmentace podle pole, třeba podmínkou rovná se. Podmínky platí současně.
  • Podmínka rovná se porovnává celou hodnotu pole. Když je v jedné buňce víc štítků, dejte každý štítek do vlastního pole, nebo kontakty rozdělte do více adresářů.

Na co si dát pozor

  • Kontakt se v adresáři hledá podle e-mailu a na velikosti písmen nezáleží. Opakovaný import proto stejný kontakt nezaloží znovu, ale aktualizuje jeho údaje.
  • Prázdná buňka v přiřazeném sloupci při aktualizaci hodnotu pole u kontaktu smaže. Sloupce, které u existujících kontaktů měnit nechcete, nechte v přiřazení na Nepřenášet, jejich hodnoty zůstanou.
  • Je-li stejný e-mail v souboru víckrát, naimportuje se první řádek. Další výskyty SmartMailer přeskočí a ve výsledku importu je uvede.
  • Řádek bez e-mailu, s neplatným e-mailem nebo s hodnotou, kterou pole nepřijme, se nenaimportuje, ostatní řádky ano. U adresáře příjemců SmartMailer navíc ověřuje, že doména e-mailu přijímá poštu. Do adresáře odhlášek se naimportují i adresy na zaniklých doménách, aby zůstaly vyloučené.
  • Jeden import míří vždy do jednoho adresáře. Seznamy, které chcete oslovovat zvlášť, importujte do samostatných adresářů. Kampaň můžete poslat do více adresářů najednou a adresa, která je ve více z nich, dostane e-mail jen jednou.
  • Soubor může mít nejvýš 50 MB. Soubor s víc než 1 000 řádky se importuje na pozadí, takže ho nemusíte dělit ani čekat na stránce. Výsledek vám přijde e-mailem. Do jednoho adresáře běží na pozadí vždy jen jeden import.

Odhlášky přeneste vždy

Kdo se u vás odhlásil, nesmí po přechodu dostat obchodní sdělení, proto odhlášky nevynechávejte. Kontakty bez doloženého souhlasu nebo jiného oprávnění mezi příjemce nenahrávejte.