> ## 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.
# Amplitude — イベントストリーミング
> Kameleoonの実験露出イベントをサーバーサイドからAmplitudeに自動ストリーミングし、バリエーション別のユーザー行動分析を充実させます。
Amplitudeイベントストリーミング統合は、訪問者がKameleoon実験に露出するたびに、Amplitudeアカウントへ自動的にイベントを送信します。この統合により、Amplitudeでの分析が強化され、実験露出に関する洞察を提供し、ユーザーの行動とエンゲージメントの理解を深めます。
この統合はKameleoonのイベントディスパッチャーを使用して、[Amplitude HTTP API](https://amplitude.com/docs/apis/analytics/http-v2) の `/import` エンドポイントを通じて、サーバーサイドのイベントをバッチ形式でAmplitudeアカウントへ送信します。
## 主なメリット
* **精密な行動洞察:** この統合は、SDKベースのプロジェクト（アプリなど）でWeb実験や機能フラグに露出した訪問者の特定のイベントを、サードパーティツールに送信します。この詳細な追跡により、異なるバリエーションがユーザー行動にどのように影響するかを明確に把握できます。例えば、どのバリエーションがより多くのクリック、コンバージョン、その他の望ましい結果をもたらすかを観察し、最も効果的なアプローチを判断できます。
* **リアルタイムの意思決定:** この統合はリアルタイムでデータを提供し、その場での意思決定を可能にします。実施中の実験に関する最新の洞察を活用して、バリエーションが期待通りに機能していない場合、戦略を迅速に調整できます。
* **簡単なセットアップ:** Kameleoonアプリから直接サードパーティ統合を有効化できます。カスタムコードやSDK変更は不要です。
## 考慮事項
* **イベント配信のタイミング:** Kameleoonサーバーは、最小30分の遅延でイベントを送信します。
## 前提条件
この統合を構成するには、以下の情報が必要です:
* **Amplitude APIキー:** Amplitudeプロジェクトの1つに固有のAPIキー（[こちら](https://amplitude.com/docs/apis/authentication)に文書化されています）
* **サーバーリージョン:** Amplitudeアカウントが標準ホスティングリージョン用に構成されているか、EUホスティング用に構成されているかを指定します。
* **Amplitudeプラン:** Amplitudeで購入した顧客プランの種類を選択します。
また、サーバーサイドプロジェクトに **Kameleoon SDK** がインストールされている必要があります。
## セットアップ
この統合は、**Web Experimentation** および **Feature Experimentation** で有効化できます。
### Web実験の場合
統合ページから統合を有効化します。
Web実験の最終化時に統合を追加します。
### 機能実験の場合
機能フラグ環境の統合セクションで統合をセットアップします。アクティブにしたい環境で有効化します。
統合が有効化され、実験が公開されると、訪問者が露出するたびにKameleoonは自動的に実験イベントをAmplitudeに送信します。各イベントには、以下のような主要な詳細が含まれます:
* Kameleoon訪問者コード（カスタムプロパティとして、また `device_id` フィールドのデフォルト値として送信されます）
* 露出のタイムスタンプ
* Kameleoon実験ID
* KameleoonバリエーションID
### イベントペイロードの例
Kameleoonは以下の形式でイベントをAmplitudeに送信します:
```json theme={null}
{
"event_type": "$identify",
"user_properties":
{
"$set":
{
"KAM_EXPERIMENT_12345": "KAM_VARIATION_15685",
"KAM_VISITOR_CODE": "rjfloel55ug9fg"
}
},
"device_id": "rjfloel55ug9fg" // also Kameleoon visitor code
"time": 1730194985000
}
```
デフォルトでは、**`user_id`** には訪問者のKameleoon訪問者コードが含まれます。Kameleoonクロスデバイス履歴照合をセットアップしている場合は、訪問者コードの代わりにクロスデバイス照合カスタムデータに配置された識別子が使用されます。
#### user\_id、device\_id、session\_idのペイロードカスタマイズ
デフォルトでは、Kameleoonは `device_id` フィールド（Kameleoon訪問者コードを含む）でユーザーを識別するペイロードを送信します。しかし、Kameleoonでカスタムデータを作成・入力することで、これらのペイロードの内容をカスタマイズできます。以下のカスタムデータのいずれかまたはすべてを定義できます:
* **クロスデバイス識別（`user_id`）:**
* カスタムデータを作成し、クロスデバイス識別用に使用するオプションを有効化すると、訪問中にその値が存在する場合、Amplitudeの user\_id フィールドに送信されます。このカスタムデータは、ユーザーに関連付けられた「ログイン済み」識別子に最適です。
* **デバイス識別子（`device_id`）:**
* `amplitude_device_id` という名前のカスタムデータを作成すると、存在する場合、その値がペイロードのdevice\_idフィールドのKameleoon訪問者コードを置き換えます。このカスタムデータは、ユーザーデバイスに関連付けられた「匿名」識別子に推奨されます。このカスタムデータが設定されているかどうかに関係なく、元のKameleoon訪問者コードはカスタムプロパティ `KAMELEOON_VISITOR_CODE` の下にペイロードに引き続き含まれます。
* **セッション識別子（`session_id`）:**
* `amplitude_session_id` という名前のカスタムデータを作成すると、存在する場合、その値がAmplitudeの `session_id` フィールドに送信されます。この値はAmplitudeのセッションIDと一致するように設定することをおすすめします。
これらのカスタムデータを構成する際は訪問スコープを使用し、正確な名前（`amplitude_device_id` および `amplitude_session_id`）を使用してください。
#### イベントペイロードの例
```json theme={null}
{
"event_type": "$identify",
"user_properties":
{
"$set":
{
"KAM_EXPERIMENT_12345": "KAM_VARIATION_15685",
"KAM_VISITOR_CODE": "rjfloel55ug9fg"
}
},
"device_id": "dfkslj47h9"
"user_id": "xf54dd2thdd5",
"session_id": 1396381378123
"time": 1730194985000
}
```
通常Amplitudeイベントに含まれる、お客様のビジネスに固有のカスタムデータは、サーバーからKameleoonによって送信されるイベントには含まれません。Kameleoonによってネイティブに追跡されていないデータでペイロードを強化する必要があり、Kameleoonアカウントをお持ちの場合は、[機能リクエスト](https://feedback.kameleoon.com/)を送信できます。