このページは Cloud Translation API によって翻訳されました。

モバイルアプリ向けのサーバーサイドタグ設定

Firebase 向け Google アナリティクス SDK を使用してモバイルアプリを設定すると、Google タグマネージャーのサーバーサイドタグ設定と連携できます。

サーバーサイドタグ設定では、データを Google アナリティクスなどの宛先サービスに送信する前に、データのステージング、削除、拡張を行うことができます。詳しくは、サーバーサイドタグ設定についての記事をご覧ください。

モバイルアプリのサーバーサイドタグ設定をセットアップする手順は次のとおりです。

サーバーサイドタグ設定に対応するようにアプリを準備する
モバイルトラフィックをサポートするようにサーバーコンテナを構成する
GA4 プロパティでサーバーサイドタグ設定を有効にする

前提条件

アプリに Firebase 向け Google アナリティクス SDK を含め、Google アナリティクス 4 プロパティに接続する必要があります。詳しくは、Firebase 向け Google アナリティクス SDK をご覧ください。
Google タグマネージャーのアカウントとサーバーコンテナが必要です。アカウントをお持ちでない場合は、新しいタグマネージャーアカウントとコンテナを作成します。
タグ設定サーバーをセットアップする必要があります。

ステップ 1: サーバーサイドタグ設定に対応するようにアプリを準備する

iOS

Info.plist ファイルで、サーバーサイドタグ設定のアップロード機能を有効にし、サーバーサイドタグ設定のデバッグモードのカスタム URL スキームを設定します。次の BUNDLE_ID をアプリのバンドル ID に置き換えます。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
...
        <key>CFBundleURLTypes</key>
        <array>
                <dict>
                        <key>CFBundleTypeRole</key>
                        <string>None</string>
                        <key>CFBundleURLName</key>
                        <string>BUNDLE_ID</string>
                        <key>CFBundleURLSchemes</key>
                        <array>
                                <string>tagmanager.sgtm.c.BUNDLE_ID</string>
                        </array>
                </dict>
        </array>
        <key>GOOGLE_ANALYTICS_SGTM_UPLOAD_ENABLED</key>
        <true/>
</dict>
</plist>

デバッグモードまたはプレビューモードを有効にするには、ライフサイクルメソッドで Analytics.handleOpen(_:) の呼び出しを追加して、起動 URL を渡します。

SwiftUI

@main
struct MyApplication: App {
  var body: some Scene {
    WindowGroup {
      ContentView()
        .onOpenURL { url in
          Analytics.handleOpen(url)
        }
    }
  }
}

UIScene

class SceneDelegate: UIResponder, UIWindowSceneDelegate {
func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
        options connectionOptions: UIScene.ConnectionOptions) {
...
    if let urlContext = connectionOptions.urlContexts.first {
        let url = urlContext.url
        Analytics.handleOpen(url)
    }
  }
}

SwiftUI または UIScene を使用していないアプリの場合、対応は必要ありません。SDK は ApplicationDidFinishLaunchingNotification から起動 URL を受け取ります。

Android

Firebase 向け Google アナリティクス SDK の最新のリリースをインストールします。

アプリの AndroidManifest.xml ファイルに次の行を追加して、sGTM を有効にします。

<!-- Preview Activity to enable preview mode –->
  <activity
      android:name="com.google.firebase.analytics.GoogleAnalyticsServerPreviewActivity"
      android:exported="true"
      android:noHistory="true" >
    <intent-filter>
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data android:scheme="tagmanager.sgtm.c.<APP_PACKAGE_ID>" />
    </intent-filter>
  </activity>

<!-- Meta-data that enables uploads to sGTM –->
  <meta-data android:name="google_analytics_sgtm_upload_enabled" android:value="true" />

ステップ 2: モバイルトラフィックをサポートするようにサーバーコンテナを構成する

次のセクションでは、既存のサーバーサイドタグ設定のデプロイがあり、そのコンセプトを理解していることを前提としています。サーバーサイドタグ設定を初めて使用する場合は、サーバーサイドタグ設定の基礎コースを受講することをおすすめします。

Google アナリティクス: GA4（アプリ）クライアントをセットアップする

クライアントはタグマネージャーのリソースタイプのひとつで、コンテナに届いた特定の種類のリクエストからイベントを生成し、送信先（たとえば Google アナリティクス 4）に受け渡す役割を持ちます。この場合、HTTP リクエストは Google アナリティクス 4 のイベントなので、コンテナにあらかじめ組み込まれている「Google アナリティクス: GA4（アプリ）」クライアントの設定を調整して使用します。GA SDK やウェブサイトなどのデータソースごとに 1 つの GA4 クライアントが必要です。詳しくは、クライアントの仕組みをご覧ください。

サーバーコンテナで、[クライアント] に移動し、[新規] をクリックします。
[クライアントの設定] をクリックし、[Google アナリティクス: GA4（アプリ）] を選択します。
クライアントの名前を入力して、[保存] をクリックします。

Google アナリティクス: GA4 タグを設定する

Google アナリティクスにデータを送信するには、サーバーコンテナ内に「Google アナリティクス: GA4」タグを作成する必要があります。コンテナに HTTP リクエストが届くと、クライアントがパースしてイベントデータオブジェクトを生成します。タグは、このイベントデータオブジェクトを取得し、適切な形式にマッピングして、Google アナリティクス 4 に送信します。

サーバーコンテナで、[タグ] に移動し、[新規] をクリックします。
[タグの設定] をクリックし、[Google アナリティクス: GA4] を選択します。

デフォルトでは、タグの関連フィールドおよびパラメータはすべて、クライアントが作成したイベントデータオブジェクトから引き継がれます。

コンテナに届いた Google アナリティクス 4 リクエストが「Google アナリティクス: GA4（アプリ）」クライアントで処理される場合、タグにはアプリ ID とイベントパラメータが引き継がれます。
コンテナに届いた Google アナリティクス 4 リクエストが「Google アナリティクス: GA4（ウェブ）」クライアントを通過すると、タグには測定 ID とイベントパラメータが引き継がれます。

モバイルトラフィックのトリガーを設定する

次に、GA4 タグを配信するタイミングを決めます。コンテナにリクエストが届くと、Google アナリティクス: GA4（アプリ）クライアントがそれをもとにイベントデータオブジェクトを生成し、その値がタグに引き継がれます。そのため、通常は GA4 クライアントがリクエストを要求するたびにタグが配信されるようにします。

トリガーを設定する手順は次のとおりです。

タグの設定で、[トリガー] をクリックします。
新しいトリガーを作成するには、右上の + アイコンをクリックします。
[トリガーの設定] をクリックして、トリガーのタイプを選択します。
リストから [カスタム] または [カスタムイベント] を選択します。
- カスタムトリガー タイプは、サーバーサイドクライアントがイベントを生成するたびに、そのイベントの種類を問わずタグを配信するのがデフォルト動作です。
- カスタムイベント トリガータイプを使用すると、特定のイベント名または正規表現パターンに一致するイベントでタグを配信できます。
モバイルまたはウェブのイベントデータでのみ発動するなど、このトリガーの発動条件のリストを有効にするには、[一部のイベント] を選択します。
1. [イベント名] がデフォルトで選択されています。プルダウンメニューをクリックして、[組み込み変数を選択します] を選択します。
2. イベントを生成したクライアントの名前を自動的に返す Client Name を選択します。
3. 先ほど構成したクライアントの名前を使用して、条件を適切に設定します。トリガーは次のようになります。
  
  注: クライアントの名前は、前の手順で指定したものです。クライアントのタイプは「Google アナリティクス: GA4（アプリ）」です。Client Name 変数が返すのはクライアントの名前であり、タイプではない点に注意しましょう。
トリガーを保存し、わかりやすい名前を入力します。たとえば、「すべての GA4 アプリイベント」などです。
再びタグの設定画面が表示され、トリガーの欄には新規作成したトリガーが加わっているはずです。タグを保存します。わかりやすい名前を付けておきましょう（「GA4」など）。タグは次のようになります。

コンテナをプレビューする

Google タグマネージャーを使用すると、変更を公開する前にサーバーコンテナをプレビューしてデバッグできます。プレビューは、GA4 プロパティでサーバーサイドタグ設定を有効にするまで機能しません。

アプリのリクエストでプレビュー構成をトリガーするには、次の操作を行う必要があります。

Google タグマネージャーのサーバーコンテナで、[プレビュー] を選択します。
右上にある [その他の操作] アイコン ⋮ をクリックし、[アプリからリクエストを送信] を選択します。
アプリ ID を入力して [QR コードを生成] をクリックします。

注: アプリ ID の先頭は文字にする必要があります。または、Info.plist ファイルまたは AndroidManifest.xml ファイルで使用されている ID と一致する限り、文字で始まる一意の ID を使用することもできます。
スマートフォンのカメラアプリで QR コードをスキャンし、プレビューイベントを生成する場合と同様に、アプリを操作します。
[OK] をクリックしてダイアログを閉じます。

コンテナを公開する

変更を確認したら、コンテナを公開して、すべてのトラフィックにその変更を反映します。詳しくは、公開、バージョン作成、承認をご覧ください。

ステップ 3: GA4 プロパティでサーバーサイドタグ設定を有効にする

Google アナリティクス 4 プロパティで、[管理] に移動します。
[データストリーム] を開きます。
[iOS] タブまたは [Android] タブで、アプリのストリーム構成を選択します。
[SDK の設定を構成する]、[サーバーサイドタグマネージャーを設定する] の順にクリックします。
SDK が測定データをサーバーコンテナの URL に送信できるようにするには:
1. [タグマネージャーのサーバーサイドコンテナにデータを送信する] を切り替えます。
2. サーバーコンテナの URL をコピーします。この URL は、Google タグマネージャーの [管理] > [コンテナの設定] > [サーバーコンテナの URL] で確認できます。
3. サーバーコンテナに転送するトラフィックの割合を選択します。100% 未満のオプションを選択して、すべてのトラフィックにサーバーサイドタグ設定を使用する前に、サーバーの設定と構成を検証できます。
  
  注: [デバッグデバイスのみ] オプションを使用すると、プレビューモードを使用して開かれたアプリのみがサーバーにデータを送信できるようになります。
[保存] をクリックします。SDK は更新されたサーバーコンテナ URL を取得し、測定データをその URL に転送します。

既知の制限事項

Android アプリケーションの場合:
- 自動的に記録されるアプリ内購入は、Google Play バックエンドとの統合に依存しており、サーバーコンテナには送信されません。
- Android では app_remove イベントはレポートされません。
SDK のデータとコンバージョンを Google 広告にインポートするには、Google アナリティクスのアプリデータストリームを Google 広告アカウントに接続する必要があります。サーバーサイドタグ設定では、SDK と Google 広告の間の固有の統合は提供されません。

API

タグマネージャー REST API を使用すると、タグマネージャーの設定データにアクセスできます。API の詳細については、以下をご覧ください。

API の取り扱いについては、デベロッパーガイドをご覧ください。
タグマネージャーのリソースと実施できる操作については、Tag Manager API のリファレンスをご覧ください。