Amplitude — イベントストリーミング

​

主なメリット

• 精密な行動洞察: この統合は、SDKベースのプロジェクト（アプリなど）でWeb実験や機能フラグに露出した訪問者の特定のイベントを、サードパーティツールに送信します。この詳細な追跡により、異なるバリエーションがユーザー行動にどのように影響するかを明確に把握できます。例えば、どのバリエーションがより多くのクリック、コンバージョン、その他の望ましい結果をもたらすかを観察し、最も効果的なアプローチを判断できます。
• リアルタイムの意思決定: この統合はリアルタイムでデータを提供し、その場での意思決定を可能にします。実施中の実験に関する最新の洞察を活用して、バリエーションが期待通りに機能していない場合、戦略を迅速に調整できます。
• 簡単なセットアップ: Kameleoonアプリから直接サードパーティ統合を有効化できます。カスタムコードやSDK変更は不要です。

​

考慮事項

• イベント配信のタイミング: Kameleoonサーバーは、最小30分の遅延でイベントを送信します。

​

前提条件

• Amplitude APIキー: Amplitudeプロジェクトの1つに固有のAPIキー（こちらに文書化されています）
• サーバーリージョン: Amplitudeアカウントが標準ホスティングリージョン用に構成されているか、EUホスティング用に構成されているかを指定します。
• Amplitudeプラン: Amplitudeで購入した顧客プランの種類を選択します。

​

セットアップ

​

Web実験の場合

​

機能実験の場合

• Kameleoon訪問者コード（カスタムプロパティとして、また device_id フィールドのデフォルト値として送信されます）
• 露出のタイムスタンプ
• Kameleoon実験ID
• KameleoonバリエーションID

​

イベントペイロードの例

{
    "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、device_id、session_idのペイロードカスタマイズ

• クロスデバイス識別（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と一致するように設定することをおすすめします。

​

イベントペイロードの例

{
    "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
}