---
title: "Trình Kết Nối Braze"
description: "Hướng dẫn tích hợp Braze đầy đủ để đồng bộ user profiles, campaigns, canvases và engagement events với Brevo qua Tajo."
url: https://tajo.io/vi/docs/connectors/marketing/braze/
markdown: https://tajo.io/vi/docs/connectors/marketing/braze.md
lang: vi-VN
robots: noindex
---

Đăng ký quyền truy cập sớm

Nhập tên và địa chỉ email công việc của bạn. Chúng tôi sẽ gửi liên kết để xác nhận yêu cầu truy cập Tajo.

# Trình Kết Nối Braze

Trạng thái trình kết nối: Dự kiến Chưa được xây dựng. Hiện Tajo chưa chạy trình kết nối này.

| Trường nguồn | Trường đích | Giá trị mẫu |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

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

| Thuộc Tính | Giá Trị |
| --- | --- |
| **Nền Tảng** | Braze |
| **Danh Mục** | Marketing |
| **Độ Phức Tạp Thiết Lập** | Trung Bình |
| **Tích Hợp Chính Thức** | Không |
| **Dữ Liệu Đồng Bộ** | Users, Campaigns, Canvases, Sự Kiện |
| **Loại API** | REST API |
| **Xác Thực** | API Key |

## 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

```bash
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.

Bảo Mật API Key

Mỗi Braze API key có thể được hạn chế theo IP và endpoint. Tạo key chuyên dụng cho Tajo với quyền tối thiểu và bật IP allowlisting cho bảo mật tối đa.

#### 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

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

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

| Phương Thức | Endpoint | Mô Tả |
| --- | --- | --- |
| `POST` | `/users/export/ids` | Export users theo IDs |
| `POST` | `/users/export/segment` | Export users trong segment |
| `GET` | `/campaigns/list` | Liệt kê campaigns |
| `GET` | `/campaigns/data_series` | Số liệu campaign theo thời gian |
| `GET` | `/canvas/list` | Liệt kê canvases |
| `GET` | `/segments/list` | Liệt kê segments |
| `POST` | `/users/track` | Track user events và attributes |

## Ví Dụ Code

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

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

### Export Users Sang Brevo

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

Batch Requests

Braze User Track API chấp nhận tối đa 75 events, 75 attribute updates và 75 purchases mỗi request. Tajo tự động chia thành lô phù hợp.

## Giới Hạn Tốc Độ

| Endpoint | Giới Hạn |
| --- | --- |
| `/users/track` | 50.000 yêu cầu/giờ |
| `/users/export/*` | 2.500 yêu cầu/ngày |
| `/campaigns/*` | 1.000 yêu cầu/giờ |

## Khắc Phục Sự Cố

| Sự Cố | Nguyên Nhân | Giải Pháp |
| --- | --- | --- |
| 401 Unauthorized | API key không hợp lệ | Xác minh key trong Braze Settings |
| Endpoint sai | REST endpoint không đúng region | Kiểm tra cluster Braze của bạn (iad-01, eu-01, v.v.) |
| Users không export | Segment rỗng | Xác minh segment có members trong Braze |

## Tài Nguyên Liên Quan

- [Tài Liệu API Braze](https://www.braze.com/docs/api/basics/)
- [Trình Kết Nối Iterable](https://tajo.io/vi/docs/connectors/marketing/iterable)
- [Customer Sync Skill](https://tajo.io/vi/docs/skills/data-sync/customer-sync)