On this page

Braze コネクター

Braze エンゲージメントプラットフォームを Brevo に接続し、統合された顧客プロファイル、クロスチャネルキャンペーンオーケストレーション、一元化されたマーケティングアナリティクスを実現します。

概要

項目値
プラットフォームBraze
カテゴリーマーケティング
セットアップ難易度中程度
公式統合なし
同期データ顧客、イベント、キャンペーン、メッセージ
API タイプREST API
認証API キー
ベース URLhttps://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 への接続

Terminal window
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/trackPOSTユーザー属性、イベント、購入を送信
/users/export/idsPOST外部 ID でユーザープロファイルをエクスポート
/users/export/segmentPOSTセグメントからユーザーをエクスポート
/campaigns/listGETキャンペーン一覧を取得
/campaigns/data_seriesGET時系列キャンペーン分析
/canvas/listGETCanvas フロー一覧を取得
/canvas/data_seriesGET時系列 Canvas 分析
/segments/listGETセグメント一覧を取得
/email/statusPOSTメール購読ステータスを変更
/subscription/status/setPOST購読グループステータスを設定
/catalogs/{catalog_name}/itemsGETカタログアイテムを取得

コード例

コネクターの初期化 

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 はプランとインスタンスに応じたレート制限を適用します。

プランレート制限バースト制限
Starter250,000 リクエスト/時なし
Pro250,000 リクエスト/時なし
Enterpriseカスタムカスタム

/users/track エンドポイントには既定で 1 分あたり 50,000 リクエストの制限があります。Tajo は指数バックオフによるレート制限処理を自動的に実行します。

バッチリクエスト

Tajo はレート制限内でスループットを最大化するため、/users/track リクエストごとに最大 75 件のユーザー属性、75 件のイベント、75 件の購入をまとめます。

トラブルシューティング

よくある問題

問題原因解決策
401 UnauthorizedAPI キーが無効または期限切れBraze ダッシュボードで API キーを再生成
ユーザーが同期されないインスタンス URL が誤っているBraze インスタンス URL を確認 (例: iad-01、iad-02)
属性が不足しているAPI キーのスコープが狭すぎるAPI キーに必要な権限を追加
レート制限超過並列リクエストが多すぎるバッチサイズまたは同期頻度を下げる
イベントが遅延エクスポートキューが大きいフルエクスポートではなく増分同期を使用

デバッグモード 

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

接続テスト

Terminal window
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 コールをログ記録

関連リソース

Subscribe to updates

developer-docs

Drop your email or phone number — we'll send you what matters next.

auto-detect
AIアシスタント

こんにちは！ドキュメントについて何でもお聞きください。