Google Analytics 4 — イベントストリーミング

​

主なメリット

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

​

考慮事項

​

前提条件

• Kameleoon SDK: サーバーサイドプロジェクトにSDKがインストールされている必要があります。
• API secret: Google Analyticsで生成されたAPIシークレット（こちらに文書化されています）。
• Measurement ID: Web SDKの場合、データストリームの識別子（こちらに文書化されています）。
• Firebase app ID: モバイルSDKの場合、Firebaseアプリの識別子（こちらに文書化されています）。

​

適切なGA4識別子の選択

• Webベースのプロジェクト（gtag.js を使用するWebサイト）の場合: ga4_client_id という名前のカスタムデータを作成し、GA4から client_id を取得します（通常は _ga cookieに保存されています）。
• Firebaseベースのモバイルアプリの場合: ga4_app_instance_id という名前のカスタムデータを作成し、Firebase SDKから app_instance_id を取得します。

​

セットアップ

​

Web実験の場合

​

GA4 client IDを識別する

​

カスタムデータをセットアップする

• Name: ga4_client_id
• プロジェクトを Select します。
• Retrieval method: Kameleoon Activation API.
• Type: Single
• Format: String
• Scope: Visit

​

Global scriptにコードを追加する

if(!Kameleoon.API.CurrentVisit.customData["ga4_client_id"]){

// First, create a ga4ClientId variable and obtain your GA4 client ID.
let gaClientId = null;

const getClientId = () =>{
    gtag('get', 'G-XXXXXXXXXX', 'client_id', function(clientId) {
        gaClientId = clientId;
    });
    return gaClientId !== null
}

Kameleoon.API.Core.runWhenConditionTrue(
    () => getClientId(),
    () =>{
        // Then set your Kameleoon "ga_client_id" custom data to this value using Kameleoon's Activation API
        Kameleoon.API.Data.setCustomData("ga4_client_id", gaClientId);
    },
    200
)

}

​

キャンペーンで統合を有効化する

​

機能実験の場合

​

モバイルの場合

1. GA4 Firebase app instance IDを識別する
2. カスタムデータをセットアップする
   • Name: ga_app_instance_id
   • プロジェクトを Select します。
   • Retrieval method: Kameleoon SDK method.
   • Type: Single
   • Format: String
   • Scope: Visit

​

Kameleoon Android SDKを使用したJavaの例

• SDKセットアップ専用のFirebaseアプリインスタンスの固有識別子（app_instance_id と呼ばれます）。
• Webセットアップ専用のクライアントの固有識別子（client_id と呼ばれます）。
• 露出時間
• KAM-XXXX-YYYY 形式に従う実験とバリエーションの固有識別子（XXXX はKameleoon実験ID、YYYY はバリエーションIDです）。

​

イベントペイロードの例

{
  "events": [
    {
      "name": "experience_impression",
      "exp_variant_string": "KAM-1234-5567",
      "timestamp_micros": 1718201234000
    },
    {
      "name": "experience_impression",
      "exp_variant_string": "KAM-5678-6978",
      "timestamp_micros": 1718201267000
    }
  ],
  "app_instance_id": "example-instance-id"
}

ユーザーの識別

• モバイル: app_instance_id（GA4モバイルアプリの標準）
• Web: client_id（Webクライアントの app_instance_id 相当）

イベントの強化