Εξαγωγή και μετάβαση δεδομένων Brevo: πώς να μεταφέρετε τα δεδομένα σας μέσα ή έξω

Ο όγκος αναζητήσεων για φράσεις όπως «brevo data export migration to another platform» τροφοδοτείται από μία ανησυχία: ότι τα δεδομένα που έχετε συσσωρεύσει μπαίνουν πιο εύκολα από όσο βγαίνουν. Η ειλικρινής απάντηση για το Brevo είναι ότι τα περισσότερα βγαίνουν καθαρά, κάποια βγαίνουν σε μορφή που πρέπει να ξαναχτίσετε και ένα μικρό αλλά σημαντικό μέρος δεν μπορεί να μετακινηθεί καθόλου.

Αυτός ο οδηγός καλύπτει και τις δύο κατευθύνσεις. Παραθέτει τι ακριβώς εξάγεται, τι όχι, τις κλήσεις API για λογαριασμούς πολύ μεγάλους για το περιβάλλον διαχείρισης, και μια λίστα ελέγχου μετάβασης που αντιμετωπίζει τις λίστες καταστολής και τη φήμη αποστολής ως ζητήματα πρώτης γραμμής και όχι ως εκ των υστέρων σκέψεις.

Τι μπορείτε πραγματικά να εξαγάγετε από το Brevo

Επαφές και χαρακτηριστικά

Η διαδρομή στο περιβάλλον διαχείρισης είναι CRM και μετά Contacts. Για να εξαγάγετε ολόκληρη τη βάση δεδομένων, βεβαιωθείτε ότι δεν έχει φορτωθεί λίστα ή τμήμα και ότι δεν εφαρμόζονται φίλτρα. Για να εξαγάγετε μία λίστα ή ένα τμήμα, πατήστε «Load a list or segment» και επιλέξτε το πρώτα.

Στη συνέχεια επιλέγετε ποια τυπικά και προσαρμοσμένα χαρακτηριστικά θα περιληφθούν. Το EMAIL, η ημερομηνία τελευταίας αλλαγής και η ημερομηνία δημιουργίας είναι επιλεγμένα εξ ορισμού, και τα υπόλοιπα τα προσθέτετε εσείς, που είναι το βήμα στο οποίο ο κόσμος σφάλλει πιο συχνά. Διαλέξτε τον διαχωριστή πεδίων CSV, ελληνικό ερωτηματικό ή κόμμα, και προαιρετικά ενεργοποιήστε το «Send export by email» ώστε ένας σύνδεσμος λήψης να πάει στη διεύθυνση του κατόχου του λογαριασμού. Πατήστε «Start export» και μετά κατεβάστε το αρχείο από το καμπανάκι ειδοποιήσεων δίπλα στο όνομα του λογαριασμού σας.

Λίστες και τμήματα

Οι λίστες εξάγονται ως συμμετοχή: τρέξτε μία εξαγωγή ανά λίστα, ή συμπεριλάβετε τα μεταδεδομένα _listIds σε μία ενιαία πλήρη εξαγωγή και χωρίστε το αρχείο μετά. Το GET /v3/contacts/lists σας δίνει τα ονόματα, τα id και τα id φακέλων των λιστών ώστε να αναδημιουργήσετε τη δομή στην άλλη πλευρά.

Τα τμήματα είναι διαφορετική ιστορία, και εδώ είναι το πρώτο πραγματικό κενό. Το GET /v3/contacts/segments επιστρέφει μόνο id, segmentName, categoryName και updatedAt. Οι συνθήκες φίλτρου που ορίζουν ένα τμήμα δεν εκτίθενται. Μπορείτε να εξαγάγετε τα μέλη ενός τμήματος σε μια δεδομένη στιγμή, αλλά ο κανόνας που τα παρήγαγε πρέπει να διαβαστεί από την οθόνη και να ξαναχτιστεί με το χέρι στο νέο εργαλείο. Τραβήξτε στιγμιότυπο οθόνης από κάθε τμήμα πριν ακυρώσετε τον λογαριασμό.

Στατιστικά καμπανιών

Από μια αναφορά καμπάνιας μπορείτε να εξαγάγετε τα δεδομένα ως CSV, ενώ οι αναφορές email και SMS προσφέρουν επίσης έκδοση PDF για κοινοποίηση ή εκτύπωση. Για πλήρη ιστορική άντληση, το GET /v3/emailCampaigns δέχεται παράμετρο statistics με τιμές globalStats, linksStats ή statsByDomain, καθώς και ένα ζεύγος startDate και endDate που καλύπτει διάστημα έως δύο ετών.

Transactional αρχεία καταγραφής

Δύο διαδρομές, με διαφορετικά παράθυρα.

Το GET /v3/smtp/statistics/events επιστρέφει μεμονωμένα συμβάντα φιλτραρισμένα ανά τύπο (delivered, opened, clicks, hardBounces, spam, unsubscribed και άλλα). Το εύρος ημερομηνιών δεν μπορεί να ξεπερνά τις 90 ημέρες, και εξ ορισμού καλύπτει τις τελευταίες 30 ημέρες αν δεν δώσετε ούτε εύρος ούτε την παράμετρο days.

Για μαζική άντληση, το POST /v3/webhooks/export δημιουργεί εργασία εξαγωγής για τις τελευταίες 7 ημέρες ακατέργαστων συμβάντων, με όριο 20 εργασίες εξαγωγής ανά περίοδο 7 ημερών. Επιστρέφει ένα processId, καλεί το notify URL σας όταν τελειώσει και παραδίδει CSV με στήλες που περιλαμβάνουν date, email, event, message-id, reason, sending_ip, subject, tag και template_id. Οι μεγάλοι όγκοι φτάνουν ως συμπιεσμένο αρχείο με αρκετά CSV.

Η πρακτική συνέπεια: αν θέλετε περισσότερες από 90 ημέρες transactional ιστορικού, έπρεπε να το εξάγετε προγραμματισμένα από την αρχή. Στήστε αυτή την εργασία τώρα, όχι την εβδομάδα που θα αποφασίσετε να φύγετε.

Τι δεν έρχεται μαζί σας

Αυτό είναι το μέρος που οι περισσότεροι οδηγοί μετάβασης παραλείπουν.

• Δομές ροών εργασίας αυτοματοποίησης. Το API μπορεί να ενεργοποιεί αυτοματοποιήσεις μέσω συμβάντων, αλλά δεν υπάρχει τεκμηριωμένο endpoint που να διαβάζει πίσω τους κλάδους, τις καθυστερήσεις και τις συνθήκες μιας ροής εργασίας. Κάθε ροή εργασίας ξαναχτίζεται χειροκίνητα στη νέα πλατφόρμα.
• Ορισμοί φίλτρων τμημάτων. Όπως παραπάνω, ανακτώνται μόνο τα ονόματα και τα τρέχοντα μέλη.
• Πλήρες ιστορικό αλληλεπίδρασης ανά επαφή. Μπορείτε να εξαγάγετε όσους άνοιξαν, έκαναν κλικ, δεν άνοιξαν, απεγγράφηκαν ή έκαναν hard ή soft bounce σε μια συγκεκριμένη καμπάνια, χρησιμοποιώντας το customContactFilter στο endpoint εξαγωγής. Αυτό που δεν μπορείτε να αντλήσετε είναι ένα ενιαίο τακτοποιημένο αρχείο με «κάθε άνοιγμα και κάθε κλικ που έκανε ποτέ αυτή η επαφή», επειδή τα endpoints ακατέργαστων συμβάντων περιορίζονται στις 90 ημέρες.
• Πιστότητα απόδοσης προτύπων. Το htmlContent εξάγεται καθαρά, αλλά τα μπλοκ μεταφοράς και απόθεσης, η σύνταξη των merge tags και τα σύμβολα κράτησης θέσης για τους συνδέσμους απεγγραφής είναι ειδικά ανά πλατφόρμα. Ο κώδικας HTML που εξάγετε είναι αφετηρία, όχι ολοκληρωμένο πρότυπο. Προϋπολογίστε χρόνο για να δοκιμάσετε ξανά κάθε πρότυπο στον νέο επεξεργαστή.
• Φήμη παραδοσιμότητας. Η φήμη αποστολέα ζει στις IP αποστολής και στο ταυτοποιημένο domain. Νέα πλατφόρμα, νέα δεξαμενή IP, νέα προθέρμανση. Η διατήρηση του ίδιου domain και της ίδιας διαμόρφωσης DKIM διατηρεί την πλευρά της φήμης που αφορά το domain, κάτι που βοηθά πραγματικά, αλλά δεν μεταφέρει την πλευρά της IP.
• Αναγνωριστικά φορμών, σελίδων προορισμού και παρακολούθησης. Οι φόρμες εγγραφής, οι σελίδες προορισμού και το script παρακολούθησης έχουν όλα αναγνωριστικά ειδικά ανά πλατφόρμα. Οτιδήποτε είναι ενσωματωμένο στον ιστότοπό σας πρέπει να αντικατασταθεί, και κάθε αναλυτικό δεδομένο συνδεδεμένο με αυτά τα αναγνωριστικά σπάει κατά τη μετάβαση.

Εξαγωγή με script για μεγάλους λογαριασμούς

Πάνω από περίπου 100.000 επαφές η εξαγωγή από το περιβάλλον διαχείρισης γίνεται αργή και δύσχρηστη, και ούτως ή άλλως θέλετε μια επαναλήψιμη εργασία. Το endpoint εξαγωγής επαφών είναι ασύγχρονο: δέχεται ένα φίλτρο, επιστρέφει ένα process id και σας παραδίδει ένα 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"
  }'

Μια επιτυχημένη κλήση επιστρέφει HTTP 202 και ένα σώμα που περιέχει ένα processId. Το exportMandatoryAttributes είναι εξ ορισμού true και καλύπτει τα EMAIL, ADDED_TIME και MODIFIED_TIME, οπότε στο exportAttributes ονομάζετε τα προσαρμοσμένα σας πεδία. Ο ορισμός του exportSubscriptionStatus είναι αυτό που βάζει την κατάσταση συγκατάθεσης μάρκετινγκ για email και SMS μέσα στο αρχείο, και η παράλειψή του είναι ο πιο συνηθισμένος τρόπος με τον οποίο παράγεται μια εξαγωγή άχρηστη για συμμορφούμενη μετάβαση.

Αν προτιμάτε να διατρέξετε εγγραφές σελίδα σελίδα αντί να περιμένετε μια εργασία, το GET /v3/contacts δέχεται limit έως 1000 μαζί με offset, καθώς και modifiedSince και createdSince για σταδιακές αντλήσεις. Κάθε επαφή επιστρέφει με emailBlacklisted, smsBlacklisted, listIds, listUnsubscribed και consentGroups, που είναι όλα όσα χρειάζεστε για να ανασυνθέσετε την κατάσταση συγκατάθεσης.

Προσέχετε τα όρια ρυθμού όσο γράφετε το script. Τα endpoints επαφών επιτρέπουν 36.000 αιτήματα ανά ώρα και 10 ανά δευτερόλεπτο στα τυπικά πακέτα, διπλάσια στα επίπεδα Professional και Enterprise, ενώ τα περισσότερα άλλα endpoints βρίσκονται στα 100 αιτήματα ανά ώρα. Η διάτρεξη ενός εκατομμυρίου επαφών με 1000 ανά σελίδα είναι 1000 αιτήματα, άνετα μέσα στο όριο των επαφών, αλλά το σφυροκόπημα endpoints καμπανιών ή προτύπων μέσα σε βρόχο δεν είναι.

Γιατί η λίστα καταστολής σας πρέπει να μεταφερθεί πρώτη

Μετακινήστε τις απεγγραφές πριν μετακινήσετε οτιδήποτε άλλο.

Το νομικό επιχείρημα είναι απλό. Μια επαφή που απεγγράφηκε απέσυρε τη συγκατάθεση από τη δική σας μάρκα. Αυτή η απόσυρση δεν μηδενίζεται επειδή αλλάξατε προμηθευτή. Υπό τον GDPR η καταγραφή της συγκατάθεσης και της απόσυρσής της είναι δική σας υποχρέωση ως υπευθύνου επεξεργασίας, ενώ υπό τον CAN-SPAM μια εξαίρεση πρέπει να τηρηθεί εντός δέκα εργάσιμων ημερών και παραμένει σε ισχύ επ’ αόριστον. Η απώλεια της λίστας σε μια μετάβαση δεν είναι τεχνικό ατύχημα, είναι αστοχία συμμόρφωσης με χαρτιά που δείχνουν σε εσάς.

Το επιχείρημα της παραδοσιμότητας είναι στην πράξη χειρότερο. Οι κατεσταλμένες διευθύνσεις είναι δυσανάλογα άνθρωποι που υπέβαλαν καταγγελία, έκαναν hard bounce ή ήθελαν ενεργά να φύγουν. Το να τους στείλετε από μια ολοκαίνουργια IP χωρίς φήμη είναι ο ταχύτερος γνωστός τρόπος να δείτε μια νέα διάταξη αποστολής να στραγγαλίζεται ή να μπλοκάρεται μέσα στην πρώτη της εβδομάδα. Μερικές χιλιάδες ανακυκλωμένες παγίδες spam και παραπονούμενοι μπορούν να αναιρέσουν έναν μήνα προσεκτικής προθέρμανσης.

Εξαγάγετε λοιπόν ρητά τις κατεσταλμένες ομάδες αντί να ελπίζετε ότι υπονοούνται. Στο endpoint εξαγωγής, το actionForContacts δέχεται unsubscribed για επαφές αποκλεισμένες με οποιονδήποτε τρόπο και unsubscribedPerList για επαφές που εξαιρέθηκαν από μία συγκεκριμένη λίστα. Κάντε ξεχωριστό πέρασμα για hardBounces ανά καμπάνια. Κατά την είσοδο σε νέα πλατφόρμα, εισαγάγετε αυτό το αρχείο στη λίστα καταστολής της, όχι σε λίστα αποστολών.

Το Brevo χειρίζεται και την αντίστροφη περίπτωση: υποστηρίζει την εισαγωγή λίστας αποκλεισμένων επαφών, και το API εισαγωγής δέχεται τις τιμές emailBlacklist και smsBlacklist ώστε ένα εισαγόμενο αρχείο να προσγειώνεται ως κατεσταλμένο. Σημειώστε την ασυμμετρία που το Brevo σωστά επιβάλλει: οι επαφές δεν μπορούν να αφαιρεθούν μαζικά από τη λίστα αποκλεισμού, επειδή η μαζική επανεγγραφή κάποιου που ζήτησε να τον αφήσουν ήσυχο θα ήταν παράνομη. Η καταστολή προστίθεται εύκολα και εσκεμμένα αφαιρείται δύσκολα. Θεωρήστε το σωστή συμπεριφορά, όχι εμπόδιο.

Λίστα ελέγχου μετάβασης, έξω από το Brevo

1. Καταγραφή. Μετρήστε επαφές, λίστες, τμήματα, ενεργές αυτοματοποιήσεις, πρότυπα και ενσωματώσεις. Σημειώστε ποιες ενσωματώσεις γράφουν μέσα στο Brevo, επειδή αυτοί είναι οι σωλήνες που θα χρειαστεί να ανακατευθύνετε.
2. Εξαγωγή. Επαφές με όλα τα χαρακτηριστικά συν την κατάσταση συνδρομής, ένα αρχείο ανά λίστα ή ένα ενιαίο αρχείο που φέρει _listIds, ομάδες καταστολής ως ξεχωριστά αρχεία, στατιστικά καμπανιών, transactional συμβάντα όσο πίσω επιτρέπει το παράθυρο των 90 ημερών, και τον κώδικα HTML των προτύπων.
3. Αρχειοθετήστε ό,τι λήγει. Ό,τι είναι χρονικά περιορισμένο (ακατέργαστα συμβάντα, αρχεία καταγραφής) χάνεται μόλις κυλήσει το παράθυρο. Αποθηκεύστε το τώρα στη δική σας αποθήκη δεδομένων ή σε αποθήκευση αντικειμένων.
4. Καθαρισμός και αντιστοίχιση. Αφαιρέστε διπλότυπα, κανονικοποιήστε μορφές ημερομηνίας και τηλεφώνου και γράψτε ρητή αντιστοίχιση στηλών προς πεδία για τη νέα πλατφόρμα. Είναι επίσης η φυσική στιγμή να διώξετε διευθύνσεις που δεν έχουν αλληλεπιδράσει εδώ και έναν χρόνο, κάτι φθηνότερο από το να πληρώνετε για την προθέρμανση νεκρού βάρους. Ο οδηγός μας για τον καθαρισμό λιστών email καλύπτει τα κατώφλια.
5. Φορτώστε πρώτα την καταστολή. Εισαγάγετε τις απεγγραφές και τα hard bounces στη λίστα καταστολής της νέας πλατφόρμας, επαληθεύστε ότι οι αριθμοί ταιριάζουν με την εξαγωγή σας, και μόνο τότε φορτώστε τις επαφές στις οποίες θα στέλνετε.
6. Προθέρμανση. Ξεκινήστε με το πιο ενεργό σας τμήμα, αυξήστε τον όγκο σταδιακά και παρακολουθείτε καθημερινά τα ποσοστά bounce και καταγγελιών. Ο οδηγός μας για την παραδοσιμότητα email έχει τη σειρά με λεπτομέρεια.
7. Παράλληλη λειτουργία. Κρατήστε το Brevo ζωντανό και να στέλνει την κρίσιμη transactional αλληλογραφία σας ενώ η νέα πλατφόρμα αναλαμβάνει ένα αυξανόμενο μερίδιο των αποστολών μάρκετινγκ. Μην αλλάξετε και τα δύο ταυτόχρονα.
8. Επαλήθευση. Συμφωνήστε τους αριθμούς επαφών, ελέγξτε δειγματοληπτικά είκοσι επαφές πεδίο προς πεδίο, επιβεβαιώστε ότι οι κατεσταλμένες επαφές είναι όντως κατεσταλμένες επιχειρώντας μια δοκιμαστική αποστολή, και συγκρίνετε μία εβδομάδα όγκου αποστολών με την παλιά πλατφόρμα.
9. Μετάβαση με σχέδιο επαναφοράς. Αλλάξτε το DNS και τα endpoints ενσωμάτωσης σε χρονικό παράθυρο όπου κάποιος παρακολουθεί. Κρατήστε τον λογαριασμό Brevo ενεργό και πληρωμένο για τουλάχιστον έναν πλήρη κύκλο χρέωσης μετά τη μετάβαση, με τα εξαγόμενα αρχεία αποθηκευμένα εκτός και των δύο πλατφορμών. Αυτό, και όχι μια υπόσχεση προμηθευτή, είναι το πραγματικό σας σχέδιο επαναφοράς.

Μετάβαση προς το Brevo από άλλη πλατφόρμα

Η ίδια λίστα ελέγχου τρέχει αντίστροφα, με τρεις σημειώσεις ειδικά για το Brevo.

Ζητήστε πραγματική εξαγωγή από τον υφιστάμενο πάροχο. Οι περισσότερες πλατφόρμες θα σας δώσουν τις επαφές και τα προσαρμοσμένα πεδία τους ως CSV. Ζητήστε ρητά τη λίστα καταστολής και τη λίστα bounce, που συχνά βρίσκονται σε ξεχωριστή εξαγωγή την οποία ο κόσμος ξεχνά να ζητήσει. Αν έρχεστε από μοντέλο τιμολόγησης ανά επαφή, συγκρίνετε τι θα πληρώνετε στην πραγματικότητα με τον οδηγό μας για την τιμολόγηση του Brevo.

Αντιστοιχίστε τα πεδία πριν ανεβάσετε. Τα χαρακτηριστικά του Brevo έχουν τύπους (κείμενο, αριθμός, ημερομηνία, boolean, κατηγορία), και μια ημερομηνία που προσγειώνεται σε χαρακτηριστικό κειμένου δεν θα είναι φιλτραρίσιμη αργότερα. Δημιουργήστε πρώτα τα χαρακτηριστικά με τους σωστούς τύπους και μετά κάντε εισαγωγή.

Κάντε εισαγωγή μέσω του API για οτιδήποτε μεγάλο. Το POST /v3/contacts/import δέχεται ενσωματωμένο CSV στο fileBody, πίνακα JSON στο jsonBody, και τα δύο με όριο περίπου 10 MB, ή απομακρυσμένο αρχείο μέσω fileUrl, καθώς και listIds ή ένα αντικείμενο newList. Το updateExistingContacts είναι εξ ορισμού true και αντιστοιχίζει με βάση το email. Τρέξτε μία εισαγωγή με το emailBlacklist σε true για το αρχείο καταστολής σας, και μετά μια δεύτερη εισαγωγή για τις επαφές στις οποίες θα στέλνετε. Τα πλήρη λειτουργικά scripts βρίσκονται στον οδηγό μας για την εισαγωγή επαφών CSV στο Brevo με script.

Στη συνέχεια ξαναχτίστε ό,τι δεν μεταφέρθηκε: αυτοματοποιήσεις, τμήματα, φόρμες και πρότυπα. Στείλτε μια δοκιμαστική αποστολή σε μια χούφτα παρόχων εισερχομένων πριν στείλετε σε οποιονδήποτε πραγματικό παραλήπτη.

Μην αφήσετε την επόμενη μετάβαση να γίνει γκρεμός

Ο λόγος που μια μετάβαση πλατφόρμας μοιάζει με γκρεμό είναι ότι η πλατφόρμα έχει γίνει το σύστημα καταγραφής. Το ιστορικό παραγγελιών, η κατάσταση συνδρομητών και τα αποτελέσματα καμπανιών ζουν μέσα σε έναν προμηθευτή, και η μετακίνησή τους σημαίνει εκκένωση.

Η εναλλακτική είναι να κρατάτε τη δική σας πηγή αλήθειας και να αφήνετε την πλατφόρμα αποστολής να είναι προορισμός και όχι θησαυροφυλάκιο. Αν τα δεδομένα του καταστήματός σας, η κατάσταση συγκατάθεσης και τα συμβάντα αλληλεπίδρασης συγχρονίζονται συνεχώς στα δικά σας συστήματα, η αλλαγή ή η προσθήκη ενός καναλιού γίνεται αλλαγή ρύθμισης αντί για έργο. Αυτή είναι η δουλειά που κάνει το Tajo ανάμεσα στο Brevo και τη στοίβα ενός εμπόρου: κρατά τα δεδομένα να ρέουν και προς τις δύο κατευθύνσεις ώστε η πλατφόρμα να μην είναι ποτέ το μοναδικό αντίγραφο.

Έτσι κι αλλιώς, οι εργασίες εξαγωγής που περιγράφονται παραπάνω αξίζει να τρέχουν προγραμματισμένα από τώρα, ανεξάρτητα από το αν σχεδιάζετε να φύγετε. Η φθηνότερη μετάβαση είναι εκείνη όπου τα δεδομένα βρίσκονται ήδη εκτός πλατφόρμας όταν το αποφασίσετε.