Google Analytics 4の設定

Google Analytics 4はAdjustと連携しているアナリティクスパートナーです。Adjustとの連携により、 Google Analytics 4は自動コールバックを通じてデータを受信します。このデータをパートナーのツールで使用して、分析データとインサイトを得ることができます。

ここでは、Google Analytics 4とアプリ計測を設定する方法を説明します。 連携を有効化し、AdjustがGoogle Analytics 4と共有できるデータを選択する方法をご確認ください。

事前準備

要件​

iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

認証情報​

Firebase App ID (for mobile apps), Measurement ID (for web apps), API Secret

  • 認証情報を確認するには、Google Analytics 4の担当者にお問い合わせください。

Google Analytics 4のダッシュボードにて：​

FirebaseアプリIDを取得する方法：

  1. Firebaseコンソールに移動します。
  2. 該当するプロジェクトを見つけてクリックします。
  3. 歯車アイコンをクリックし、左パネルの「Project Overview」の横にある「Project settings」をクリックします。
  4. 「Your apps」でアプリを選択し、「App ID」でFirebaseアプリIDを見つけます。

APIシークレットを取得する方法：

  1. Google Analyticsのダッシュボードに移動します。
  2. 管理（Admin） > データの収集と修正（Data collection and modification） > データストリーム（Data streams）を選択します。
  3. アプリのデータストリームを選択し、「Measurement Protocol API Secrets」> 「secret value」の順にクリックして、APIシークレットを見つけます。
  4. APIシークレットが存在しない場合、Measurement Protocol API Secretsにて「作成（Create）」を選択し、名前を入力して「作成（Create）」を選択します。

Campaign LabでGoogle Analytics 4とアプリを選択

  1. Campaign Lab​にて、 パートナー（Partner）​ を選択します。
  2. 新規パートナー（New partner） > Google Analytics 4​ を選択します。 次へ（Next）​ を選択して、次の画面に移動します。
  3. アプリの選択（App selection）​ 画面で、リンクを作成したいアプリを選択し、 Google Analytics 4のデータ共有をするため連携を有効化します。
  4. 次（NEXT）​ を選択します。

データ共有を有効化

データ共有を有効化すると、Google Analytics 4との連携が有効化されます。データ共有を有効化する方法は以下のとおりです：

  1. Firebase App ID (for mobile apps), Measurement ID (for web apps), API Secretを入力します。

Google Analytics 4とのデータ共有を有効化すると、デフォルトでは、Google Analytics 4に以下のデータが自動送信されます：

  • インストール
  • リアトリビューション

データ共有オプションの設定

マルチプラットフォームアプリで複数のプラットフォームを対象にデータ共有を有効にしている場合は、以下のことが可能です：

  1. プラットフォーム固有の設定を使用（Use platform-specific settings）​ を選択すると、プラットフォームレベルでデータ共有オプションを個別に設定できます。
  2. グローバル設定を使用（Use global settings）​ を選択して、複数のプラットフォームに同じデータ共有設定を行います。

デフォルトで共有するデータ（What will be shared by default?）​ にて、Adjustがデフォルトで Google Analytics 4と共有するアクティビティを確認してください。

  • インストール
  • リアトリビューション

追加データの送信

コールバックによりGoogle Analytics 4と共有するデータ量とタイプを選択します。 Google Analytics 4はこの情報を使用して、パフォーマンスを最適化することができます。

追加データを送信するには、以下を確認またはカスタマイズしてください：

アプリ内収益（アプリ内購入由来）

アプリ内収益を共有すると、 Google Analytics 4は収益イベントデータと収益額を受信することができます。このデータを共有するには、収益が発生するイベントをマッピングしてください。

イベントのマッピング

共有するイベントを、Google Analytics 4が受信できる値にマッピングします。マッピングされていないイベントのデータは、Google Analytics 4と共有されません。

各イベントをマッピング

マルチプラットフォームアプリの場合、プラットフォームごとに異なるイベントをGoogle Analytics 4と共有することができます。これにより、次のことが可能になります。

  • 各イベントを設定し、それぞれのプラットフォームのキャンペーン戦略を管理できます。
  • プラットフォームごとにデータ共有をカスタマイズします。

イベントのマッピング（Map events）​にて、以下の手順に従って、Google Analytics 4に直接送信するアプリ内イベントを選択します。

  1. イベントのマッピング（Map event）​を選択します。

  2. Adjustイベント​リストで、 Google Analytics 4と共有するAdjustイベントを選択します。

  3. パートナーイベント（Partner event）​で、Adjustイベントに対応するGoogle Analytics 4イベントを選択します。

    1. シングルプラットフォームアプリ、および、単一のプラットフォームでのみデータ共有が有効になっているマルチプラットフォームアプリには、そのプラットフォームにのみイベントをマッピングします。複数のプラットフォームでデータ共有が有効化されているマルチプラットフォームアプリの場合は、以下のことが可能です。

      • プラットフォーム固有のマッピングを使用する（Use platform-specific mapping）​ を選択して、プラットフォームレベルで各イベントをマッピングするか、特定のプラットフォームのイベントをマッピングしないようにします。
      • グローバルマッピングを使用する（Use global mapping）​ を選択して、全てのプラットフォームに同じイベントをマッピングします。

    2. パートナーイベント（Partner event）​リストで、Adjustイベントをマッピングするカスタムイベント名を選択または入力します。

  4. 適用（Apply）​を選択します。

Google Analytics 4は連携されているイベントごとにアプリ内イベントのデータを受信するようになります。

全てのイベントをマッピング

Google Analytics 4が全てのイベントの自動マッピングをサポートしている場合、 イベントのマッピング（Map events）​で、全てのイベントをマッピング（Map all events）​を選択します。これにより、個々のイベントをマッピングする時間を節約できます。

Google Analytics 4は連携されている全てのリンクされたアプリ内イベントのデータを受信するようになります。

パラメーターのマッピング

通常、カスタムデータをGoogle Analytics 4と共有するには、パラメーターをマッピングする必要があります。

パートナーパラメーター（Adjust SDKバージョン4.0以降で使用可能）によって、Adjustはアプリからカスタムデータポイントを収集し、Google Analytics 4に送信することができます。 これにより、Google Analytics 4は連携しているイベントごとにカスタムイベントの詳細を受信するようになります。

Adjust SDKに新しいパートナーパラメーターを追加する前に、要件に合うパートナーパラメーターが存在していないことを確認してください。

パートナーパラメーターをGoogle Analytics 4に共有するには、以下の手順に従って設定してください。

  1. AdjustのSDKでパートナーパラメーターを実装します。

    • 全てのSDK開発プラットフォームのリンクについては、事前準備をご確認ください

  2. データ共有オプションの設定（Set your data sharing option）​ で、 パラメーター​を選択します。

  3. パラメーターのマッピング（Map parameters）​では、SDKで定義したパートナーパラメーターをネットワークに送信する方法を指定できます。

    1. パラメーターのマッピング（Map parameters）​を選択します。
    2. SDKパラメーター（SDK parameter）​フィールドで、ネットワークと共有するSDKパラメーターの名前を入力します。
    3. パートナーパラメーター（Partner parameter）​フィールドで、SDKパラメーターに対応するネットワークパラメーターを入力します。
注意:

Adjust SDK内でパートナーパラメーターを設定し、ダッシュボードでパラメーター共有を設定しない場合、AdjustはAdjust SDKで指定されているパラメーターを転送します。

アプリでGoogle Analytics 4を有効化

設定のレビュー（Setup review）​ 画面では 、選択した内容を確認できます。前に戻って、以下の変更も行えます：

  • 選択したアプリ
  • データ共有オプション

パートナーを有効化（Enable partner）​ を選択して、アプリで Google Analytics 4 を有効化します。アナリティクスパートナーはキャンペーンのリンクを処理しません。一度有効にすると、アトリビューションおよびアプリ内イベントデータが自動コールバックで送信されます。

パートナー固有の設定手順

AdjustとGoogle Analytics（GA4）の連携​ により、AdjustはクロスネットワークのアトリビューションデータをGoogle Analyticsに送信することができます。すでに Google Analytics for Firebase SDK​ を使用してコンバージョンを記録している場合、または Google Analytics 4​ for webをご利用の場合は、この連携を有効化する必要があります。Adjustは、 Measurement Protocol API​ のcampaign_detailsイベントを活用して、アトリビューションの詳細とコンバージョンを送信します。

要件

この連携は、 モバイルアプリとWebベースのアプリの両方​ に対応しています：

  • モバイルアプリの場合：​

    • アプリに Firebase SDK​ を実装する必要があります。
    • Firebase App ID​ が必要です。
    • Google Analytics 4のapp_instance_idを取得して送信するには、Adjust SDK内で セッションパートナーパラメーター​ を実装する必要があります。
    • Adjust SDKを初期化する前に​ app_instance_idを設定してください。

  • Webベースのアプリの場合：​

    • GA4のWebプロパティから取得した 計測ID​ が必要です。
    • Google Analytics 4のclient_idを取得して送信するには、Adjust SDK内で セッションパートナーパラメーター​ を実装する必要があります。
    • Adjust SDKを初期化する前に​ client_idを設定する必要してください。

これらの識別子（モバイルの場合はapp_instance_id、Webの場合はclient_id）は、Google Analytics 4が各ユーザーまたはアプリインスタンスを一意に識別するのに使用するため、不可欠です。これらの値が適切に計測およびパスされない場合、AdjustはGoogle Analyticsへのコールバックを送信することができません。

この機能を使用するには、以下のリンク先のガイドに従ってください。

iOS / Android / Unity / Flutter / React Native

サポートされているアプリ内イベント

Google Analytics 4の連携は、以下のアプリ内イベントに対応しています：

  • カートに入れる​
  • カートを見る​
  • 支払いを始める​
  • ログイン​
  • 購入​
  • ほしい物リストへの追加​
  • 登録​

イベントによっては、 SDKパートナーパラメーター​ として追加の値をパスする必要があります：

**カートに入れる**​ item_idまたはitem_name（最低1つ必要）
**ほしい物リストへの追加**​ item_idまたはitem_name（最低1つ必要）
**支払いを始める**​ item_idまたはitem_name（最低1つ必要）
**カートを見る**​ item_idまたはitem_name（最低1つ必要）
**購入**​ item_idまたはitem_name（最低1つ必要）、およびtransaction_id
**ログイン**​ 追加のSDKパートナーパラメーターは不要
**登録**​ 追加のSDKパートナーパラメーターは不要

これらのイベントをトリガーする際は、必要なSDKパートナーパラメーターを必ずパスしてください。必要なパラメーターがない場合、Adjustは連携に必要な情報を含めてGoogle Analytics 4にイベントを送信することができません。

補足事項

  • オーガニックトラフィック​ は、この連携では 共有されません​ 。
  • アトリビューションメソッドの違いにより、 Google Analyticsでは3日以上経過したコンバージョンを受け入れません。​
  • Adjust Linkのアトリビューションウィンドウ​ によっては、一部のコンバージョンがGA4にレポートされない場合があるため、データの乖離が生じる可能性があります。

Session IDについて

Firebase Session IDは、セッションパートナーパラメーター ​ga4_session_id​ を通じて送信できます。

ユーザーIDについて

Firebase User IDは、セッションパートナーパラメーター ​ga4_user_id​ を通じて送信できます。

Google Analytics 4に転送されるパラメーター一覧

Adjustは、Google Analytics 4に以下のパラメーター（データポイント）をコールバック送信するよう要求されています。

プレースホルダー情報
{currency}Adjust SDKから送信されたオリジナルのISO 4217通貨コード
{revenue_float}Adjust SDKから送信された収益（全ての通貨単位）
{adgroup_name}トラッカーから取得したアドグループ名
{campaign_name}トラッカーから取得したキャンペーン名
{creative_name}トラッカーから取得したクリエイティブ名
{engagement_time}エンゲージメントのタイムスタンプ
{network_name}トラッカーから取得したネットワーク名