Export dát a migrácia v Brevo: ako dostať dáta dnu aj von

Objem vyhľadávania fráz ako „brevo data export migration to another platform” poháňa jedna obava: že dáta, ktoré ste nazbierali, sa ľahšie vkladajú dnu než dostávajú von. Úprimná odpoveď pre Brevo je, že väčšina z nich vyjde čisto, časť vyjde v podobe, ktorú musíte postaviť odznova, a malá, ale dôležitá časť sa nedá presunúť vôbec.

Tento sprievodca pokrýva oba smery. Vymenúva presne to, čo sa exportuje, čo nie, API volania pre účty príliš veľké na používateľské rozhranie a kontrolný zoznam migrácie, ktorý berie zoznamy potlačených kontaktov a reputáciu odosielania ako prvoradé témy, nie ako dodatok.

Čo sa z Brevo naozaj dá exportovať

Kontakty a atribúty

Cesta v rozhraní je CRM a potom Contacts. Ak chcete exportovať celú databázu, uistite sa, že nie je načítaný žiadny zoznam ani segment a nie sú použité žiadne filtre. Ak chcete exportovať jeden zoznam alebo segment, kliknite najprv na „Load a list or segment” a vyberte ho.

Následne zvolíte, ktoré štandardné a vlastné atribúty zahrniete. EMAIL, dátum poslednej zmeny a dátum vytvorenia sú vybrané predvolene a zvyšok si pridávate sami, čo je krok, ktorý ľudia najčastejšie pokazia. Zvoľte oddeľovač polí CSV, bodkočiarku alebo čiarku, a prípadne zapnite „Send export by email”, aby odkaz na stiahnutie prišiel na adresu vlastníka účtu. Kliknite na „Start export” a potom si súbor stiahnite cez zvonček s upozorneniami vedľa názvu Vášho účtu.

Zoznamy a segmenty

Zoznamy sa exportujú ako členstvo: spustite jeden export na každý zoznam alebo zahrňte metadáta _listIds do jedného úplného exportu a súbor si potom rozdeľte. GET /v3/contacts/lists Vám dá názvy zoznamov, ich id a id priečinkov, takže štruktúru viete znova vytvoriť na druhej strane.

So segmentmi je to inak a tu je prvá skutočná medzera. GET /v3/contacts/segments vracia iba id, segmentName, categoryName a updatedAt. Filtračné podmienky, ktoré segment definujú, nie sú sprístupnené. Môžete exportovať členov segmentu k danému okamihu, ale pravidlo, ktoré ich vyprodukovalo, musíte odčítať z obrazovky a v novom nástroji postaviť ručne. Pred zrušením účtu si každý segment odfotografujte.

Štatistiky kampaní

Z reportu kampane môžete dáta exportovať ako CSV a reporty e-mailov a SMS ponúkajú aj verziu PDF na zdieľanie alebo tlač. Pre kompletné historické stiahnutie GET /v3/emailCampaigns prijíma parameter statistics s hodnotami globalStats, linksStats alebo statsByDomain a dvojicu startDate a endDate pokrývajúcu rozsah až dvoch rokov.

Transakčné logy

Dve cesty s odlišnými oknami.

GET /v3/smtp/statistics/events vracia jednotlivé udalosti filtrované podľa typu (delivered, opened, clicks, hardBounces, spam, unsubscribed a ďalšie). Rozsah dátumov nesmie presiahnuť 90 dní a ak nezadáte ani rozsah, ani parameter days, predvolene sa použije posledných 30 dní.

Pre hromadné sťahovanie POST /v3/webhooks/export vytvorí exportnú úlohu nad poslednými 7 dňami surových udalostí, s limitom 20 exportných úloh na 7 dní. Vráti processId, po dokončení zavolá Vašu notify URL a doručí CSV so stĺpcami vrátane date, email, event, message-id, reason, sending_ip, subject, tag a template_id. Veľké objemy prídu ako komprimovaný archív s niekoľkými CSV súbormi.

Praktický dôsledok: ak chcete viac než 90 dní transakčnej histórie, mali ste ju exportovať pravidelne už dávno. Nastavte si túto úlohu teraz, nie v týždni, keď sa rozhodnete odísť.

Čo s Vami nepôjde

Toto je časť, ktorú väčšina sprievodcov migráciou vynecháva.

• Štruktúry automatizačných workflowov. API vie automatizácie spúšťať cez udalosti, ale neexistuje dokumentovaný endpoint, ktorý by spätne prečítal vetvy, oneskorenia a podmienky workflowu. Každý workflow sa v novej platforme stavia ručne.
• Definície filtrov segmentov. Ako vyššie, získateľné sú iba názvy a aktuálni členovia.
• Úplná história interakcií na úrovni kontaktu. Cez customContactFilter na exportnom endpointe môžete exportovať tých, ktorí konkrétnu kampaň otvorili, klikli, neotvorili, odhlásili sa, mali tvrdé alebo mäkké odmietnutie. Čo sa vytiahnuť nedá, je jeden úhľadný súbor s „každým otvorením a klikom, ktoré tento kontakt kedy urobil”, pretože endpointy surových udalostí sú ohraničené na 90 dní.
• Vernosť vykreslenia šablón. htmlContent sa exportuje čisto, ale bloky typu drag and drop, syntax zlučovacích značiek a zástupné odkazy na odhlásenie sú špecifické pre platformu. HTML, ktoré exportujete, je východisko, nie hotová šablóna. Vyhraďte si čas na opätovné otestovanie každej šablóny v novom editore.
• Reputácia doručiteľnosti. Reputácia odosielateľa žije na odosielacích IP adresách a na autentifikovanej doméne. Nová platforma, nový IP fond, nové zahrievanie. Zachovanie tej istej domény a konfigurácie DKIM uchová doménovú stranu reputácie, čo naozaj pomáha, ale stranu IP neprenesie.
• Identifikátory formulárov, landing pages a sledovania. Registračné formuláre, landing pages aj sledovací skript majú identifikátory špecifické pre platformu. Čokoľvek vložené na Vašom webe treba vymeniť a akákoľvek analytika naviazaná na tieto identifikátory sa pri prepnutí zlomí.

Skriptovaný export pre veľké účty

Nad zhruba 100 000 kontaktmi je export cez rozhranie pomalý a nepohodlný a opakovateľnú úlohu chcete tak či tak. Exportný endpoint pre kontakty je asynchrónny: prijme filter, vráti id procesu a po dokončení Vám odovzdá CSV.

curl --request POST \
  --url https://api.brevo.com/v3/contacts/export \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'api-key: YOUR_API_KEY' \
  --data '{
    "customContactFilter": { "actionForContacts": "allContacts" },
    "exportMandatoryAttributes": true,
    "exportAttributes": ["FIRSTNAME", "LASTNAME", "SMS", "COUNTRY"],
    "exportMetadata": ["_listIds", "ADDED_TIME", "MODIFIED_TIME"],
    "exportSubscriptionStatus": ["email_marketing", "sms_marketing"],
    "exportDateInUTC": true,
    "notifyUrl": "https://example.com/hooks/brevo-export"
  }'

Úspešné volanie vráti HTTP 202 a telo obsahujúce processId. exportMandatoryAttributes je predvolene true a pokrýva EMAIL, ADDED_TIME a MODIFIED_TIME, takže exportAttributes je miesto, kde pomenujete svoje vlastné polia. Nastavenie exportSubscriptionStatus je to, čo dostane do súboru marketingový súhlas pre e-mail a SMS, a jeho vynechanie je najčastejší spôsob, ako ľudia vytvoria export nepoužiteľný pre migráciu v súlade s pravidlami.

Ak radšej stránkujete cez záznamy, než čakáte na úlohu, GET /v3/contacts prijíma limit až do 1000 spolu s offset plus modifiedSince a createdSince pre inkrementálne sťahovanie. Každý kontakt sa vráti s emailBlacklisted, smsBlacklisted, listIds, listUnsubscribed a consentGroups, čo je všetko, čo potrebujete na rekonštrukciu stavu súhlasu.

Pri skriptovaní sledujte limity požiadaviek. Endpointy pre kontakty povoľujú 36 000 požiadaviek za hodinu a 10 za sekundu na štandardných plánoch, dvojnásobok na úrovniach Professional a Enterprise, zatiaľ čo väčšina ostatných endpointov sedí na 100 požiadavkách za hodinu. Prestránkovanie milióna kontaktov po 1000 na stránku je 1000 požiadaviek, pohodlne v rámci rozpočtu pre kontakty, ale bušiť do endpointov kampaní alebo šablón v cykle už nie.

Prečo musí Váš zoznam potlačených kontaktov migrovať prvý

Odhlásenia presuňte skôr než čokoľvek iné.

Právny argument je jednoduchý. Kontakt, ktorý sa odhlásil, odvolal súhlas voči Vašej značke. Toto odvolanie sa nevynuluje tým, že ste zmenili dodávateľa. Podľa GDPR je záznam o súhlase a jeho odvolaní Vašou povinnosťou ako prevádzkovateľa a podľa CAN-SPAM musí byť odhlásenie rešpektované do desiatich pracovných dní a ostáva rešpektované neobmedzene. Strata tohto zoznamu pri migrácii nie je technická nehoda, je to zlyhanie súladu s papierovou stopou smerujúcou k Vám.

Argument doručiteľnosti je v praxi ešte horší. Potlačené adresy patria neúmerne často ľuďom, ktorí sa sťažovali, tvrdo odmietli doručenie alebo aktívne chceli preč. Poslať im poštu z úplne novej IP adresy bez reputácie je najrýchlejšia známa cesta, ako nechať čerstvé odosielacie nastavenie zaškrtiť alebo zablokovať už v prvom týždni. Pár tisíc recyklovaných spamových pascí a sťažovateľov dokáže zmariť mesiac starostlivého zahrievania.

Preto potlačené skupiny exportujte výslovne namiesto dúfania, že sú zahrnuté implicitne. Na exportnom endpointe actionForContacts prijíma unsubscribed pre kontakty na blocklistoch akéhokoľvek pôvodu a unsubscribedPerList pre kontakty odhlásené z jedného konkrétneho zoznamu. Samostatný prechod urobte pre hardBounces na každú kampaň. Pri vstupe do novej platformy tento súbor naimportujte do jej zoznamu potlačených kontaktov, nie do odosielateľného zoznamu.

Brevo zvláda aj opačný prípad: podporuje import zoznamu kontaktov na blocklist a importné API prijíma booleovské hodnoty emailBlacklist a smsBlacklist, takže importovaný súbor sa uloží ako potlačený. Všimnite si asymetriu, ktorú Brevo vynucuje správne: kontakty sa nedajú hromadne odstrániť z blocklistu, pretože hromadné opätovné prihlásenie niekoho, kto požiadal o pokoj, by bolo nezákonné. Potlačenie sa ľahko pridáva a zámerne ťažko odstraňuje. Berte to ako správne správanie, nie ako prekážku.

Kontrolný zoznam migrácie z Brevo

1. Audit. Spočítajte kontakty, zoznamy, segmenty, aktívne automatizácie, šablóny a integrácie. Zapíšte si, ktoré integrácie do Brevo zapisujú, pretože práve tie potrubia budete musieť presmerovať.
2. Export. Kontakty so všetkými atribútmi plus stav odberu, jeden súbor na zoznam alebo jeden súbor s _listIds, potlačené skupiny ako samostatné súbory, štatistiky kampaní, transakčné udalosti tak ďaleko dozadu, ako umožňuje 90-dňové okno, a HTML šablón.
3. Archivujte to, čo expiruje. Čokoľvek časovo ohraničené (surové udalosti, logy) je preč, len čo sa okno posunie. Uložte to už teraz do vlastného dátového skladu alebo objektového úložiska.
4. Vyčistite a namapujte. Odstráňte duplicity, zjednoťte formáty dátumov a telefónnych čísel a napíšte explicitné mapovanie stĺpcov na polia novej platformy. Je to zároveň prirodzený moment na vyradenie adries, ktoré rok nereagovali, čo je lacnejšie než platiť za zahrievanie mŕtvej záťaže. Náš sprievodca čistením e-mailových zoznamov pokrýva prahové hodnoty.
5. Najprv nahrajte potlačenia. Naimportujte odhlásenia a tvrdé odmietnutia do zoznamu potlačených kontaktov novej platformy, overte, že počty sedia s Vaším exportom, a až potom nahrajte odosielateľné kontakty.
6. Zahrievajte. Začnite najangažovanejším segmentom, objem zvyšujte postupne a denne sledujte mieru odmietnutí a sťažností. Náš sprievodca doručiteľnosťou e-mailov obsahuje celý postup podrobne.
7. Bežte paralelne. Nechajte Brevo živé a odosielajúce kritickú transakčnú poštu, kým nová platforma preberá rastúci podiel marketingových odoslaní. Neprepínajte oboje naraz.
8. Overte. Porovnajte počty kontaktov, náhodne skontrolujte dvadsať kontaktov pole po poli, potvrďte testovacím odoslaním, že potlačené kontakty sú naozaj potlačené, a porovnajte týždeň objemu odoslaní so starou platformou.
9. Prepnite a nechajte si možnosť návratu. DNS a endpointy integrácií meňte v čase, keď to niekto sleduje. Účet Brevo nechajte živý a zaplatený aspoň jeden celý fakturačný cyklus po prepnutí a exportované súbory držte mimo oboch platforiem. To, a nie sľub dodávateľa, je Váš skutočný plán návratu.

Migrácia do Brevo z inej platformy

Rovnaký kontrolný zoznam beží opačne, s tromi poznámkami špecifickými pre Brevo.

Získajte od predchádzajúceho dodávateľa skutočný export. Väčšina platforiem Vám dá kontakty a ich vlastné polia ako CSV. Výslovne si vyžiadajte zoznam potlačených kontaktov a zoznam odmietnutí, ktoré sú často v samostatnom exporte a ľudia ich zabudnú vyžiadať. Ak prichádzate z cenového modelu podľa počtu kontaktov, porovnajte si, čo naozaj zaplatíte pri vstupe, pomocou nášho sprievodcu cenníkom Brevo.

Namapujte polia ešte pred nahraním. Atribúty v Brevo majú typy (text, číslo, dátum, boolean, kategória) a dátum, ktorý pristane v textovom atribúte, sa neskôr nebude dať filtrovať. Najprv vytvorte atribúty so správnymi typmi a až potom importujte.

Čokoľvek väčšie importujte cez API. POST /v3/contacts/import prijíma vložené CSV v fileBody, JSON pole v jsonBody, oboje s limitom okolo 10 MB, alebo vzdialený súbor cez fileUrl, plus listIds alebo objekt newList. updateExistingContacts je predvolene true a páruje podľa e-mailu. Spustite jeden import s emailBlacklist nastaveným na true pre súbor potlačených kontaktov a potom druhý import pre odosielateľné kontakty. Kompletné funkčné skripty nájdete v našom sprievodcovi importom CSV kontaktov do Brevo pomocou skriptu.

Potom postavte znova to, čo sa neprenieslo: automatizácie, segmenty, formuláre a šablóny. Skôr než pošlete čokoľvek skutočným ľuďom, odošlite testovaciu vzorku na hrsť poskytovateľov schránok.

Nedovoľte, aby ďalšia migrácia bola zrázom

Migrácia platformy pôsobí ako zráz preto, že platforma sa stala systémom záznamov. História objednávok, stav odberateľov a výsledky kampaní žijú vo vnútri jedného dodávateľa a ich presun znamená evakuáciu.

Alternatívou je držať si vlastný zdroj pravdy a nechať odosielaciu platformu byť cieľom, nie trezorom. Ak sa dáta Vášho obchodu, stav súhlasov a udalosti interakcií priebežne synchronizujú do Vašich vlastných systémov, prepnutie alebo pridanie kanála je zmena konfigurácie, nie projekt. Presne túto prácu robí Tajo medzi Brevo a technologickým prostredím obchodníka: udržiava dáta v pohybe oboma smermi, aby platforma nikdy nebola jedinou kópiou.

Tak či onak, exportné úlohy popísané vyššie sa oplatí spúšťať pravidelne už teraz, bez ohľadu na to, či plánujete odísť. Najlacnejšia migrácia je tá, pri ktorej sú dáta mimo platformy už v čase, keď sa rozhodnete.