Brevo adatexport és migráció: hogyan mozgasd be vagy ki az adataidat

Az olyan kifejezések keresési forgalmát, mint a „brevo data export migration to another platform”, egyetlen aggodalom hajtja: hogy a felhalmozott adataidat könnyebb betenni, mint kihozni. A Brevóval kapcsolatban az őszinte válasz az, hogy a legtöbb adat tisztán kijön, egy része olyan formában jön ki, amelyet újra kell építened, egy kicsi, de fontos része pedig egyáltalán nem mozdítható.

Ez az útmutató mindkét irányt lefedi. Felsorolja, mi exportálható és mi nem, megadja az API-hívásokat a felülethez túl nagy fiókokhoz, és ad egy migrációs ellenőrzőlistát, amely a tiltólistákat és a küldési reputációt elsőrendű kérdésként kezeli, nem utógondolatként.

Mit tudsz ténylegesen exportálni a Brevóból

Kapcsolatok és attribútumok

A felületen az útvonal a CRM, majd a Contacts. A teljes adatbázis exportálásához ügyelj rá, hogy ne legyen betöltve lista vagy szegmens, és ne legyen alkalmazva szűrő. Egyetlen lista vagy szegmens exportálásához előbb kattints a „Load a list or segment” gombra, és válaszd ki.

Ezután kiválasztod, mely szabványos és egyedi attribútumok kerüljenek bele. Az EMAIL, az utolsó módosítás dátuma és a létrehozás dátuma alapértelmezetten ki van jelölve, a többit magad adod hozzá, és ez az a lépés, amelyet a legtöbben elrontanak. Válaszd ki a CSV mezőelválasztódat, pontosvesszőt vagy vesszőt, és opcionálisan kapcsold be a „Send export by email” beállítást, hogy a letöltési link a fiók tulajdonosának címére menjen. Kattints a „Start export” gombra, majd töltsd le a fájlt a fiókneved melletti értesítési harangból.

Listák és szegmensek

A listák tagságként exportálódnak: futtass listánként egy exportot, vagy foglald bele a _listIds metaadatot egyetlen teljes exportba, és utólag bontsd szét a fájlt. A GET /v3/contacts/lists megadja a listaneveket, azonosítókat és mappaazonosítókat, hogy a másik oldalon újra létre tudd hozni a szerkezetet.

A szegmensek mások, és itt jön az első valódi hiányosság. A GET /v3/contacts/segments csak az id, segmentName, categoryName és updatedAt mezőt adja vissza. A szegmenst meghatározó szűrőfeltételek nincsenek kitéve. Egy adott időpontban exportálhatod a szegmens tagjait, de az őket előállító szabályt le kell olvasnod a képernyőről, és kézzel újraépítened az új eszközben. Készíts képernyőképet minden szegmensről, mielőtt lemondod a fiókot.

Kampánystatisztikák

Egy kampányjelentésből CSV-ként exportálhatod az adatokat, az e-mail- és SMS-jelentések pedig PDF-változatot is kínálnak megosztásra vagy nyomtatásra. Teljes történeti lekéréshez a GET /v3/emailCampaigns elfogad egy statistics paramétert globalStats, linksStats vagy statsByDomain értékkel, valamint egy startDate és endDate párost, amely legfeljebb kétéves tartományt fedhet le.

Tranzakciós naplók

Két út, eltérő ablakokkal.

A GET /v3/smtp/statistics/events típus szerint szűrve adja vissza az egyes eseményeket (delivered, opened, clicks, hardBounces, spam, unsubscribed és mások). A dátumtartomány nem haladhatja meg a 90 napot, és az elmúlt 30 napra áll be, ha sem tartományt, sem a days paramétert nem adod meg.

Tömeges lekéréshez a POST /v3/webhooks/export exportfeladatot hoz létre az elmúlt 7 nap nyers eseményeire, 7 napos időszakonként legfeljebb 20 exportfeladatra korlátozva. Visszaad egy processId értéket, befejezéskor meghívja az értesítési URL-edet, és CSV-t ad olyan oszlopokkal, mint a date, email, event, message-id, reason, sending_ip, subject, tag és template_id. Nagy mennyiség több CSV-fájlt tartalmazó tömörített archívumként érkezik.

A gyakorlati következmény: ha 90 napnál több tranzakciós előzményt szeretnél, akkor azt már eddig is ütemezetten kellett volna exportálnod. Állítsd be ezt a feladatot most, ne azon a héten, amikor a távozás mellett döntesz.

Ami nem jön veled

Ez az a rész, amelyet a legtöbb migrációs útmutató kihagy.

• Az automatizálási munkafolyamatok szerkezete. Az API eseményeken keresztül tudja indítani az automatizálásokat, de nincs dokumentált végpont, amely visszaolvasná egy munkafolyamat elágazásait, késleltetéseit és feltételeit. Minden munkafolyamatot kézzel építesz újra az új platformon.
• A szegmensek szűrődefiníciói. Ahogy fent, csak a nevek és az aktuális tagok kérhetők le.
• A teljes, kapcsolatonkénti elköteleződési előzmény. Az exportvégpont customContactFilter paraméterével exportálhatod egy adott kampány megnyitóit, kattintóit, nem megnyitóit, leiratkozóit, kemény vagy puha visszapattanóit. Amit nem tudsz lehúzni, az egyetlen rendezett fájl arról, hogy „ez a kapcsolat valaha mit nyitott meg és mire kattintott”, mert a nyers eseményvégpontok 90 napra korlátozódnak.
• A sablonok megjelenítési hűsége. A htmlContent tisztán exportálódik, de a fogd és vidd blokkok, az összevonási címkék szintaxisa és a leiratkozási link helyőrzői platformspecifikusak. Az exportált HTML kiindulópont, nem kész sablon. Tervezz időt minden sablon újratesztelésére az új szerkesztőben.
• A kézbesíthetőségi reputáció. A feladói reputáció a küldő IP-címeken és a hitelesített domainen él. Új platform, új IP-készlet, új bemelegítés. Ugyanannak a domainnek és DKIM-konfigurációnak a megtartása megőrzi a reputáció domainoldalát, ami valóban segít, de az IP-oldalt nem viszi át.
• Űrlap-, céloldal- és követési azonosítók. A feliratkozási űrlapoknak, a céloldalaknak és a követőszkriptnek egyaránt platformspecifikus azonosítói vannak. Mindent le kell cserélni, ami be van ágyazva a webhelyedbe, és minden ezekhez az azonosítókhoz kötött analitika elromlik az átálláskor.

Szkriptelt export nagy fiókokhoz

Nagyjából 100 000 kapcsolat fölött a felületi export lassúvá és kényelmetlenné válik, és amúgy is megismételhető feladatot szeretnél. A kapcsolatexport végpontja aszinkron: elfogad egy szűrőt, visszaad egy folyamatazonosítót, és amikor végzett, átad egy CSV-t.

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

A sikeres hívás HTTP 202-t ad vissza, és a törzs tartalmaz egy processId értéket. Az exportMandatoryAttributes alapértelmezetten igaz, és lefedi az EMAIL, ADDED_TIME és MODIFIED_TIME mezőt, így az exportAttributes az a hely, ahol az egyedi mezőidet nevezed meg. Az exportSubscriptionStatus beállítása teszi bele a fájlba az e-mail és az SMS marketing-hozzájárulási állapotát, és ennek elhagyása a leggyakoribb módja annak, hogy olyan exportot állíts elő, amely használhatatlan egy szabályos migrációhoz.

Ha inkább rekordokon lapoznál, mint egy feladatra várnál, a GET /v3/contacts elfogad limit értéket 1000-ig egy offset paraméterrel, valamint modifiedSince és createdSince értéket az inkrementális lekérésekhez. Minden kapcsolat az emailBlacklisted, smsBlacklisted, listIds, listUnsubscribed és consentGroups mezővel jön vissza, ami minden, ami a hozzájárulási állapot rekonstruálásához kell.

Figyeld a sebességkorlátokat, amíg ezt szkripteled. A kapcsolatvégpontok standard csomagon óránként 36 000 kérést és másodpercenként 10-et engednek, ez Professional és Enterprise szinten a duplájára nő, míg a legtöbb más végpont óránként 100 kérésen ül. Egymillió kapcsolat lapozása oldalanként 1000-rel 1000 kérés, ami kényelmesen belefér a kapcsolati keretbe, de a kampány- vagy sablonvégpontok ciklusban való püfölése már nem.

Miért a tiltólistádnak kell elsőként költöznie

A leiratkozásokat mozgasd át minden más előtt.

A jogi érv egyszerű. Az a kapcsolat, aki leiratkozott, a te márkádtól vonta vissza a hozzájárulását. Ez a visszavonás nem áll vissza attól, hogy szolgáltatót váltottál. A GDPR alatt a hozzájárulás és annak visszavonásának nyilvántartása adatkezelőként a te kötelezettséged, a CAN-SPAM alatt pedig egy leiratkozást tíz munkanapon belül teljesíteni kell, és utána határozatlan ideig érvényben marad. A lista elvesztése egy migrációban nem technikai baleset, hanem megfelelőségi hiba, amelynek papírnyoma rád mutat.

A kézbesíthetőségi érv a gyakorlatban még súlyosabb. A tiltott címek aránytalanul nagy részben olyan emberek, akik panaszt tettek, kemény visszapattanást okoztak, vagy tevékenyen ki akartak szállni. Ha egy vadonatúj, reputáció nélküli IP-ről küldesz nekik, az a leggyorsabb ismert módja annak, hogy egy friss küldési beállítást már az első hetében fojtsanak vagy blokkoljanak. Néhány ezer újrahasznosított spamcsapda és panaszos képes tönkretenni egy hónapnyi gondos bemelegítést.

Ezért kifejezetten exportáld a tiltott csoportokat, ne abban bízz, hogy magától benne vannak. Az exportvégponton az actionForContacts elfogadja az unsubscribed értéket a bármilyen módon tiltólistára került kapcsolatokra, és az unsubscribedPerList értéket az egy adott listáról leiratkozottakra. Futtass külön kört a hardBounces értékre kampányonként. Az új platformra befelé pedig ezt a fájlt a tiltólistájába importáld, ne egy küldhető listába.

A Brevo a fordított esetet is kezeli: támogatja a tiltólistás kapcsolatok listájának importálását, az import-API pedig átveszi az emailBlacklist és smsBlacklist logikai értéket, így egy importált fájl tiltottként érkezik be. Figyeld meg azt az aszimmetriát, amelyet a Brevo joggal kényszerít ki: a kapcsolatokat nem lehet tömegesen levenni a tiltólistáról, mert valakinek a tömeges visszairatkoztatása, aki azt kérte, hogy hagyják békén, jogsértő lenne. A tiltást könnyű hozzáadni, és szándékosan nehéz eltávolítani. Ezt helyes viselkedésnek tekintsd, ne akadálynak.

Migrációs ellenőrzőlista, kifelé a Brevóból

1. Auditálj. Számold össze a kapcsolatokat, listákat, szegmenseket, aktív automatizálásokat, sablonokat és integrációkat. Írd fel, mely integrációk írnak a Brevóba, mert ezek azok a csövek, amelyeket át kell irányítanod.
2. Exportálj. Kapcsolatok az összes attribútummal és a feliratkozási állapottal, listánként egy fájl vagy egyetlen fájl _listIds értékkel, a tiltott csoportok külön fájlokban, a kampánystatisztikák, a tranzakciós események annyira visszamenőleg, amennyit a 90 napos ablak enged, és a sablonok HTML-je.
3. Archiváld, ami lejár. Minden időhöz kötött adat (nyers események, naplók) eltűnik, amint az ablak továbbgördül. Tárold most a saját adattárházadban vagy objektumtárolódban.
4. Tisztíts és képezz le. Deduplikálj, normalizáld a dátum- és telefonformátumokat, és írj explicit oszlop-mező leképezést az új platformhoz. Ez egyben a természetes pillanat arra is, hogy elhagyd azokat a címeket, amelyek egy éve nem reagáltak, ami olcsóbb, mint holt súlyt bemelegíteni. Az e-mail-lista tisztítási útmutatónk tartalmazza a küszöbértékeket.
5. Előbb a tiltólistát töltsd be. Importáld a leiratkozásokat és a kemény visszapattanásokat az új platform tiltólistájába, ellenőrizd, hogy a darabszámok egyeznek az exportoddal, és csak ezután töltsd be a küldhető kapcsolatokat.
6. Melegíts be. Kezdd a legelkötelezettebb szegmenseddel, fokozatosan növeld a mennyiséget, és naponta figyeld a visszapattanási és panaszarányt. Az e-mail-kézbesíthetőségi útmutatónk részletesen tartalmazza a sorrendet.
7. Futtasd párhuzamosan. Tartsd élőben a Brevót, hadd küldje a kritikus tranzakciós leveleidet, miközben az új platform egyre nagyobb részt vállal a marketingküldésekből. Ne kapcsold át mindkettőt egyszerre.
8. Ellenőrizz. Egyeztesd a kapcsolatok darabszámát, nézz át húsz kapcsolatot mezőről mezőre, egy tesztküldéssel győződj meg róla, hogy a tiltott kapcsolatok tényleg tiltottak, és vess össze egy hétnyi küldési mennyiséget a régi platforméval.
9. Állj át, és tarts kéznél visszaállást. A DNS-t és az integrációs végpontokat olyan időablakban módosítsd, amikor valaki figyel. Tartsd életben és fizetve a Brevo-fiókot az átállás után legalább egy teljes számlázási ciklusig, az exportált fájlokat pedig tárold mindkét platformon kívül. Ez, és nem egy szolgáltatói ígéret, a tényleges visszaállási terved.

Migráció a Brevóba egy másik platformról

Ugyanez az ellenőrzőlista fut visszafelé, három Brevóra jellemző megjegyzéssel.

Szerezz valódi exportot a jelenlegi szolgáltatótól. A legtöbb platform CSV-ben adja a kapcsolatokat és az egyedi mezőiket. Kifejezetten kérd a tiltólistát és a visszapattanási listát, amelyek gyakran külön exportban vannak, és amelyeket sokan elfelejtenek kérni. Ha kapcsolatonkénti árazási modellből érkezel, hasonlítsd össze, mennyit fizetsz majd valójában, a Brevo árazási útmutatónk segítségével.

Képezd le a mezőket a feltöltés előtt. A Brevo attribútumainak típusuk van (szöveg, szám, dátum, logikai, kategória), és egy szöveges attribútumba érkező dátum később nem lesz szűrhető. Előbb hozd létre az attribútumokat a megfelelő típussal, aztán importálj.

Bármi komolyabbat az API-n keresztül importálj. A POST /v3/contacts/import elfogad beágyazott CSV-t a fileBody mezőben, JSON-tömböt a jsonBody mezőben, mindkettőt nagyjából 10 MB-ig, vagy távoli fájlt a fileUrl mezőn keresztül, plusz listIds értéket vagy egy newList objektumot. Az updateExistingContacts alapértelmezetten igaz, és e-mail alapján egyeztet. Futtass egy importot emailBlacklist igaz értékkel a tiltólistás fájlodra, majd egy másodikat a küldhető kapcsolatokra. A teljes, működő szkriptek a CSV-kapcsolatok szkripttel történő importálásáról szóló útmutatónkban vannak.

Ezután építsd újra, ami nem költözött: automatizálásokat, szegmenseket, űrlapokat és sablonokat. Küldj tesztlevelet néhány postafiók-szolgáltatóhoz, mielőtt bárki valódinak küldenél.

Ne legyen szakadék a következő migráció

A platformmigráció azért érződik szakadéknak, mert a platform lett a nyilvántartás rendszere. A rendeléstörténet, a feliratkozói állapot és a kampányeredmények egyetlen szolgáltatón belül élnek, és a mozgatásuk kiürítés.

Az alternatíva az, hogy megtartod a saját igazságforrásodat, és hagyod, hogy a küldőplatform célállomás legyen, ne páncélterem. Ha az áruházi adataid, a hozzájárulási állapotod és az elköteleződési eseményeid folyamatosan szinkronizálódnak a saját rendszereidbe, akkor egy csatorna váltása vagy hozzáadása konfigurációs módosítás, nem projekt. Ezt a munkát végzi a Tajo a Brevo és a kereskedő eszközparkja között: mindkét irányban áramlásban tartja az adatokat, hogy a platform soha ne legyen az egyetlen példány.

Így vagy úgy, a fent leírt exportfeladatokat érdemes már most ütemezetten futtatni, függetlenül attól, tervezed-e a távozást. A legolcsóbb migráció az, amelynél az adat már kint van a platformról, mielőtt döntenél.