---
title: "Braze 连接器"
description: "完整的 Braze 集成指南，通过 Tajo 将客户参与数据、营销活动和消息事件与 Brevo 同步。"
url: https://tajo.io/zh-cn/docs/connectors/marketing/braze/
markdown: https://tajo.io/zh-cn/docs/connectors/marketing/braze.md
lang: zh-CN
robots: noindex
---

申请抢先体验

请输入您的名字和公司电子邮箱地址。我们会发送确认 Tajo 访问申请的链接。

# Braze 连接器

连接器状态: 计划中 尚未构建。Tajo 目前不运行此连接器。

| 来源字段 | 目标字段 | 示例值 |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

将您的 Braze 参与平台连接到 Brevo，实现统一的客户档案、跨渠道营销活动编排以及整合的营销分析。

## 概览

| 属性 | 值 |
| --- | --- |
| **平台** | Braze |
| **类别** | 营销 |
| **设置复杂度** | 中等 |
| **官方集成** | 否 |
| **同步数据** | 客户、事件、营销活动、消息 |
| **API 类型** | REST API |
| **认证方式** | API 密钥 |
| **基础 URL** | `https://rest.iad-XX.braze.com`（实例专属） |

## 功能

- **用户档案同步** - Braze 和 Brevo 之间的双向客户属性同步
- **营销活动事件跟踪** - 跟踪邮件打开、点击、转化和退订
- **Canvas 流程数据** - 同步多步骤营销旅程数据，用于统一报告
- **细分镜像** - 将 Braze 细分复制为 Brevo 列表，实现跨平台定向
- **推送通知事件** - 将推送参与数据转发到 Brevo 联系人时间线
- **目录同步** - 同步产品目录，用于个性化推荐

## 前提条件

开始之前，请确保您已具备：

1. 已启用 API 访问权限的 Braze 账户
2. 具有适当权限的 Braze REST API 密钥
3. 您的 Braze 实例 URL（例如 `rest.iad-01.braze.com`）
4. 具有 API 访问权限的 Brevo 账户
5. 具有有效订阅的 Tajo 账户

## 认证

Braze 使用 API 密钥认证。每个 API 密钥可以限定在特定端点范围内。

### 创建 API 密钥

1. 登录您的 Braze 仪表板
2. 导航到**设置** > **API 密钥**
3. 点击**创建新 API 密钥**
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 密钥安全

请安全存储您的 Braze API 密钥。切勿在客户端代码或公共代码仓库中暴露它。Tajo 使用 AES-256 对所有 API 凭据进行静态加密。

### 连接到 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 端点

Tajo 集成以下 Braze REST API 端点：

| 端点 | 方法 | 用途 |
| --- | --- | --- |
| `/users/track` | POST | 发送用户属性、事件和购买记录 |
| `/users/export/ids` | POST | 按外部 ID 导出用户档案 |
| `/users/export/segment` | POST | 从细分导出用户 |
| `/campaigns/list` | GET | 检索营销活动列表 |
| `/campaigns/data_series` | GET | 随时间变化的营销活动分析 |
| `/canvas/list` | GET | 检索 Canvas 流程列表 |
| `/canvas/data_series` | GET | 随时间变化的 Canvas 分析 |
| `/segments/list` | GET | 检索细分列表 |
| `/email/status` | POST | 更改邮件订阅状态 |
| `/subscription/status/set` | POST | 设置订阅组状态 |
| `/catalogs/{catalog_name}/items` | GET | 检索目录项目 |

## 代码示例

### 初始化连接器

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

### 跟踪自定义事件

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

### 导出细分数据

```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 根据您的计划和实例实施速率限制：

| 计划 | 速率限制 | 突发限制 |
| --- | --- | --- |
| **Starter** | 250,000 请求/小时 | 无 |
| **Pro** | 250,000 请求/小时 | 无 |
| **Enterprise** | 自定义 | 自定义 |

`/users/track` 端点的默认限制为每分钟 50,000 次请求。Tajo 自动使用指数退避处理速率限制。

批量请求

Tajo 每次 `/users/track` 请求最多批量处理 75 个用户属性、75 个事件和 75 个购买记录，在速率限制内最大化吞吐量。

## 故障排除

### 常见问题

| 问题 | 原因 | 解决方案 |
| --- | --- | --- |
| 401 Unauthorized | API 密钥无效或已过期 | 在 Braze 仪表板中重新生成 API 密钥 |
| 用户未同步 | 实例 URL 错误 | 验证您的 Braze 实例 URL（例如 iad-01、iad-02） |
| 属性缺失 | API 密钥范围过窄 | 向 API 密钥添加所需权限 |
| 超出速率限制 | 并发请求过多 | 减小批次大小或同步频率 |
| 事件延迟 | 大型导出队列 | 使用增量同步代替完整导出 |

### 调试模式

```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. **使用增量同步** - 避免完整导出；仅同步自上次同步以来的变更记录
2. **批量用户更新** - 将属性变更分组，最小化 API 调用
3. **缩小 API 密钥范围** - 仅启用集成所需的权限
4. **监控速率限制** - 在达到 Braze 速率限制前设置警告
5. **一致映射外部 ID** - 在 Braze 和 Brevo 中使用相同的标识符
6. **先在沙盒中测试** - 生产部署前使用 Braze 测试工作区

## 安全

- **API 密钥认证** - 具有细粒度权限的限定 API 密钥
- **仅 HTTPS** - 所有 API 通信通过 TLS 1.2+ 加密
- **IP 白名单** - Braze 中可选的 API 访问 IP 限制
- **加密存储** - API 凭据在 Tajo 中静态加密
- **审计日志** - 所有 API 调用均记录日志以供合规审查

## 相关资源

- [Customer.io 连接器](https://tajo.io/zh-cn/docs/connectors/marketing/customerio)
- [Iterable 连接器](https://tajo.io/zh-cn/docs/connectors/marketing/iterable)
- [客户同步技能](https://tajo.io/zh-cn/docs/skills/data-sync/customer-sync)
- [Brevo 联系人 API](https://tajo.io/zh-cn/docs/contact-management)