Google Analytics 4の設定
Google Analytics 4はAdjustと連携しているアナリティクスパートナーです。Adjustとの連携により、 Google Analytics 4は自動コールバックを通じてデータを受信します。このデータをパートナーのツールで使用して、分析データとインサイトを得ることができます。
ここでは、Google Analytics 4とアプリ計測を設定する方法を説明します。 連携を有効化し、AdjustがGoogle Analytics 4と共有できるデータを選択する方法をご確認ください。
事前準備
要件
- Adjustアカウントの管理者、編集者またはカスタム編集者のアクセス権限。
- Adjust SDK v4.0.0以降を実装することで、SDKパラメーターを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を取得する方法:
- Firebaseコンソールに移動します。
- 該当するプロジェクトを見つけてクリックします。
- 歯車アイコンをクリックし、左パネルの「Project Overview」の横にある「Project settings」をクリックします。
- 「Your apps」でアプリを選択し、「App ID」でFirebaseアプリIDを見つけます。
APIシークレットを取得する方法:
- Google Analyticsのダッシュボードに移動します。
- 管理(Admin) > データの収集と修正(Data collection and modification) > データストリーム(Data streams)を選択します。
- アプリのデータストリームを選択し、「Measurement Protocol API Secrets」> 「secret value」の順にクリックして、APIシークレットを見つけます。
- APIシークレットが存在しない場合、Measurement Protocol API Secretsにて「作成(Create)」を選択し、名前を入力して「作成(Create)」を選択します。
Campaign LabでGoogle Analytics 4とアプリを選択
- Campaign Labにて、 パートナー(Partner) を選択します。
- 新規パートナー(New partner) > Google Analytics 4 を選択します。 次へ(Next) を選択して、次の画面に移動します。
- アプリの選択(App selection) 画面で、リンクを作成したいアプリを選択し、 Google Analytics 4のデータ共有をするため連携を有効化します。
- 次(NEXT) を選択します。
データ共有を有効化
データ共有を有効化すると、Google Analytics 4との連携が有効化されます。データ共有を有効化する方法は以下のとおりです:
- Firebase App ID (for mobile apps), Measurement ID (for web apps), API Secretを入力します。
Google Analytics 4とのデータ共有を有効化すると、デフォルトでは、Google Analytics 4に以下のデータが自動送信されます:
- インストール
- リアトリビューション
データ共有オプションの設定
マルチプラットフォームアプリで複数のプラットフォームを対象にデータ共有を有効にしている場合は、以下のことが可能です:
- プラットフォーム固有の設定を使用(Use platform-specific settings) を選択すると、プラットフォームレベルでデータ共有オプションを個別に設定できます。
- グローバル設定を使用(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に直接送信するアプリ内イベントを選択します。
イベントのマッピング(Map event)を選択します。
Adjustイベントリストで、 Google Analytics 4と共有するAdjustイベントを選択します。
パートナーイベント(Partner event)で、Adjustイベントに対応するGoogle Analytics 4イベントを選択します。
シングルプラットフォームアプリ、および、単一のプラットフォームでのみデータ共有が有効になっているマルチプラットフォームアプリには、そのプラットフォームにのみイベントをマッピングします。複数のプラットフォームでデータ共有が有効化されているマルチプラットフォームアプリの場合は、以下のことが可能です。
- プラットフォーム固有のマッピングを使用する(Use platform-specific mapping) を選択して、プラットフォームレベルで各イベントをマッピングするか、特定のプラットフォームのイベントをマッピングしないようにします。
- グローバルマッピングを使用する(Use global mapping) を選択して、全てのプラットフォームに同じイベントをマッピングします。
パートナーイベント(Partner event)リストで、Adjustイベントをマッピングするカスタムイベント名を選択または入力します。
適用(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に共有するには、以下の手順に従って設定してください。
AdjustのSDKでパートナーパラメーターを実装します。
- 全てのSDK開発プラットフォームのリンクについては、事前準備をご確認ください
データ共有オプションの設定(Set your data sharing option) で、 パラメーターを選択します。
パラメーターのマッピング(Map parameters)では、SDKで定義したパートナーパラメーターをネットワークに送信する方法を指定できます。
- パラメーターのマッピング(Map parameters)を選択します。
- SDKパラメーター(SDK parameter)フィールドで、ネットワークと共有するSDKパラメーターの名前を入力します。
- パートナーパラメーター(Partner parameter)フィールドで、SDKパラメーターに対応するネットワークパラメーターを入力します。
Adjust SDK内でパートナーパラメーターを設定し、ダッシュボードでパラメーター共有を設定しない場合、AdjustはAdjust SDKで指定されているパラメーターを転送します。
アプリでGoogle Analytics 4を有効化
設定のレビュー(Setup review) 画面では 、選択した内容を確認できます。前に戻って、以下の変更も行えます:
- 選択したアプリ
- データ共有オプション
パートナーを有効化(Enable partner) を選択して、アプリで Google Analytics 4 を有効化します。アナリティクスパートナーはキャンペーンのリンクを処理しません。一度有効にすると、アトリビューションおよびアプリ内イベントデータが自動コールバックで送信されます。
パートナー固有の設定手順
Our Google Analytics 4 (GA4) integration allows Adjust to send cross-network attribution data to Google Analytics. You should enable this integration if you are already logging conversions with the Google Analytics for Firebase SDK or using Google Analytics 4 for web. Adjust leverages the campaign_details event of the Measurement Protocol API to send conversions along with attribution details.
Requirements
This integration supports both mobile apps and web-based apps:
- For mobile apps:
- The Firebase SDK must be integrated into your app.
- A Firebase App ID is required.
- You must implement session partner parameters within the Adjust SDK to capture and send Google Analytics 4’s app_instance_id.
- You should set app_instance_idbefore initializing the Adjust SDK.
- For web-based apps:
- A Measurement ID from your GA4 web property is required.
- You must implement session partner parameters within the Adjust SDK to capture and send Google Analytics 4’s client_id.
- You should set client_idbefore initializing the Adjust SDK.
These identifiers (app_instance_id for mobile, client_id for web) are essential because Google Analytics 4 uses them to uniquely identify each user or app instance. If these values are not properly tracked and passed, Adjust will not be able to fire callbacks to Google Analytics.
Follow the guides linked below to use this feature:
iOS / Android / Unity / Flutter / React Native
Supported in-app events
The Google Analytics 4 integration supports the following in-app events:
- Add to cart
- View cart
- Begin checkout
- Login
- Purchase
- Add to wishlist
- Sign up
Some events require additional values to be passed as SDK Partner Parameters:
| In-app event | Required SDK Partner Parameters |
| Add to cart | item_id or item_name |
| View cart | item_id or item_name |
| Begin checkout | item_id or item_name |
| Login | None |
| Purchase | item_id or item_name, and transaction_id |
| Add to wishlist | item_id or item_name |
| Sign up | None |
Make sure you pass the required SDK Partner Parameters when triggering these events. If the required parameters are missing, Adjust cannot send the event to Google Analytics 4 with the information required by the integration.
Additional Notes
- Organic traffic is not shared via this integration.
- Due to differences in attribution methodology, Google Analytics does not accept conversions older than 3 days.
- Depending on your Adjust Link attribution windows, you might see discrepancies because some conversions may not be reported in GA4.
About Session ID
You can send the Firebase Session ID through the session partner parameter ga4_session_id.
About User ID
You can send the Firebase User ID through the session partner parameter ga4_user_id.
Google Analytics 4に転送されるパラメーター一覧
Adjustは、Google Analytics 4に以下のパラメーター(データポイント)をコールバック送信するよう要求されています。
| Placeholder | Information |
{currency} | Original ISO 4217 currency code sent from Adjust SDK |
{revenue_float} | Revenue, as sent from Adjust SDK, in whole currency units |
{adgroup_name} | Adgroup name, as taken from the tracker |
{campaign_name} | Campaign name, as taken from the tracker |
{creative_name} | Creative name, as taken from the tracker |
{engagement_time} | Engagement timestamp |
{network_name} | Network name, as taken from the tracker |