Izvoz in migracija podatkov iz Brevo: kako podatke prenesete noter ali ven

Iskalni obseg za fraze, kot je „brevo data export migration to another platform”, poganja ena skrb: da je nabrane podatke lažje spraviti noter kot ven. Pošten odgovor za Brevo je, da večina pride ven čisto, del pride ven v obliki, ki jo morate zgraditi znova, majhen a pomemben del pa se sploh ne more premakniti.

Ta vodnik pokriva obe smeri. Našteje, kaj natanko se izvozi, kaj ne, katere klice API uporabiti za račune, ki so za vmesnik preveliki, in kontrolni seznam za migracijo, ki sezname izključenih stikov in ugled pošiljanja obravnava kot prvorazredni skrbi in ne kot naknadno misel.

Kaj lahko dejansko izvozite iz Brevo

Stiki in atributi

Pot v vmesniku je CRM in nato Contacts. Za izvoz celotne zbirke poskrbite, da ni naložen noben seznam ali segment in da ni uporabljen noben filter. Za izvoz enega seznama ali segmenta kliknite „Load a list or segment” in ga najprej izberite.

Nato izberete, katere standardne atribute in atribute po meri želite vključiti. EMAIL, datum zadnje spremembe in datum nastanka so izbrani privzeto, ostale dodate sami, kar je korak, ki ga ljudje najpogosteje spregledajo. Izberite ločilo polj CSV, podpičje ali vejico, in po želji vklopite „Send export by email”, da povezava za prenos odide na naslov lastnika računa. Kliknite „Start export”, nato datoteko prenesite prek zvonca z obvestili poleg imena vašega računa.

Seznami in segmenti

Seznami se izvozijo kot članstvo: izvedite en izvoz na seznam ali v en sam celoten izvoz vključite metapodatke _listIds in datoteko naknadno razdelite. GET /v3/contacts/lists vam da imena seznamov, njihove id in id map, da lahko strukturo poustvarite na drugi strani.

Segmenti so drugačna zgodba in tu je prva prava vrzel. GET /v3/contacts/segments vrne samo id, segmentName, categoryName in updatedAt. Pogoji filtra, ki segment določajo, niso izpostavljeni. Izvozite lahko člane segmenta v določenem trenutku, pravilo, ki jih je ustvarilo, pa je treba prebrati z zaslona in ročno zgraditi znova v novem orodju. Preden ukinete račun, posnemite zaslonsko sliko vsakega segmenta.

Statistika kampanj

Iz poročila o kampanji lahko podatke izvozite kot CSV, poročila o e-pošti in SMS pa ponujajo tudi različico PDF za deljenje ali tiskanje. Za celoten zgodovinski zajem GET /v3/emailCampaigns sprejme parameter statistics z vrednostmi globalStats, linksStats ali statsByDomain ter par startDate in endDate, ki pokriva razpon do dveh let.

Transakcijski dnevniki

Dve poti, z različnima oknoma.

GET /v3/smtp/statistics/events vrne posamezne dogodke, filtrirane po vrsti (delivered, opened, clicks, hardBounces, spam, unsubscribed in drugi). Časovni razpon ne sme preseči 90 dni, privzeto pa zajame zadnjih 30 dni, če ne podate niti razpona niti parametra days.

Za množičen zajem POST /v3/webhooks/export ustvari izvozno opravilo za zadnjih 7 dni surovih dogodkov, omejeno na 20 izvoznih opravil na obdobje 7 dni. Vrne processId, ob zaključku pokliče vaš URL za obvestilo in dostavi CSV s stolpci, med katerimi so date, email, event, message-id, reason, sending_ip, subject, tag in template_id. Velike količine prispejo kot stisnjen arhiv več datotek CSV.

Praktična posledica: če želite več kot 90 dni transakcijske zgodovine, bi jo morali izvažati po urniku že ves čas. To opravilo nastavite zdaj, ne v tednu, ko se odločite oditi.

Kaj z vami ne gre

To je del, ki ga večina vodnikov po migraciji preskoči.

• Strukture avtomatiziranih potekov dela. API lahko avtomatizacije sproža prek dogodkov, ni pa dokumentirane končne točke, ki bi prebrala veje, zamike in pogoje posameznega poteka dela. Vsak potek dela se v novi platformi zgradi ročno.
• Definicije filtrov za segmente. Kot zgoraj, pridobiti je mogoče le imena in trenutne člane.
• Celotna zgodovina interakcij po posameznem stiku. Izvozite lahko tiste, ki so posamezno kampanjo odprli, kliknili, niso odprli, so se odjavili ali so povzročili trdo oziroma mehko zavrnitev, s pomočjo customContactFilter na končni točki za izvoz. Ne morete pa izvleči ene urejene datoteke z „vsemi odpiranji in kliki, kar jih je ta stik kdaj naredil”, ker so končne točke za surove dogodke omejene na 90 dni.
• Zvestoba izrisa predlog. htmlContent se izvozi čisto, a so bloki povleci in spusti, sintaksa spojnih oznak in nadomestki za povezavo do odjave lastni posamezni platformi. Izvožena koda HTML je izhodišče in ne dokončana predloga. Predvidite čas za ponovno preizkušanje vsake predloge v novem urejevalniku.
• Ugled glede dostavljivosti. Ugled pošiljatelja živi na pošiljajočih naslovih IP in avtenticirani domeni. Nova platforma, nov bazen naslovov IP, novo ogrevanje. Ohranitev iste domene in nastavitve DKIM ohrani domensko stran ugleda, kar zares pomaga, strani IP pa ne prenese.
• Identifikatorji obrazcev, pristajalnih strani in sledenja. Prijavni obrazci, pristajalne strani in skripta za sledenje imajo id, lastne posamezni platformi. Karkoli je vgrajeno na vaše spletno mesto, je treba zamenjati, vsaka analitika, vezana na te id, pa ob preklopu odpove.

Skriptiran izvoz za velike račune

Nad približno 100.000 stiki postane izvoz prek vmesnika počasen in neroden, ponovljivo opravilo pa itak želite. Končna točka za izvoz stikov je asinhrona: sprejme filter, vrne id procesa in vam ob zaključku izroči datoteko 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"
  }'

Uspešen klic vrne HTTP 202 in telo, ki vsebuje processId. exportMandatoryAttributes je privzeto true in pokriva EMAIL, ADDED_TIME in MODIFIED_TIME, zato je exportAttributes mesto, kjer poimenujete svoja polja po meri. Nastavitev exportSubscriptionStatus je tisto, kar v datoteko spravi stanje marketinškega soglasja za e-pošto in SMS, izpustitev tega parametra pa je najpogostejši način, kako ljudje ustvarijo izvoz, ki je za skladno migracijo neuporaben.

Če raje stranično pregledujete zapise, kot da čakate na opravilo, GET /v3/contacts sprejme limit do 1000 skupaj z offset ter modifiedSince in createdSince za inkrementalne zajeme. Vsak stik se vrne s polji emailBlacklisted, smsBlacklisted, listIds, listUnsubscribed in consentGroups, kar je vse, kar potrebujete za rekonstrukcijo stanja soglasij.

Med skriptiranjem pazite na omejitve zahtev. Končne točke za stike na standardnih paketih dovolijo 36.000 zahtev na uro in 10 na sekundo, na ravneh Professional in Enterprise dvakrat toliko, medtem ko večina drugih končnih točk stoji pri 100 zahtevah na uro. Stranično pregledovanje milijona stikov po 1000 na stran je 1000 zahtev, kar je udobno znotraj proračuna za stike, tolčenje po končnih točkah za kampanje ali predloge v zanki pa ni.

Zakaj se mora vaš seznam izključenih stikov preseliti prvi

Odjave premaknite pred vsem drugim.

Pravni argument je preprost. Stik, ki se je odjavil, je soglasje umaknil vaši znamki. Ta umik se ne ponastavi, ker ste zamenjali ponudnika. Po GDPR je zapis o soglasju in njegovem umiku vaša obveznost kot upravljavca, po CAN-SPAM pa je treba odjavo upoštevati v desetih delovnih dneh in ostane upoštevana za nedoločen čas. Izguba seznama med migracijo ni tehnična nesreča, je kršitev skladnosti s papirnato sledjo, ki kaže na vas.

Argument glede dostavljivosti je v praksi še hujši. Med izključenimi naslovi je nesorazmerno veliko ljudi, ki so se pritožili, povzročili trdo zavrnitev ali dejavno hoteli ven. Pošiljanje tem naslovom z novega naslova IP brez ugleda je najhitrejši znani način, da nova pošiljalna postavitev v prvem tednu naleti na omejevanje ali blokado. Nekaj tisoč recikliranih pasti za neželeno pošto in pritožnikov lahko izniči mesec skrbnega ogrevanja.

Zato izključene skupine izvozite izrecno in ne upajte, da so vključene implicitno. Na končni točki za izvoz actionForContacts sprejme unsubscribed za stike, blokirane na kakršenkoli način, in unsubscribedPerList za stike, ki so zavrnili en določen seznam. Za hardBounces naredite ločen prehod po kampanjah. Ob vstopu v novo platformo to datoteko uvozite v njen seznam izključenih stikov, ne v seznam za pošiljanje.

Brevo obvladuje tudi obratni primer: podpira uvoz seznama blokiranih stikov, uvozni vmesnik API pa sprejme logični vrednosti emailBlacklist in smsBlacklist, tako da uvožena datoteka pristane kot izključena. Opazite asimetrijo, ki jo Brevo upravičeno uveljavlja: stikov ni mogoče množično odblokirati, ker bi bilo množično ponovno naročanje nekoga, ki je prosil, naj ga pustite pri miru, nezakonito. Izključitev je enostavno dodati in namerno težko odstraniti. To imejte za pravilno vedenje in ne za oviro.

Kontrolni seznam za migracijo iz Brevo

1. Popis. Preštejte stike, sezname, segmente, dejavne avtomatizacije, predloge in integracije. Zapišite si, katere integracije pišejo v Brevo, saj so to cevi, ki jih boste morali preusmeriti.
2. Izvoz. Stiki z vsemi atributi in stanjem naročnine, ena datoteka na seznam ali ena sama datoteka z _listIds, izključene skupine kot ločene datoteke, statistika kampanj, transakcijski dogodki za toliko nazaj, kolikor dopušča 90-dnevno okno, in koda HTML predlog.
3. Arhivirajte, kar poteče. Karkoli je časovno omejeno (surovi dogodki, dnevniki), je izgubljeno, ko se okno zavrti. Shranite to v svoje skladišče podatkov ali objektno shrambo zdaj.
4. Očistite in preslikajte. Odstranite podvojitve, poenotite oblike datumov in telefonskih številk in zapišite izrecno preslikavo stolpcev v polja za novo platformo. To je tudi naraven trenutek, da opustite naslove, ki v letu dni niso pokazali zanimanja, kar je ceneje kot plačevati ogrevanje mrtvega bremena. Mejne vrednosti pokriva naš vodnik po čiščenju e-poštnih seznamov.
5. Najprej naložite izključene. Odjave in trde zavrnitve uvozite v seznam izključenih stikov nove platforme, preverite, da se števila ujemajo z vašim izvozom, in šele nato naložite stike za pošiljanje.
6. Ogrevanje. Začnite s svojim najbolj odzivnim segmentom, obseg povečujte postopoma in dnevno spremljajte stopnji zavrnitev in pritožb. Zaporedje podrobno opisuje naš vodnik po dostavljivosti e-pošte.
7. Tecite vzporedno. Brevo naj ostane dejaven in naj pošilja vašo kritično transakcijsko pošto, medtem ko nova platforma prevzema vse večji delež marketinških pošiljanj. Ne preklopite obojega hkrati.
8. Preverite. Uskladite števila stikov, po poljih preverite dvajset naključnih stikov, s poskusnim pošiljanjem potrdite, da so izključeni stiki res izključeni, in primerjajte teden obsega pošiljanja s staro platformo.
9. Preklopite in ohranite pot nazaj. Zapise DNS in končne točke integracij spremenite v času, ko nekdo opazuje. Račun Brevo ohranite dejaven in plačan vsaj še en celoten obračunski cikel po preklopu, izvožene datoteke pa shranite izven obeh platform. To in ne obljuba ponudnika je vaš dejanski načrt za vrnitev.

Migracija v Brevo z druge platforme

Isti kontrolni seznam teče v obratni smeri, s tremi opombami, značilnimi za Brevo.

Od dosedanjega ponudnika zahtevajte pravi izvoz. Večina platform vam bo dala stike in njihova polja po meri kot CSV. Izrecno vprašajte za seznam izključenih stikov in seznam zavrnitev, ki sta pogosto v ločenem izvozu, na katerega ljudje pozabijo. Če prihajate iz modela cen na stik, primerjajte, koliko boste dejansko plačevali ob vstopu, z našim vodnikom po cenah Brevo.

Polja preslikajte pred nalaganjem. Atributi v Brevu imajo tipe (besedilo, število, datum, logična vrednost, kategorija), datum, ki pristane v besedilnem atributu, pa pozneje ne bo omogočal filtriranja. Atribute najprej ustvarite s pravimi tipi, šele nato uvozite.

Za karkoli večjega uvažajte prek vmesnika API. POST /v3/contacts/import sprejme vgrajen CSV v fileBody, polje JSON v jsonBody, oboje omejeno na približno 10 MB, ali oddaljeno datoteko prek fileUrl, poleg tega pa listIds ali objekt newList. updateExistingContacts je privzeto true in se ujema po e-pošti. Izvedite en uvoz z emailBlacklist nastavljenim na true za datoteko izključenih stikov, nato drugi uvoz za stike, ki jim boste pošiljali. Celotne delujoče skripte so v našem vodniku o uvozu stikov iz datoteke CSV v Brevo s skripto.

Nato zgradite znova, kar se ni preneslo: avtomatizacije, segmente, obrazce in predloge. Preden pošljete komurkoli resničnemu, pošljite testno pošiljko peščici ponudnikov e-poštnih predalov.

Naj naslednja migracija ne bo prepad

Razlog, da se migracija platforme zdi kot prepad, je ta, da je platforma postala sistem zapisov. Zgodovina naročil, stanje naročnikov in rezultati kampanj živijo pri enem ponudniku, njihova selitev pa pomeni evakuacijo.

Alternativa je, da vzdržujete lasten vir resnice in dovolite, da je platforma za pošiljanje cilj in ne trezor. Če se podatki vaše trgovine, stanje soglasij in dogodki o interakcijah neprekinjeno sinhronizirajo v vaše lastne sisteme, je zamenjava ali dodajanje kanala sprememba nastavitev in ne projekt. To je delo, ki ga Tajo opravlja med Brevom in tehnološkim skladom trgovca: podatke ohranja v pretoku v obe smeri, tako da platforma nikoli ni edina kopija.

Kakorkoli že, zgoraj opisana izvozna opravila je vredno izvajati po urniku že zdaj, ne glede na to, ali nameravate oditi. Najcenejša migracija je tista, pri kateri so podatki že zunaj platforme, ko se odločite.