---
title: "Twilio Segment コネクタ"
description: "Tajo を介して Twilio Segment の顧客データ、イベント、オーディエンスセグメントを Brevo と同期するための完全な Twilio Segment 統合ガイド。"
url: https://tajo.io/jp/docs/connectors/custom/segment/
markdown: https://tajo.io/jp/docs/connectors/custom/segment.md
lang: ja-JP
robots: noindex
---

先行利用を申し込む

お名前と会社のメールアドレスを入力してください。Tajoへのアクセス申請を確認するためのリンクをメールでお送りします。

# Twilio Segment コネクタ

コネクターのステータス: 予定 まだ構築されていません。Tajo は現在このコネクターを実行していません。

| 送信元フィールド | 送信先フィールド | サンプル値 |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

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 を使用してソースを認証します。

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

### Tajo API トークン

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

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

## 設定

### 基本セットアップ

```yaml
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 イベントタイプにマッピングします。

```yaml
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 連絡先属性にマッピングします。

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

## API エンドポイント

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

## コード例

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

```javascript
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 でイベントをトラッキング

```javascript
// ユーザーを識別 - Brevo 連絡先に同期
analytics.identify("user_123", {
  email: "jane@example.com",
  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)

```javascript
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();
```

## レート制限

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

バッチサイズ制限

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

## トラブルシューティング

| 問題 | 原因 | 解決策 |
| --- | --- | --- |
| Brevo にイベントが表示されない | 送信先が有効化されていない | Segment で Tajo 送信先を有効化 |
| ユーザー Traits が同期されない | メール識別子の欠落 | identify 呼び出しに `email` Trait を含める |
| 重複した連絡先 | 複数の匿名 ID | ID マージのため適切な `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 ワークスペースオプション

## 関連リソース

- [Amplitude コネクタ](https://tajo.io/jp/docs/connectors/custom/amplitude)
- [Mixpanel コネクタ](https://tajo.io/jp/docs/connectors/custom/mixpanel)
- [顧客同期スキル](https://tajo.io/jp/docs/skills/data-sync/customer-sync)
- [Brevo Events API](https://tajo.io/jp/docs/events-engagement/create-event)