Braze Connector

เชื่อมต่อ Braze engagement platform ของคุณกับ Brevo เพื่อโปรไฟล์ลูกค้าที่รวมกัน การประสานงานแคมเปญข้ามช่องทาง และ marketing analytics ที่รวมศูนย์

ภาพรวม

ฟีเจอร์

• การซิงค์โปรไฟล์ผู้ใช้ - การซิงค์แอตทริบิวต์ลูกค้าแบบ bidirectional ระหว่าง Braze และ Brevo
• การติดตามเหตุการณ์แคมเปญ - ติดตามการเปิดอีเมล คลิก conversions และการยกเลิกสมัคร
• ข้อมูล Canvas flow - ซิงค์ข้อมูล journey แคมเปญหลายขั้นตอนสำหรับรายงานที่รวมกัน
• การสะท้อน segment - จำลอง Braze segments เป็นรายการ Brevo สำหรับการกำหนดเป้าหมายข้ามแพลตฟอร์ม
• เหตุการณ์ push notification - ส่งต่อข้อมูล push engagement ไปยัง Brevo contact timelines
• การซิงค์แคตาล็อก - ซิงค์แคตาล็อกสินค้าสำหรับคำแนะนำที่เป็นส่วนตัว

ข้อกำหนดเบื้องต้น

ก่อนเริ่มต้น ตรวจสอบให้แน่ใจว่าคุณมี:

1. บัญชี Braze ที่เปิดใช้งาน API access
2. Braze REST API key ที่มีสิทธิ์ที่เหมาะสม
3. Braze instance URL ของคุณ (เช่น rest.iad-01.braze.com)
4. บัญชี Brevo ที่มีสิทธิ์เข้าถึง API
5. บัญชี Tajo ที่มีการสมัครสมาชิกที่ใช้งานอยู่

การยืนยันตัวตน

Braze ใช้การยืนยันตัวตนด้วย API key แต่ละ API key สามารถกำหนดขอบเขตสำหรับ endpoints เฉพาะได้

การสร้าง API Key

1. เข้าสู่ระบบ Braze dashboard ของคุณ
2. ไปที่ Settings > API Keys
3. คลิก Create New API Key
4. ตั้งชื่อว่า “Tajo Integration”
5. เปิดใช้งานสิทธิ์ต่อไปนี้:

users.track
users.export.ids
users.export.segment
campaigns.list
campaigns.data_series
canvas.list
canvas.data_series
segments.list
segments.data_series
email.status
subscription.status.set
catalogs.list_items

การเชื่อมต่อกับ Tajo

tajo connectors install braze \
  --api-key $BRAZE_API_KEY \
  --instance-url rest.iad-01.braze.com

การกำหนดค่า

การตั้งค่าพื้นฐาน

connectors:
  braze:
    enabled: true
    instance_url: "rest.iad-01.braze.com"
    api_version: "v1"

    sync:
      users: true
      campaigns: true
      canvases: true
      segments: true
      events: true

    lists:
      engaged_users: 10
      dormant_users: 11

การแมปฟิลด์

แมปแอตทริบิวต์ผู้ใช้ Braze กับแอตทริบิวต์ผู้ติดต่อ Brevo:

field_mapping:
  # Standard fields
  external_id: BRAZE_ID
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Engagement metrics
  total_revenue: TOTAL_REVENUE
  push_opted_in: PUSH_OPTIN
  email_subscribe: EMAIL_STATUS

  # Custom attributes
  loyalty_points: LOYALTY_POINTS
  last_app_version: APP_VERSION
  preferred_language: LANGUAGE

API Endpoints

Tajo ผสานรวมกับ Braze REST API endpoints ต่อไปนี้:

ตัวอย่างโค้ด

เริ่มต้น Connector

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

await tajo.connectors.connect('braze', {
  apiKey: process.env.BRAZE_API_KEY,
  instanceUrl: 'rest.iad-01.braze.com'
});

ซิงค์โปรไฟล์ผู้ใช้

// Sync Braze users to Brevo contacts
await tajo.connectors.sync('braze', {
  type: 'incremental',
  resources: ['users'],
  since: '2024-01-01',
  batchSize: 50
});

// Check sync status
const status = await tajo.connectors.status('braze');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T10:30:00Z',
//   usersCount: 45200,
//   campaignsTracked: 28,
//   eventsProcessed: 125000
// }

ติดตาม Custom Events

// Forward Braze events to Brevo
await tajo.connectors.handleEvent('braze', {
  type: 'user.event',
  payload: {
    external_id: 'user_12345',
    name: 'product_viewed',
    properties: {
      product_id: 'SKU-789',
      category: 'electronics',
      price: 299.99
    }
  }
});

ส่งออกข้อมูล Segment

// Export a Braze segment and create a Brevo list
const result = await tajo.connectors.exportSegment('braze', {
  segmentId: 'segment_abc123',
  targetList: 15,
  includeAttributes: ['email', 'first_name', 'last_name', 'total_revenue']
});

console.log(`Exported ${result.count} users to Brevo list 15`);

ขีดจำกัดอัตรา

Braze บังคับใช้ rate limits ตามแผนและ instance ของคุณ:

endpoint /users/track มีขีดจำกัดเริ่มต้น 50,000 คำขอต่อนาที Tajo จัดการ rate limiting โดยอัตโนมัติด้วย exponential backoff

การแก้ไขปัญหา

ปัญหาทั่วไป

โหมด Debug

connectors:
  braze:
    debug: true
    log_level: verbose
    log_api_calls: true

ทดสอบการเชื่อมต่อ

tajo connectors test braze
# ✓ API connection successful
# ✓ User export accessible
# ✓ Campaign data readable
# ✓ Segment list accessible
# ✓ Event tracking operational

แนวทางปฏิบัติที่ดีที่สุด

1. ใช้ incremental syncs - หลีกเลี่ยง full exports ซิงค์เฉพาะ records ที่เปลี่ยนแปลงตั้งแต่ sync ครั้งล่าสุด
2. Batch การอัปเดตผู้ใช้ - จัดกลุ่มการเปลี่ยนแปลงแอตทริบิวต์เพื่อลดการเรียก API
3. กำหนดขอบเขต API keys แคบ - เปิดใช้งานเฉพาะสิทธิ์ที่การผสานรวมของคุณต้องการ
4. ตรวจสอบ rate limits - ตั้งค่าการแจ้งเตือนก่อนถึง Braze rate limits
5. แมป external IDs อย่างสม่ำเสมอ - ใช้ตัวระบุเดียวกันทั้ง Braze และ Brevo
6. ทดสอบใน sandbox ก่อน - ใช้ Braze test workspace ก่อน deployment production

ความปลอดภัย

• การยืนยันตัวตนด้วย API Key - Scoped API keys พร้อมสิทธิ์แบบละเอียด
• HTTPS เท่านั้น - การสื่อสาร API ทั้งหมดเข้ารหัสผ่าน TLS 1.2+
• IP Allowlisting - การจำกัด IP เสริมสำหรับการเข้าถึง API ใน Braze
• การจัดเก็บที่เข้ารหัส - ข้อมูลประจำตัว API เข้ารหัสที่เก็บใน Tajo
• Audit Logging - การเรียก API ทั้งหมดถูกบันทึกสำหรับการตรวจสอบความสอดคล้อง

แหล่งข้อมูลที่เกี่ยวข้อง

• Customer.io Connector
• Iterable Connector
• Customer Sync Skill
• Brevo Contacts API