Trình Kết Nối Braze

Kết nối Braze với Brevo qua Tajo để đồng bộ user profiles, campaign performance và engagement data, hợp nhất analytics cross-platform và kích hoạt workflows marketing phối hợp.

Tổng Quan

Tính Năng

• Đồng bộ user profiles - Nhập Braze user attributes sang liên hệ Brevo
• Số liệu campaign - Đồng bộ hiệu suất campaigns Braze sang Brevo
• Dữ liệu canvas - Theo dõi canvas journey completion events
• Custom events - Forward Braze custom events sang triggers Brevo
• Đồng bộ segment - Ánh xạ Braze segments sang danh sách Brevo
• Webhook Currents - Sử dụng Braze Currents cho streaming events theo thời gian thực

Yêu Cầu

Trước khi bắt đầu, hãy đảm bảo bạn có:

1. Tài khoản Braze (Starter, Professional, hoặc Enterprise)
2. REST API key với quyền phù hợp
3. Braze REST endpoint URL
4. Tài khoản Brevo với quyền truy cập API
5. Tài khoản Tajo

Xác Thực

REST API Key

curl "https://rest.iad-01.braze.com/users/export/ids" \
  -H "Authorization: Bearer YOUR_REST_API_KEY" \
  -H "Content-Type: application/json"

Tạo REST API keys trong Braze Settings > API Keys.

Quyền API Key Cần Thiết

users.export.ids
users.export.segment
campaigns.list
campaigns.data_series
canvas.list
canvas.data_summary
segments.list

Cấu Hình

Thiết Lập Cơ Bản

connectors:
  braze:
    enabled: true
    api_key: "${BRAZE_API_KEY}"
    rest_endpoint: "https://rest.iad-01.braze.com"

    sync:
      users: true
      campaigns: true
      canvases: false
      segments: true

    # Ánh xạ segment sang danh sách Brevo
    segment_mapping:
      "Active Users": 40
      "Power Users": 41
      "Churned": 42

Ánh Xạ Trường

field_mapping:
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS
  time_zone: TIMEZONE
  language: LANGUAGE

  # Thuộc tính Braze
  custom_attributes.plan: PLAN_TYPE
  custom_attributes.ltv: LIFETIME_VALUE
  custom_attributes.company: COMPANY_NAME
  custom_attributes.signup_date: SIGNUP_DATE

API Endpoints

Ví Dụ Code

Khởi Tạo Trình Kết Nối

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,
  restEndpoint: process.env.BRAZE_REST_ENDPOINT
});

Export Users Sang Brevo

// Đồng bộ Braze segment sang danh sách Brevo
await tajo.connectors.sync('braze', {
  type: 'segment',
  segmentId: 'segment_abc123',
  brevoListId: 40,
  includeCustomAttributes: true
});

Giới Hạn Tốc Độ

Khắc Phục Sự Cố

Tài Nguyên Liên Quan

• Tài Liệu API Braze
• Trình Kết Nối Iterable
• Customer Sync Skill