Izvoz podataka i migracija iz platforme Brevo: kako preneti podatke unutra ili napolje

Obim pretrage za fraze poput „brevo data export migration to another platform” pokreće jedna briga: da je podatke koje ste nagomilali lakše uneti nego izneti. Pošten odgovor za Brevo glasi da najveći deo izlazi čisto, deo izlazi u obliku koji morate ponovo da izgradite, a mali ali važan deo uopšte ne može da se pomeri.

Ovaj vodič pokriva oba smera. Navodi tačno šta se izvozi, šta ne, koje API pozive koristiti za naloge prevelike za interfejs, i listu koraka za migraciju koja liste suzbijanja i reputaciju slanja tretira kao prvorazredna pitanja, a ne kao naknadnu misao.

Šta zaista možete da izvezete iz platforme Brevo

Kontakti i atributi

Putanja kroz interfejs je CRM, pa Contacts. Da biste izvezli celu bazu, uverite se da nije učitana nijedna lista ni segment i da nije primenjen nijedan filter. Da biste izvezli jednu listu ili segment, kliknite na „Load a list or segment” i prvo je izaberite.

Zatim birate koje standardne i prilagođene atribute da uključite. EMAIL, datum poslednje izmene i datum kreiranja izabrani su podrazumevano, a ostalo dodajete sami, i to je korak koji ljudi najčešće pogreše. Izaberite razdvajač polja za CSV, tačku i zarez ili zarez, i opciono uključite „Send export by email” da bi veza za preuzimanje otišla na adresu vlasnika naloga. Kliknite na „Start export”, pa preuzmite datoteku iz zvonca sa obaveštenjima pored imena vašeg naloga.

Liste i segmenti

Liste se izvoze kao članstvo: pokrenite jedan izvoz po listi ili uključite metapodatak _listIds u jedan pun izvoz pa naknadno podelite datoteku. GET /v3/contacts/lists daje vam imena lista, id-ove i id-ove fascikli, tako da možete da rekonstruišete strukturu na drugoj strani.

Segmenti su druga priča, i tu je prvi stvarni jaz. GET /v3/contacts/segments vraća samo id, segmentName, categoryName i updatedAt. Uslovi filtera koji definišu segment nisu izloženi. Možete da izvezete članove segmenta u datom trenutku, ali pravilo koje ih je proizvelo morate da pročitate sa ekrana i ručno ponovo izgradite u novom alatu. Napravite snimak ekrana svakog segmenta pre nego što ugasite nalog.

Statistika kampanja

Iz izveštaja o kampanji možete da izvezete podatke kao CSV, a izveštaji za imejl i SMS nude i PDF verziju za deljenje ili štampu. Za pun istorijski izvoz, GET /v3/emailCampaigns prihvata parametar statistics sa vrednostima globalStats, linksStats ili statsByDomain, kao i par startDate i endDate koji pokriva raspon do dve godine.

Transakcioni dnevnici

Dve putanje, sa različitim prozorima.

GET /v3/smtp/statistics/events vraća pojedinačne događaje filtrirane po tipu (delivered, opened, clicks, hardBounces, spam, unsubscribed i drugi). Vremenski raspon ne može da pređe 90 dana, a podrazumevano se odnosi na poslednjih 30 dana ako ne prosledite ni raspon ni parametar days.

Za masovni izvoz, POST /v3/webhooks/export kreira posao izvoza za sirove događaje iz poslednjih 7 dana, uz ograničenje od 20 poslova izvoza po periodu od 7 dana. Vraća processId, poziva vaš notify URL kada završi i isporučuje CSV sa kolonama koje uključuju date, email, event, message-id, reason, sending_ip, subject, tag i template_id. Veliki obimi stižu kao sažeta arhiva sa nekoliko CSV datoteka.

Praktična posledica: ako želite više od 90 dana transakcione istorije, trebalo je da je izvozite po rasporedu sve vreme. Postavite taj posao sada, a ne u nedelji kada odlučite da odete.

Šta ne ide sa vama

Ovo je deo koji većina vodiča za migraciju preskače.

• Strukture automatizovanih tokova rada. API može da pokrene automatizacije kroz događaje, ali ne postoji dokumentovana krajnja tačka koja čita grane, kašnjenja i uslove nekog toka rada. Svaki tok rada se ručno pravi iznova na novoj platformi.
• Definicije filtera segmenata. Kao gore, moguće je preuzeti samo imena i trenutne članove.
• Puna istorija angažovanja po kontaktu. Možete da izvezete one koji su otvorili, kliknuli, nisu otvorili, odjavili se, imali tvrdo ili meko odbijanje u okviru određene kampanje, koristeći customContactFilter na krajnjoj tački za izvoz. Ono što ne možete da izvučete jeste jedna uredna datoteka sa „svakim otvaranjem i klikom koje je ovaj kontakt ikada napravio”, jer su krajnje tačke za sirove događaje ograničene na 90 dana.
• Vernost iscrtavanja šablona. htmlContent se izvozi čisto, ali blokovi po principu prevuci i pusti, sintaksa oznaka za spajanje i rezervisana mesta za vezu za odjavu specifični su za platformu. HTML koji izvezete je početna tačka, ne gotov šablon. Predvidite vreme za ponovno testiranje svakog šablona u novom uređivaču.
• Reputacija isporučivosti. Reputacija pošiljaoca živi na IP adresama sa kojih se šalje i na autentifikovanom domenu. Nova platforma, novi skup IP adresa, novo zagrevanje. Zadržavanje istog domena i DKIM konfiguracije čuva stranu reputacije vezanu za domen, što stvarno pomaže, ali ne prenosi IP stranu.
• Identifikatori formulara, prodajnih stranica i praćenja. Formulari za prijavu, prodajne stranice i skripta za praćenje imaju id-ove specifične za platformu. Sve što je ugrađeno na vaš sajt mora da se zameni, a svaka analitika vezana za te id-ove puca pri prelasku.

Skriptovani izvoz za velike naloge

Iznad otprilike 100.000 kontakata izvoz kroz interfejs postaje spor i nezgodan, a ionako želite posao koji možete da ponovite. Krajnja tačka za izvoz kontakata je asinhrona: prihvata filter, vraća id procesa i predaje vam CSV kada završi.

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"
  }'

Uspešan poziv vraća HTTP 202 i telo koje sadrži processId. exportMandatoryAttributes podrazumevano je tačno i pokriva EMAIL, ADDED_TIME i MODIFIED_TIME, pa je exportAttributes mesto na kome imenujete svoja prilagođena polja. Postavljanje exportSubscriptionStatus je ono što u datoteku unosi stanje marketinške saglasnosti za imejl i SMS, a njegovo izostavljanje je najčešći način da napravite izvoz beskoristan za usklađenu migraciju.

Ako biste radije straničili kroz zapise nego čekali posao, GET /v3/contacts prihvata limit do 1000 uz offset, plus modifiedSince i createdSince za inkrementalna preuzimanja. Svaki kontakt vraća se sa emailBlacklisted, smsBlacklisted, listIds, listUnsubscribed i consentGroups, što je sve što vam treba da rekonstruišete stanje saglasnosti.

Pazite na ograničenja broja zahteva dok ovo skriptujete. Krajnje tačke za kontakte dozvoljavaju 36.000 zahteva na sat i 10 u sekundi na standardnim planovima, dvostruko na nivoima Professional i Enterprise, dok većina ostalih stoji na 100 zahteva na sat. Straničenje kroz milion kontakata po 1000 po stranici je 1000 zahteva, udobno unutar budžeta za kontakte, ali udaranje po krajnjim tačkama za kampanje ili šablone u petlji nije.

Zašto vaša lista suzbijanja mora prva da migrira

Prebacite odjave pre svega ostalog.

Pravni argument je jednostavan. Kontakt koji se odjavio povukao je saglasnost datu vašem brendu. To povlačenje se ne poništava time što ste promenili dobavljača. Prema GDPR propisu, evidencija saglasnosti i njenog povlačenja vaša je obaveza kao rukovaoca, a prema CAN-SPAM propisu odjava mora da se ispoštuje u roku od deset radnih dana i ostaje ispoštovana zauvek. Gubitak te liste u migraciji nije tehnička nezgoda, to je propust u usklađenosti sa papirnim tragom koji pokazuje na vas.

Argument o isporučivosti je u praksi još gori. Suzbijene adrese nesrazmerno pripadaju ljudima koji su se žalili, imali tvrdo odbijanje ili su aktivno hteli da izađu. Slanje njima sa potpuno nove IP adrese bez reputacije najbrži je poznat način da vam nova postavka za slanje bude prigušena ili blokirana već u prvoj nedelji. Nekoliko hiljada recikliranih zamki za neželjenu poštu i nezadovoljnih primalaca može da poništi mesec dana pažljivog zagrevanja.

Zato izričito izvezite suzbijene grupe umesto da se nadate da su podrazumevane. Na krajnjoj tački za izvoz, actionForContacts prihvata unsubscribed za kontakte blokirane na bilo koji način i unsubscribedPerList za kontakte koji su se odjavili sa jedne određene liste. Napravite poseban prolaz za hardBounces po kampanji. Prilikom ulaska na novu platformu, uvezite tu datoteku u njenu listu suzbijanja, a ne u listu za slanje.

Brevo pokriva i obrnut slučaj: podržava uvoz liste blokiranih kontakata, a API za uvoz prima logičke vrednosti emailBlacklist i smsBlacklist, tako da uvezena datoteka sleti kao suzbijena. Primetite asimetriju koju Brevo s pravom sprovodi: kontakti ne mogu grupno da se skinu sa liste blokiranih, jer bi grupno vraćanje pretplate nekome ko je tražio da ga ostavite na miru bilo protivzakonito. Suzbijanje je lako dodati i namerno teško ukloniti. Tretirajte to kao ispravno ponašanje, ne kao prepreku.

Lista koraka za migraciju, izlazak iz platforme Brevo

1. Popis. Prebrojte kontakte, liste, segmente, aktivne automatizacije, šablone i integracije. Zapišite koje integracije upisuju u Brevo, jer su to cevi koje ćete morati da preusmerite.
2. Izvoz. Kontakti sa svim atributima plus status pretplate, jedna datoteka po listi ili jedna datoteka sa _listIds, suzbijene grupe kao odvojene datoteke, statistika kampanja, transakcioni događaji koliko unazad prozor od 90 dana dozvoljava, i HTML šablona.
3. Arhivirajte ono što ističe. Sve što je vremenski ograničeno (sirovi događaji, dnevnici) nestaje kada prozor prođe. Smestite to u sopstveno skladište podataka ili objektno skladište već sada.
4. Očistite i mapirajte. Uklonite duplikate, uskladite formate datuma i telefona i napišite izričito mapiranje kolona u polja za novu platformu. Ovo je i prirodan trenutak da odbacite adrese koje se nisu angažovale godinu dana, što je jeftinije nego plaćati zagrevanje za mrtav teret. Naš vodič za čišćenje imejl liste pokriva pragove.
5. Prvo učitajte suzbijanje. Uvezite odjave i tvrda odbijanja u listu suzbijanja nove platforme, proverite da se brojevi poklapaju sa vašim izvozom, i tek onda učitajte kontakte kojima šaljete.
6. Zagrevanje. Počnite od najangažovanijeg segmenta, postepeno povećavajte obim i pratite stope odbijanja i prijava svakodnevno. Naš vodič za isporučivost imejla ima detaljan redosled.
7. Radite paralelno. Držite Brevo živim i neka šalje vašu kritičnu transakcionu poštu dok nova platforma preuzima sve veći udeo marketinških slanja. Nemojte prebaciti oboje odjednom.
8. Proverite. Uskladite brojeve kontakata, nasumično proverite dvadeset kontakata polje po polje, potvrdite da su suzbijeni kontakti zaista suzbijeni pokušajem probnog slanja i uporedite nedelju dana obima slanja sa starom platformom.
9. Pređite i zadržite povratak. Menjajte DNS i krajnje tačke integracija u terminu kada neko gleda. Držite Brevo nalog aktivnim i plaćenim najmanje jedan pun ciklus naplate nakon prelaska, uz izvezene datoteke sačuvane izvan obe platforme. To, a ne obećanje dobavljača, vaš je stvarni plan za povratak.

Migracija u Brevo sa druge platforme

Ista lista koraka radi obrnuto, uz tri napomene specifične za Brevo.

Zatražite pravi izvoz od dotadašnjeg dobavljača. Većina platformi daće vam kontakte i njihova prilagođena polja kao CSV. Izričito tražite listu suzbijanja i listu odbijanja, koje su često u posebnom izvozu koji ljudi zaborave da zatraže. Ako dolazite sa modela naplate po kontaktu, uporedite šta ćete zaista plaćati na ulasku uz naš vodič kroz Brevo cene.

Mapirajte polja pre otpremanja. Brevo atributi imaju tipove (tekst, broj, datum, logička vrednost, kategorija), a datum koji sleti u tekstualni atribut kasnije neće moći da se filtrira. Prvo napravite atribute sa ispravnim tipovima, pa tek onda uvezite.

Uvozite kroz API sve što je iole veliko. POST /v3/contacts/import prihvata ugrađeni CSV u fileBody, JSON niz u jsonBody, oba ograničena na oko 10 MB, ili udaljenu datoteku kroz fileUrl, plus listIds ili objekat newList. updateExistingContacts podrazumevano je tačno i poklapa po imejl adresi. Pokrenite jedan uvoz sa emailBlacklist postavljenim na tačno za datoteku suzbijanja, pa drugi uvoz za kontakte kojima šaljete. Pune radne skripte nalaze se u našem vodiču za uvoz CSV kontakata u Brevo pomoću skripte.

Zatim ponovo izgradite ono što nije prešlo: automatizacije, segmente, formulare i šablone. Pošaljite probno slanje na nekoliko poznatih imejl provajdera pre nego što pošaljete ijednom pravom primaocu.

Ne dozvolite da sledeća migracija bude provalija

Razlog zbog kog migracija sa platforme deluje kao provalija jeste to što je platforma postala sistem koji čuva izvornu istinu. Istorija porudžbina, stanje pretplatnika i rezultati kampanja žive unutar jednog dobavljača, a njihovo pomeranje znači evakuaciju.

Alternativa je da zadržite sopstveni izvor istine i pustite da platforma za slanje bude odredište, a ne trezor. Ako se podaci vaše prodavnice, stanje saglasnosti i događaji angažovanja neprekidno sinhronizuju u vaše sisteme, promena ili dodavanje kanala postaje izmena podešavanja umesto projekta. To je posao koji Tajo obavlja između platforme Brevo i tehnologije trgovca: održava protok podataka u oba smera, tako da platforma nikada nije jedina kopija.

Kako god, poslove izvoza opisane iznad vredi pokretati po rasporedu već sada, bez obzira na to da li planirate odlazak. Najjeftinija migracija je ona kod koje su podaci već izvan platforme kada odlučite.