Braze 连接器

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

概览

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

功能

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

前提条件

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

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

认证

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

创建 API 密钥

登录您的 Braze 仪表板
导航到设置 > API 密钥
点击创建新 API 密钥
命名为”Tajo Integration”
启用以下权限：

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

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 端点

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	检索目录项目

代码示例

初始化连接器

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

跟踪自定义事件

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

导出细分数据

// 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 密钥添加所需权限
超出速率限制	并发请求过多	减小批次大小或同步频率
事件延迟	大型导出队列	使用增量同步代替完整导出

调试模式

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

最佳实践

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

安全

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

Braze 连接器

概览

功能

前提条件

认证

创建 API 密钥

连接到 Tajo

配置

基础设置

字段映射

API 端点

代码示例

初始化连接器

同步用户档案

跟踪自定义事件

导出细分数据

速率限制

故障排除

常见问题

调试模式

测试连接

最佳实践

安全

相关资源

Thanks — you're subscribed.

Braze 连接器

概览

功能

前提条件

认证

创建 API 密钥

连接到 Tajo

配置

基础设置

字段映射

API 端点

代码示例

初始化连接器

同步用户档案

跟踪自定义事件

导出细分数据

速率限制

故障排除

常见问题

调试模式

测试连接

最佳实践

安全

相关资源

Subscribe to updates

Thanks — you're subscribed.