Twilio Segment コネクタ

Tajo を介して Twilio Segment を Brevo に接続し、顧客データパイプラインを統合し、任意のソースから Brevo にイベントをルーティングし、Segment の ID 解決を活用してより豊かなマーケティング自動化を実現します。

概要

プロパティ
プラットフォームTwilio Segment
カテゴリデータプラットフォーム(カスタム)
セットアップの複雑さ
公式統合いいえ
同期データイベント、顧客、Traits、オーディエンス
利用可能なスキル8

機能

  • ユニバーサルデータ収集 - Segment SDK 経由で Web サイト、モバイルアプリ、サーバーからイベントを収集
  • ソースルーティング - Tajo を介して 400 以上のソースから Brevo にデータをルーティング
  • ID 解決 - 匿名および既知のユーザープロファイルを自動マージ
  • オーディエンス同期 - Segment の計算済み Traits およびオーディエンスを Brevo リストに送信
  • イベントストリーミング - Segment の Connections フレームワーク経由でリアルタイムイベント転送
  • リバース ETL - Segment リバース ETL を使用してウェアハウスデータを Brevo に戻す
  • スキーマ強制 - 同期前に Segment Protocols でイベントスキーマを検証

前提条件

開始する前に、以下を準備してください。

  1. ソース設定済みの Twilio Segment ワークスペース
  2. ソース用の Segment Write Key
  3. API アクセス可能な Brevo アカウント
  4. API 認証情報を持つ Tajo アカウント

認証

Segment Write Key

Segment は各ソースに紐付く一意識別子である Write Key を使用してソースを認証します。

// Write Key を使用した Analytics.js の初期化
analytics.load("YOUR_SEGMENT_WRITE_KEY");

Tajo API トークン

Tajo コネクタを資格情報で設定します。

Terminal window
tajo connectors install segment \
--write-key $SEGMENT_WRITE_KEY \
--workspace-slug your-workspace \
--brevo-api-key $BREVO_API_KEY

設定

基本セットアップ

connectors:
segment:
enabled: true
write_key: "your-segment-write-key"
data_region: "us" # または EU ワークスペースの場合は "eu"
# データ同期オプション
sync:
identify: true
track: true
page: true
group: false
# Brevo リストの割り当て
lists:
all_contacts: 5
active_users: 6
high_value: 7

イベントマッピング

Segment の track イベントを Brevo イベントタイプにマッピングします。

event_mapping:
# Segment イベント -> Brevo イベント
"Order Completed": "order_completed"
"Product Viewed": "product_viewed"
"Cart Updated": "cart_updated"
"Signed Up": "customer_created"
"Checkout Started": "checkout_started"
# カスタムイベント
"Feature Used": "feature_used"
"Plan Upgraded": "plan_upgraded"

Traits マッピング

Segment の identify Traits を Brevo 連絡先属性にマッピングします。

trait_mapping:
email: email
firstName: FIRSTNAME
lastName: LASTNAME
phone: SMS
plan: PLAN_TYPE
company: COMPANY
createdAt: SIGNUP_DATE
lifetimeValue: LTV

API エンドポイント

メソッドエンドポイント説明
POST/v1/identifyTraits 付きでユーザーを識別
POST/v1/trackイベントをトラッキング
POST/v1/pageページビューを記録
POST/v1/screen画面ビューを記録
POST/v1/groupユーザーをグループに関連付け
POST/v1/alias2 つのユーザー ID をマージ
POST/v1/batch複数メッセージをバッチで送信
POST/v1/import履歴データを一括インポート

コード例

Tajo 送信先を使用した Segment の初期化

import { TajoClient } from '@tajo/sdk';
const tajo = new TajoClient({
apiKey: process.env.TAJO_API_KEY,
brevoApiKey: process.env.BREVO_API_KEY
});
// Segment ソースを接続
await tajo.connectors.connect('segment', {
writeKey: process.env.SEGMENT_WRITE_KEY,
workspaceSlug: 'your-workspace'
});

Segment でイベントをトラッキング

// ユーザーを識別 - Brevo 連絡先に同期
analytics.identify("user_123", {
firstName: "Jane",
lastName: "Kim",
plan: "premium",
lifetimeValue: 450.00
});
// イベントをトラッキング - Brevo に転送
analytics.track("Order Completed", {
orderId: "ORD-1234",
revenue: 89.99,
currency: "USD",
products: [
{ id: "SKU-001", name: "Widget", price: 89.99 }
]
});
// ページビュートラッキング
analytics.page("Pricing", {
title: "Pricing - Tajo",
url: "https://tajo.io/pricing"
});

サーバーサイドイベント転送(Node.js)

const Analytics = require('analytics-node');
const analytics = new Analytics(process.env.SEGMENT_WRITE_KEY);
// データベースからユーザーをバッチで識別
const users = await db.query('SELECT * FROM users WHERE updated_at > $1', [lastSync]);
for (const user of users) {
analytics.identify({
userId: user.id,
traits: {
email: user.email,
firstName: user.first_name,
lastName: user.last_name,
totalOrders: user.order_count,
lifetimeValue: user.ltv
}
});
}
// キューをフラッシュ
await analytics.flush();

レート制限

プラン制限ウィンドウ
Free1,000 イベント/秒ソース単位
Team10,000 イベント/秒ソース単位
Businessカスタムワークスペース単位
Batch API最大 500 KBリクエスト単位
最大バッチサイズ100 イベントバッチ呼び出し単位

バッチサイズ制限

各バッチリクエストには最大 100 イベントを含められ、500 KB を超えてはいけません。大規模な履歴インポートには Segment Bulk Import API を使用してください。

トラブルシューティング

問題原因解決策
Brevo にイベントが表示されない送信先が有効化されていないSegment で Tajo 送信先を有効化
ユーザー Traits が同期されないメール識別子の欠落identify 呼び出しに email Trait を含める
重複した連絡先複数の匿名 IDID マージのため適切な alias 呼び出しを実装
イベント遅延大量のキューSegment のイベント配信ダッシュボードを確認
スキーマ違反計画外のイベントSegment Protocols のトラッキングプランを確認
429 レート制限エラーリクエスト過多バッチ処理を実装またはイベント頻度を削減

ベストプラクティス

  1. track の前に identify を使用する - イベントが正しいユーザーに帰属するよう、track の前に常に identify を呼び出す
  2. トラッキングプランを実装する - Segment Protocols を使用してイベントスキーマを強制
  3. サーバーサイド呼び出しをバッチ処理する - HTTP オーバーヘッドを削減するためサーバーサイド統合に batch API を使用
  4. Traits を明示的にマッピングする - デフォルトに依存せず、Trait から属性へのマッピングを定義
  5. Segment Functions を使用する - Brevo に到達する前にイベントを変換
  6. イベント配信を監視する - 失敗したイベントについて Segment の Event Delivery ダッシュボードを確認
  7. Replay を設定する - 履歴イベントの再処理のため Segment Replay を有効化

セキュリティ

  • TLS 暗号化 - すべてのデータは HTTPS/TLS 1.2 以上で送信
  • Write Key の分離 - 各ソースに独自の Write Key
  • GDPR コンプライアンス - Segment はデータ削除および抑制リクエストをサポート
  • SOC 2 Type II - Segment は SOC 2 Type II 認証取得済み
  • リージョナルデータホスティング - データレジデンシーコンプライアンスのため EU ワークスペースオプション

関連リソース

Subscribe to updates

developer-docs

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

auto-detect
AIアシスタント

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