---
title: "Braze Connector"
description: "คู่มือการผสานรวม Braze ฉบับสมบูรณ์สำหรับการซิงค์ข้อมูล customer engagement แคมเปญ และเหตุการณ์การส่งข้อความกับ Brevo ผ่าน Tajo"
url: https://tajo.io/th/docs/connectors/marketing/braze/
markdown: https://tajo.io/th/docs/connectors/marketing/braze.md
lang: th-TH
robots: noindex
---

ขอสิทธิ์ใช้งานล่วงหน้า

กรอกชื่อและที่อยู่อีเมลที่ทำงานของคุณ เราจะส่งลิงก์เพื่อยืนยันคำขอเข้าใช้งาน Tajo ทางอีเมล

# Braze Connector

สถานะตัวเชื่อม: วางแผนไว้ ยังไม่ได้สร้าง ปัจจุบัน Tajo ยังไม่ได้ใช้งานตัวเชื่อมนี้

| ฟิลด์ต้นทาง | ฟิลด์ปลายทาง | ค่าตัวอย่าง |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

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

## ภาพรวม

| คุณสมบัติ | ค่า |
| --- | --- |
| **แพลตฟอร์ม** | Braze |
| **หมวดหมู่** | การตลาด |
| **ความซับซ้อนในการตั้งค่า** | ปานกลาง |
| **การผสานรวมอย่างเป็นทางการ** | ไม่ |
| **ข้อมูลที่ซิงค์** | ลูกค้า เหตุการณ์ แคมเปญ ข้อความ |
| **ประเภท API** | REST API |
| **การยืนยันตัวตน** | API Key |
| **Base URL** | `https://rest.iad-XX.braze.com` (เฉพาะ instance) |

## ฟีเจอร์

- **การซิงค์โปรไฟล์ผู้ใช้** - การซิงค์แอตทริบิวต์ลูกค้าแบบ 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
```

ความปลอดภัย API Key

เก็บ Braze API key ของคุณอย่างปลอดภัย อย่าเปิดเผยในโค้ดฝั่ง client หรือ repositories สาธารณะ Tajo เข้ารหัสข้อมูลประจำตัว API ทั้งหมดที่เก็บด้วย AES-256

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

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

## การกำหนดค่า

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

```yaml
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:

```yaml
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 ต่อไปนี้:

| Endpoint | เมธอด | จุดประสงค์ |
| --- | --- | --- |
| `/users/track` | POST | ส่งแอตทริบิวต์ผู้ใช้ เหตุการณ์ และการซื้อ |
| `/users/export/ids` | POST | ส่งออกโปรไฟล์ผู้ใช้โดย external IDs |
| `/users/export/segment` | POST | ส่งออกผู้ใช้จาก segment |
| `/campaigns/list` | GET | ดึงรายการแคมเปญ |
| `/campaigns/data_series` | GET | Campaign analytics ตามเวลา |
| `/canvas/list` | GET | ดึงรายการ Canvas flows |
| `/canvas/data_series` | GET | Canvas analytics ตามเวลา |
| `/segments/list` | GET | ดึงรายการ segments |
| `/email/status` | POST | เปลี่ยนสถานะ email subscription |
| `/subscription/status/set` | POST | ตั้งสถานะ subscription group |
| `/catalogs/{catalog_name}/items` | GET | ดึงรายการแคตาล็อก |

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

### เริ่มต้น Connector

```javascript
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'
});
```

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

```javascript
// 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

```javascript
// 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

```javascript
// 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 ของคุณ:

| แผน | ขีดจำกัดอัตรา | ขีดจำกัด Burst |
| --- | --- | --- |
| **Starter** | 250,000 คำขอ/ชั่วโมง | ไม่มี |
| **Pro** | 250,000 คำขอ/ชั่วโมง | ไม่มี |
| **Enterprise** | กำหนดเอง | กำหนดเอง |

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

Batch Requests

Tajo batches สูงสุด 75 user attributes, 75 events และ 75 purchases ต่อคำขอ `/users/track` เพื่อเพิ่มประสิทธิภาพภายใน rate limits

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

### ปัญหาทั่วไป

| ปัญหา | สาเหตุ | วิธีแก้ |
| --- | --- | --- |
| 401 Unauthorized | API key ไม่ถูกต้องหรือหมดอายุ | สร้าง API key ใหม่ใน Braze dashboard |
| ผู้ใช้ไม่ซิงค์ | Instance URL ไม่ถูกต้อง | ตรวจสอบ Braze instance URL ของคุณ (เช่น iad-01, iad-02) |
| แอตทริบิวต์หายไป | ขอบเขต API key แคบเกินไป | เพิ่มสิทธิ์ที่จำเป็นใน API key |
| เกิน rate limit | คำขอพร้อมกันมากเกินไป | ลดขนาด batch หรือความถี่การซิงค์ |
| เหตุการณ์ล่าช้า | คิวการส่งออกขนาดใหญ่ | ใช้ incremental sync แทน full export |

### โหมด Debug

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

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

```bash
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](https://tajo.io/th/docs/connectors/marketing/customerio)
- [Iterable Connector](https://tajo.io/th/docs/connectors/marketing/iterable)
- [Customer Sync Skill](https://tajo.io/th/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/th/docs/contact-management)