การส่งออกข้อมูลและการย้ายข้อมูล 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 ให้ชื่อรายชื่อ รหัส และรหัสโฟลเดอร์ เพื่อให้คุณสร้างโครงสร้างเดิมขึ้นใหม่ที่ปลายทางได้

เซกเมนต์ต่างออกไป และนี่คือช่องว่างจริงข้อแรก GET /v3/contacts/segments คืนค่าเพียง id segmentName categoryName และ updatedAt เงื่อนไขตัวกรองที่นิยามเซกเมนต์ไม่ได้ถูกเปิดเผยออกมา คุณส่งออก สมาชิก ของเซกเมนต์ ณ เวลาหนึ่งได้ แต่กฎที่ผลิตสมาชิกชุดนั้นต้องอ่านจากหน้าจอแล้วสร้างขึ้นใหม่ด้วยมือในเครื่องมือใหม่ ให้ถ่ายภาพหน้าจอทุกเซกเมนต์ไว้ก่อนยกเลิกบัญชี

สถิติแคมเปญ

จากรายงานแคมเปญ คุณส่งออกข้อมูลเป็น CSV ได้ และรายงานอีเมลกับ SMS ยังมีเวอร์ชัน PDF สำหรับแชร์หรือพิมพ์ สำหรับการดึงข้อมูลย้อนหลังทั้งหมด GET /v3/emailCampaigns รับพารามิเตอร์ statistics ที่มีค่า globalStats linksStats หรือ statsByDomain พร้อมคู่ startDate และ endDate ที่ครอบคลุมช่วงเวลาได้สูงสุดสองปี

ล็อกของอีเมลธุรกรรม

มีสองเส้นทาง ซึ่งมีหน้าต่างเวลาต่างกัน

GET /v3/smtp/statistics/events คืนอีเวนต์รายตัวโดยกรองตามประเภท (delivered opened clicks hardBounces spam unsubscribed และอื่น ๆ) ช่วงวันที่ต้องไม่เกิน 90 วัน และหากคุณไม่ระบุทั้งช่วงเวลาและพารามิเตอร์ days ระบบจะใช้ค่าเริ่มต้นเป็น 30 วันล่าสุด

สำหรับการดึงแบบกลุ่ม 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 วัน คุณต้องส่งออกมันตามตารางเวลามาตลอดตั้งแต่แรก ให้ตั้งงานนั้นตั้งแต่ตอนนี้ ไม่ใช่ในสัปดาห์ที่คุณตัดสินใจย้ายออก

สิ่งที่ไม่ตามคุณไป

นี่คือส่วนที่คู่มือการย้ายข้อมูลส่วนใหญ่ข้ามไป

• โครงสร้างเวิร์กโฟลว์ระบบอัตโนมัติ API เรียกระบบอัตโนมัติผ่านอีเวนต์ได้ แต่ไม่มี endpoint ในเอกสารที่อ่านกิ่งเงื่อนไข การหน่วงเวลา และเงื่อนไขของเวิร์กโฟลว์กลับออกมาได้ ทุกเวิร์กโฟลว์ต้องสร้างใหม่ด้วยมือในแพลตฟอร์มใหม่
• นิยามตัวกรองของเซกเมนต์ เช่นเดียวกับข้างต้น ดึงได้เพียงชื่อและสมาชิกปัจจุบันเท่านั้น
• ประวัติการมีส่วนร่วมรายผู้ติดต่อแบบครบถ้วน คุณส่งออกผู้เปิด ผู้คลิก ผู้ไม่เปิด ผู้ยกเลิกรับข่าวสาร ผู้ตีกลับถาวร หรือผู้ตีกลับชั่วคราวของแคมเปญหนึ่ง ๆ ได้โดยใช้ customContactFilter บน endpoint ส่งออก สิ่งที่ดึงไม่ได้คือไฟล์เดียวที่รวบรวมทุกการเปิดและทุกการคลิกที่ผู้ติดต่อคนหนึ่งเคยทำ เพราะ endpoint อีเวนต์ดิบถูกจำกัดที่ 90 วัน
• ความเที่ยงตรงของการเรนเดอร์เทมเพลต htmlContent ส่งออกได้สะอาด แต่บล็อกแบบลากวาง ไวยากรณ์ merge tag และตัวยึดตำแหน่งลิงก์ยกเลิกรับข่าวสารล้วนขึ้นกับแพลตฟอร์ม HTML ที่คุณส่งออกคือจุดตั้งต้น ไม่ใช่เทมเพลตที่เสร็จแล้ว เผื่อเวลาไว้ทดสอบทุกเทมเพลตใหม่ในตัวแก้ไขของแพลตฟอร์มใหม่
• ชื่อเสียงด้านการส่งถึงกล่องขาเข้า ชื่อเสียงผู้ส่งอยู่ที่ IP ที่ใช้ส่งและโดเมนที่ยืนยันตัวตนแล้ว แพลตฟอร์มใหม่คือพูล IP ใหม่และการอุ่นเครื่องใหม่ การใช้โดเมนและการตั้งค่า DKIM เดิมช่วยรักษาชื่อเสียงฝั่งโดเมนไว้ ซึ่งช่วยได้จริง แต่ไม่ได้พาฝั่ง IP ไปด้วย
• ตัวระบุของฟอร์ม แลนดิงเพจ และการติดตาม ฟอร์มสมัคร แลนดิงเพจ และสคริปต์ติดตามล้วนมีรหัสเฉพาะของแพลตฟอร์ม ทุกอย่างที่ฝังอยู่บนเว็บไซต์ของคุณต้องถูกเปลี่ยน และการวิเคราะห์ใด ๆ ที่ผูกกับรหัสเหล่านั้นจะพังตอนย้ายระบบ

การส่งออกด้วยสคริปต์สำหรับบัญชีขนาดใหญ่

เมื่อเกินราว 100,000 ผู้ติดต่อ การส่งออกผ่านหน้าจอจะช้าและใช้งานยาก และคุณก็ต้องการงานที่ทำซ้ำได้อยู่แล้ว endpoint ส่งออกผู้ติดต่อทำงานแบบอะซิงโครนัส คือรับตัวกรอง คืนรหัสกระบวนการ แล้วส่ง 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 คือสิ่งที่ทำให้สถานะยินยอมรับการตลาดของอีเมลและ SMS ลงไปในไฟล์ และการละเลยมันคือวิธีที่พบบ่อยที่สุดในการผลิตไฟล์ส่งออกที่ใช้ย้ายข้อมูลอย่างถูกกฎหมายไม่ได้

หากคุณอยากไล่อ่านทีละหน้ามากกว่ารอผลงาน GET /v3/contacts รับ limit ได้สูงสุด 1000 พร้อม offset และมี modifiedSince กับ createdSince สำหรับการดึงแบบเพิ่มทีละส่วน ผู้ติดต่อแต่ละรายกลับมาพร้อม emailBlacklisted smsBlacklisted listIds listUnsubscribed และ consentGroups ซึ่งเพียงพอสำหรับประกอบสถานะความยินยอมขึ้นใหม่

ระวังขีดจำกัดอัตราขณะเขียนสคริปต์นี้ endpoint ของผู้ติดต่อรองรับ 36,000 คำขอต่อชั่วโมงและ 10 คำขอต่อวินาทีบนแพ็กเกจมาตรฐาน และเพิ่มเป็นสองเท่าบนระดับ Professional และ Enterprise ในขณะที่ endpoint อื่นส่วนใหญ่อยู่ที่ 100 คำขอต่อชั่วโมง การไล่อ่านผู้ติดต่อหนึ่งล้านรายที่หน้าละ 1000 คือ 1000 คำขอ ซึ่งอยู่ในงบของผู้ติดต่ออย่างสบาย แต่การกระหน่ำเรียก endpoint ของแคมเปญหรือเทมเพลตวนซ้ำนั้นไม่ใช่

ทำไมรายชื่อระงับการส่งต้องย้ายเป็นอันดับแรก

ย้ายรายชื่อผู้เลือกไม่รับก่อนย้ายอย่างอื่นทั้งหมด

ข้อโต้แย้งทางกฎหมายนั้นง่าย ผู้ติดต่อที่ยกเลิกรับข่าวสารได้ถอนความยินยอมจาก แบรนด์ของคุณ การถอนนั้นไม่รีเซ็ตเพียงเพราะคุณเปลี่ยนผู้ให้บริการ ภายใต้ GDPR บันทึกความยินยอมและการถอนความยินยอมเป็นภาระของคุณในฐานะผู้ควบคุมข้อมูล และภายใต้ CAN-SPAM การเลือกไม่รับต้องได้รับการปฏิบัติตามภายในสิบวันทำการและมีผลตลอดไป การทำรายชื่อนี้หายระหว่างย้ายข้อมูลไม่ใช่อุบัติเหตุทางเทคนิค แต่เป็นความล้มเหลวด้านการปฏิบัติตามกฎที่มีหลักฐานชี้มาที่คุณ

ข้อโต้แย้งด้านการส่งถึงกล่องขาเข้าแย่กว่าในทางปฏิบัติ ที่อยู่ที่ถูกระงับการส่งมักเป็นคนที่ร้องเรียน ตีกลับถาวร หรือต้องการออกจริงจังในสัดส่วนที่สูงผิดปกติ การส่งหาพวกเขาจาก IP ใหม่เอี่ยมที่ยังไม่มีชื่อเสียงคือวิธีที่รู้กันว่าเร็วที่สุดในการทำให้ระบบส่งใหม่ถูกจำกัดหรือถูกบล็อกภายในสัปดาห์แรก แค่กับดักสแปมและผู้ร้องเรียนไม่กี่พันรายก็ล้มการอุ่นเครื่องที่ทำมาทั้งเดือนได้

ดังนั้นให้ส่งออกกลุ่มที่ถูกระงับอย่างชัดเจน แทนที่จะหวังว่ามันจะรวมมาโดยปริยาย บน endpoint ส่งออก actionForContacts รับค่า unsubscribed สำหรับผู้ติดต่อที่ถูกบล็อกด้วยวิธีใดก็ตาม และ unsubscribedPerList สำหรับผู้ติดต่อที่เลือกไม่รับจากรายชื่อหนึ่งโดยเฉพาะ ให้ทำอีกรอบแยกต่างหากสำหรับ hardBounces รายแคมเปญ ส่วนตอนนำเข้าแพลตฟอร์มใหม่ ให้นำไฟล์นั้นเข้ารายชื่อระงับการส่ง ไม่ใช่รายชื่อที่ส่งได้

Brevo จัดการกรณีย้อนกลับด้วยเช่นกัน โดยรองรับการนำเข้ารายชื่อผู้ติดต่อที่ถูกบล็อก และ API นำเข้ารับค่าบูลีน emailBlacklist กับ smsBlacklist เพื่อให้ไฟล์ที่นำเข้าลงเอยในสถานะระงับการส่ง สังเกตความไม่สมมาตรที่ Brevo บังคับอย่างถูกต้อง คือไม่สามารถปลดบล็อกผู้ติดต่อแบบกลุ่มได้ เพราะการสมัครรับข่าวสารให้คนที่ขอให้เลิกยุ่งกับเขาแบบกลุ่มนั้นผิดกฎหมาย การระงับการส่งเพิ่มได้ง่ายและถูกออกแบบให้ถอดออกยาก ให้ถือว่านั่นคือพฤติกรรมที่ถูกต้อง ไม่ใช่อุปสรรค

รายการตรวจสอบการย้ายข้อมูลออกจาก Brevo

1. ตรวจนับ นับจำนวนผู้ติดต่อ รายชื่อ เซกเมนต์ ระบบอัตโนมัติที่ยังทำงาน เทมเพลต และการเชื่อมต่อ จดไว้ว่าการเชื่อมต่อใดเขียนข้อมูลเข้า Brevo เพราะนั่นคือท่อที่คุณต้องต่อใหม่
2. ส่งออก ผู้ติดต่อพร้อมแอตทริบิวต์ทั้งหมดและสถานะการสมัครรับข่าวสาร หนึ่งไฟล์ต่อหนึ่งรายชื่อหรือไฟล์เดียวที่มี _listIds กลุ่มระงับการส่งเป็นไฟล์แยก สถิติแคมเปญ อีเวนต์ของอีเมลธุรกรรมย้อนหลังเท่าที่หน้าต่าง 90 วันเอื้อ และ HTML ของเทมเพลต
3. เก็บถาวรสิ่งที่จะหมดอายุ ทุกอย่างที่มีกรอบเวลา เช่นอีเวนต์ดิบและล็อก จะหายไปเมื่อหน้าต่างเลื่อนผ่าน ให้เก็บไว้ในคลังข้อมูลหรือที่เก็บออบเจกต์ของคุณเองตั้งแต่ตอนนี้
4. ทำความสะอาดและจับคู่ฟิลด์ ตัดข้อมูลซ้ำ ปรับรูปแบบวันที่และเบอร์โทรให้เป็นมาตรฐานเดียวกัน และเขียนแผนที่จับคู่คอลัมน์กับฟิลด์ของแพลตฟอร์มใหม่อย่างชัดเจน นี่ยังเป็นจังหวะเหมาะที่จะตัดที่อยู่ที่ไม่มีการมีส่วนร่วมมาหนึ่งปีทิ้ง ซึ่งถูกกว่าการจ่ายเงินอุ่นเครื่องน้ำหนักที่ไม่มีชีวิต คู่มือทำความสะอาดรายชื่ออีเมล ของเราอธิบายเกณฑ์ไว้แล้ว
5. โหลดรายชื่อระงับการส่งก่อน นำเข้ารายชื่อผู้เลือกไม่รับและผู้ตีกลับถาวรเข้าสู่รายชื่อระงับการส่งของแพลตฟอร์มใหม่ ตรวจว่าจำนวนตรงกับไฟล์ส่งออกของคุณ แล้วจึงค่อยโหลดผู้ติดต่อที่ส่งได้
6. อุ่นเครื่อง เริ่มจากกลุ่มลูกค้าที่มีส่วนร่วมมากที่สุด ค่อย ๆ เพิ่มปริมาณ และดูอัตราตีกลับกับอัตราร้องเรียนทุกวัน คู่มือการส่งอีเมลถึงกล่องขาเข้า ของเรามีลำดับขั้นตอนโดยละเอียด
7. รันคู่ขนาน ให้ Brevo ยังทำงานและส่งอีเมลธุรกรรมสำคัญของคุณต่อไป ระหว่างที่แพลตฟอร์มใหม่รับส่วนแบ่งการส่งการตลาดเพิ่มขึ้นเรื่อย ๆ อย่าสลับทั้งสองอย่างพร้อมกัน
8. ตรวจสอบ กระทบยอดจำนวนผู้ติดต่อ สุ่มตรวจผู้ติดต่อยี่สิบรายทีละฟิลด์ ยืนยันว่าผู้ติดต่อที่ถูกระงับถูกระงับจริงด้วยการลองส่งทดสอบ และเทียบปริมาณการส่งหนึ่งสัปดาห์กับแพลตฟอร์มเดิม
9. ย้ายระบบและเตรียมทางถอย เปลี่ยน DNS และ endpoint ของการเชื่อมต่อในช่วงเวลาที่มีคนเฝ้าดู เก็บบัญชี Brevo ไว้และจ่ายค่าบริการต่ออีกอย่างน้อยหนึ่งรอบบิลเต็มหลังย้ายระบบ พร้อมเก็บไฟล์ที่ส่งออกไว้นอกทั้งสองแพลตฟอร์ม นั่นคือแผนถอยกลับจริงของคุณ ไม่ใช่คำสัญญาของผู้ให้บริการ

การย้ายเข้า Brevo จากแพลตฟอร์มอื่น

รายการตรวจสอบชุดเดิมใช้ย้อนกลับได้ โดยมีข้อสังเกตเฉพาะของ Brevo สามข้อ

ขอไฟล์ส่งออกจริงจากผู้ให้บริการเดิม แพลตฟอร์มส่วนใหญ่จะให้ผู้ติดต่อและฟิลด์ที่กำหนดเองเป็น CSV ให้ขอรายชื่อระงับการส่งและรายชื่อตีกลับอย่างเจาะจง เพราะมักอยู่ในไฟล์ส่งออกคนละชุดที่คนลืมขอ หากคุณมาจากโมเดลราคาแบบคิดตามผู้ติดต่อ ให้เทียบว่าคุณจะจ่ายจริงเท่าไรตอนย้ายเข้ากับ คู่มือราคา Brevo ของเรา

จับคู่ฟิลด์ก่อนอัปโหลด แอตทริบิวต์ของ Brevo มีชนิดข้อมูล (ข้อความ ตัวเลข วันที่ บูลีน หมวดหมู่) และวันที่ที่ลงไปในแอตทริบิวต์ชนิดข้อความจะกรองไม่ได้ในภายหลัง ให้สร้างแอตทริบิวต์ด้วยชนิดที่ถูกต้องก่อน แล้วจึงนำเข้า

นำเข้าผ่าน API สำหรับอะไรก็ตามที่ปริมาณมาก POST /v3/contacts/import รับ CSV แบบอินไลน์ใน fileBody อาร์เรย์ JSON ใน jsonBody ซึ่งทั้งคู่จำกัดราว 10 MB หรือไฟล์ระยะไกลผ่าน fileUrl พร้อม listIds หรือออบเจกต์ newList ค่า updateExistingContacts เป็น true โดยค่าเริ่มต้นและจับคู่ด้วยอีเมล ให้รันการนำเข้าครั้งแรกโดยตั้ง emailBlacklist เป็น true สำหรับไฟล์ระงับการส่งของคุณ แล้วจึงรันการนำเข้าครั้งที่สองสำหรับผู้ติดต่อที่ส่งได้ สคริปต์ที่ใช้งานได้จริงทั้งชุดอยู่ในคู่มือ การนำเข้าผู้ติดต่อ CSV สู่ Brevo ด้วยสคริปต์ ของเรา

จากนั้นจึงสร้างสิ่งที่ย้ายมาไม่ได้ขึ้นใหม่ ทั้งระบบอัตโนมัติ เซกเมนต์ ฟอร์ม และเทมเพลต ส่งอีเมลทดสอบไปยังผู้ให้บริการกล่องขาเข้าจำนวนหนึ่งก่อนส่งหาคนจริง

อย่าให้การย้ายข้อมูลครั้งหน้าเป็นหน้าผา

เหตุผลที่การย้ายแพลตฟอร์มรู้สึกเหมือนหน้าผา คือแพลตฟอร์มได้กลายเป็นแหล่งข้อมูลหลักไปแล้ว ประวัติคำสั่งซื้อ สถานะผู้ติดตาม และผลลัพธ์แคมเปญอยู่ในผู้ให้บริการรายเดียว และการย้ายมันออกก็เท่ากับการอพยพ

ทางเลือกอีกทางคือเก็บแหล่งข้อมูลหลักไว้ที่ตัวคุณเอง แล้วให้แพลตฟอร์มส่งข้อความเป็นปลายทาง ไม่ใช่ห้องนิรภัย หากข้อมูลร้านค้า สถานะความยินยอม และอีเวนต์การมีส่วนร่วมของคุณถูกซิงค์เข้าสู่ระบบของคุณเองอย่างต่อเนื่อง การเปลี่ยนหรือเพิ่มช่องทางก็กลายเป็นการเปลี่ยนการตั้งค่า ไม่ใช่โครงการใหญ่ นั่นคืองานที่ Tajo ทำระหว่าง Brevo กับสแตกของร้านค้า คือทำให้ข้อมูลไหลสองทางเพื่อให้แพลตฟอร์มไม่เคยเป็นสำเนาเดียวที่มีอยู่

ไม่ว่าจะทางไหน งานส่งออกที่อธิบายไว้ข้างต้นก็คุ้มค่าที่จะรันตามตารางเวลาตั้งแต่ตอนนี้ ไม่ว่าคุณจะวางแผนย้ายออกหรือไม่ การย้ายข้อมูลที่ถูกที่สุดคือครั้งที่ข้อมูลอยู่นอกแพลตฟอร์มอยู่แล้วตอนคุณตัดสินใจ