---
title: "Braze コネクター"
description: "Tajo を介して Braze の顧客エンゲージメントデータ、キャンペーン、メッセージングイベントを Brevo と同期するための完全統合ガイド。"
url: https://tajo.io/jp/docs/connectors/marketing/braze/
markdown: https://tajo.io/jp/docs/connectors/marketing/braze.md
lang: ja-JP
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. **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 キーのセキュリティ

Braze の API キーは安全に保管してください。クライアントサイドコードや公開リポジトリに決して公開しないでください。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 エンドポイント

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` エンドポイントには既定で 1 分あたり 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 制限が任意で利用可能
- **暗号化ストレージ** - Tajo 内で API 認証情報を保存時に暗号化
- **監査ログ** - コンプライアンスレビュー用にすべての API コールをログ記録

## 関連リソース

- [Customer.io コネクター](https://tajo.io/jp/docs/connectors/marketing/customerio)
- [Iterable コネクター](https://tajo.io/jp/docs/connectors/marketing/iterable)
- [顧客同期スキル](https://tajo.io/jp/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/jp/docs/contact-management)