Import a export kontaktů

V průvodci importem přenesete kontakty z tabulky a exportem stáhnete kontakty, které odpovídají aktuálním filtrům. Tato stránka popisuje také hromadné akce a endpoint pro export v API, se kterými totéž uděláte z kódu.

Než začnete

• Vytvořte všechna vlastní pole, která chcete ze souboru vyplnit. Průvodce umí namapovat sloupce jen na pole, která už existují.
• Vytvořte seznamy kontaktů, do kterých se mají kontakty přidat. Importy se počítají do limitu odběratelů každého seznamu.
• Importujte jen lidi, kteří s odběrem souhlasili. Při kontrole žádosti o produkční přístup se ptáme, jak odběratele získáváte. Viz Produkční přístup (ověření workspace).

Připravte soubor

Průvodce čte soubory .csv, .xlsx a .xls s nejvýše 2 500 kontakty na soubor. Větší seznamy rozdělte do více souborů.

email,first_name,last_name,company,birthday
ada@example.com,Ada,Lovelace,Acme,1990-04-12
grace@example.com,Grace,Hopper,Acme,1906-12-09
alan@example.com,Alan,Turing,,

Tipy pro čistý import:

• Na každý řádek dejte jeden kontakt a do prvního řádku názvy sloupců. Ze souborů Excel se čte jen první list.
• Pojmenujte sloupce podle svých polí a průvodce je namapuje za vás. Záhlaví sloupce se namapuje automaticky, když odpovídá názvu nebo klíči pole bez ohledu na velikost písmen, například email, First name, first_name nebo klíč vlastního pole jako company.
• Soubory CSV ukládejte v UTF-8, aby se jména s diakritikou načetla správně.
• Data zapisujte ve tvaru YYYY-MM-DD. Fungují i datumové buňky v souborech Excel. Jiné formáty data se odmítnou.
• Zkontrolujte adresy. Jediná neplatná e-mailová adresa zastaví celý import s chybou, která uvádí číslo řádku, například „Contact #12 has an invalid email address.“ Řádky s prázdnou buňkou e-mailu se přeskočí.
• Hodnoty vícevýběrových polí se naimportují jako jedna textová hodnota. Pokud chcete uložit více možností jako seznam, nastavte je přes API.

Naimportujte kontakty

1. Otevřete průvodce. Přejděte do Email Marketing›Contacts a vyberte Import.

2. Vyberte soubor. V poli CSV File vyberte svůj soubor. Pokud první řádek obsahuje názvy sloupců, nechte zaškrtnuté File has header. Průvodce ukáže první řádky a celkový počet řádků, a pokud má soubor víc než 2 500 řádků, zobrazí varování. Vyberte Continue.

3. Namapujte sloupce. U každého sloupce vyberte pole kontaktu, které vyplňuje: Email, First name, Last name, některé z vašich vlastních polí, nebo Exclude, pokud ho chcete přeskočit. Jeden sloupec musíte namapovat na Email. Každý řádek ukazuje ukázkové hodnoty, abyste mapování mohli zkontrolovat.

4. Vyberte seznamy kontaktů. V poli Audiences zvolte seznamy, do kterých se mají kontakty přidat, nebo ho nechte prázdné a kontakty naimportujte bez přidání do seznamu. Vyberte Continue.

5. Zkontrolujte a naimportujte. Náhled ukazuje soubor, počet kontaktů, seznamy, mapování sloupců a prvních 10 kontaktů tak, jak se uloží. Vyberte Import.

Emailit nejdřív zkontroluje celý soubor. Pokud je něco špatně, například neplatná adresa, neznámé vlastní pole nebo plný seznam, nenaimportuje se nic a chyby se vypíšou, abyste soubor mohli opravit. Jinak import proběhne na pozadí v dávkách po 500. Po chvíli obnovte stránku Contacts a uvidíte nové kontakty.

Co se stane s existujícími kontakty

Kontakty se párují podle e-mailové adresy bez ohledu na velikost písmen.

Několik dalších věcí, které je dobré vědět:

• Seznam pro mapování obsahuje Unsubscribed, ale import ho nepoužije. Pokud chcete naimportované lidi označit jako odhlášené, vyberte je potom na stránce Contacts a použijte hromadnou akci Unsubscribe.
• Importy nevyvolávají události webhooků contact.* ani subscriber.* a nespouštějí automatizace, jako je Added to audience.
• Pokud by seznam překročil limit odběratelů, import se odmítne se zprávou, která limit uvádí, například „Pay as you go includes 10,000 subscribers per audience.“ Viz Seznamy kontaktů.

Vyexportujte kontakty

1. Zužte seznam. Na stránce Email Marketing›Contacts zobrazte vyhledáváním a tlačítkem Filter kontakty, které chcete. Bez vyhledávání a filtrů export obsahuje všechny kontakty.

2. Vyexportujte. Vyberte Export a zvolte CSV, nebo XLSX. Prohlížeč stáhne contacts.csv, nebo contacts.xlsx.

Export může obsahovat nejvýše 10 000 kontaktů. Pokud jich odpovídá víc, export selže, takže přidejte filtry, například seznam kontaktů nebo rozsah data vytvoření, a exportujte po částech.

Soubor má jeden řádek na kontakt a tyto sloupce:

Práce s API

API nemá import souborů. Pokud chcete z kódu přidat mnoho kontaktů, zavolejte pro každý endpoint Vytvoření kontaktu, nebo Přidání odběratele, který jedním voláním vytvoří kontakt i jeho členství v seznamu.

Hromadné akce

POST /v2/contacts/bulk provede jednu akci až na 100 kontaktech zadaných podle ID con_:

curl https://api.emailit.com/v2/contacts/bulk \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "add_to_audience",
    "ids": ["con_2kq8Vt4xLm7Rz", "con_9fW3pQ1nBc6Yt"],
    "audience_id": "aud_5hJ2kL8mNp4Qr"
  }'

{
  "object": "contact_bulk",
  "action": "add_to_audience",
  "processed": 2,
  "ids": ["con_2kq8Vt4xLm7Rz", "con_9fW3pQ1nBc6Yt"]
}

Požadavek selže celý, pokud má ids víc než 100 položek (400), nebo pokud některý kontakt či seznam neexistuje (404, s neznámými ID v poli missing). Pokud chcete zpracovat víc kontaktů, procházejte stránky výsledků endpointu Výpis kontaktů a posílejte dávky po 100.

Export

GET /v2/contacts/export vrací stejný soubor jako webové rozhraní. Nastavte format na csv (výchozí), nebo xlsx a přidejte libovolné filtry, vyhledávání a řazení z endpointu Výpis kontaktů:

curl "https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_5hJ2kL8mNp4Qr&unsubscribed=false" \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -o contacts.csv

Pokud odpovídá víc než 10 000 kontaktů, endpoint vrací 422 se zprávou „Export is limited to 10000 contacts. Narrow your filters and try again.“

Související