> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Segment イベントストリーミング

> Kameleoon の実験露出イベントをサーバーサイドから Segment に自動ストリーミングし、ユーザー行動アナリティクスを強化して、データを下流のツールにルーティングします。

<Note>
  この機能はオープンベータ版であり、現在活発に開発中です。この統合に関するサポートが必要な場合は、[Kameleoon サポートチーム](https://www.kameleoon.com/en/contact) にお問い合わせください。
</Note>

Kameleoon Segment イベントストリーミング統合により、Kameleoon 実験のいずれかに訪問者が露出するたびに、Segment アカウントに自動的にイベントを送信できます。この統合により、Segment での充実したアナリティクスが可能になり、実験への露出に関するインサイトを提供することで、ユーザー行動とエンゲージメントをより深く理解できます。

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/integrations/as-a-destination/cdp/segment-event-streaming/data-flow.png)
</Frame>

この統合では、Kameleoon のイベントディスパッチャーを使用して、[Segment HTTP API](https://segment.com/docs/connections/sources/catalog/libraries/server/http-api/) の `/batch` エンドポイント経由で、Segment アカウントにサーバーサイドイベントをバッチで送信します。

## 主なメリット

* **正確な行動インサイト:** この統合は、アプリなどの SDK ベースのプロジェクトでウェブ実験やフィーチャーフラグに露出した訪問者について、特定のイベントをサードパーティのツールに送信します。この詳細なトラッキングにより、異なるバリエーションがユーザーアクションにどのように影響するかを明確に把握できます。たとえば、どのバリエーションがクリック数、コンバージョン、その他の望ましい成果をより多く促進するかを観察し、最も効果的なアプローチを判断できます。
* **リアルタイムの意思決定:** この統合はリアルタイムでデータを提供し、状況に応じた意思決定を可能にします。進行中の実験に関する最新のインサイトを得て、バリエーションが期待どおりに機能していない場合に戦略を迅速に調整できます。
* **手間のかからないセットアップ:** Kameleoon アプリから直接サードパーティ統合を有効にでき、カスタムコードや SDK の変更は不要です。

## 留意事項

Kameleoon のサーバーは、最低 30 分の遅延で Segment にイベントを送信します。

この統合を構成するには、以下が必要です。

* **Kameleoon SDK:** サーバーサイドのプロジェクトに Kameleoon SDK がインストールされている必要があります。
* **Write Key:** Segment の [Write Key](https://segment.com/docs/connections/find-writekey/)（Kameleoon イベント用に新しい Segment ソースを作成することを推奨しますが、既存のキーも使用できます）。
* **ワークスペースの所在地:** Segment ワークスペースが EU にあるかどうかを指定します。この情報は Segment ワークスペースの設定で確認できます。

## セットアップ

この統合は、Web 実験および Feature 実験で有効化できます。

### Web 実験の場合

1. **Admin** > **Integrations** をクリックします。
2. Segment のカード右側のダウンロードアイコンをクリックします。
3. Segment を設定するプロジェクトを選択し、**Validate** をクリックします。
4. 最終化フローの **Integrations** タブで Segment を追加します。

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/integrations/as-a-destination/cdp/segment-event-streaming/finalization.png)
</Frame>

### Feature 実験の場合

1. フィーチャーフラグを編集するか、[新しいものを作成](../../../../experimentation/feature-experimentation/create-and-manage-flags/create-a-feature-flag) します。
2. **Reporting** で **Integrations** をクリックします。
3. 必要な環境すべてで Segment を **on** に切り替えます。

統合が有効化され、実験が公開されると、訪問者が露出されるたびに Kameleoon は Segment に実験イベントを送信し始めます。これらのイベントには、次のような主要な詳細が含まれます。

* ユーザー ID
* 露出時刻
* Kameleoon 実験 ID
* Kameleoon バリアント ID

## イベントペイロードの例

Kameleoon は次の形式で Segment にイベントを送信します。

```javascript theme={null}
{
"userId": "xf54dd2thdd5",
"event": "[Company] Experiment",
"properties": 
{ 
"experimentId": 12345,
"variationId": 15685 
},
"timestamp": 1730194985000
}
```

デフォルトでは、`userId` には訪問者の Kameleoon 訪問者コードが含まれます。Kameleoon の [クロスデバイス整合性調整](../../../../faq#how-do-i-activate-cross-device-history-reconciliation) を設定している場合、訪問者コードの代わりに、クロスデバイス整合性調整カスタムデータに設定された識別子が使用されます。

なお、Segment イベントに通常含まれる組織固有のカスタムデータは、Kameleoon がサーバーから送信するイベントには含まれません。
