このページは 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（アプリ）クライアントをセットアップする

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

使用するサーバーコンテナで [クライアント] に移動し、[新規] をクリックします。
[クライアントの構成] をクリックし、[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 コードを生成] をクリックします。
スマートフォンのカメラアプリで QR コードをスキャンし、プレビューイベントを生成する場合と同様に、アプリを操作します。
[OK] をクリックしてダイアログを閉じます。

コンテナを公開する

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

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

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

既知の制限事項

Android アプリの場合:
- サーバーコンテナと Google Play 開発者サービスに関連する潜在的なセキュリティ上の脆弱性を回避するため、イベントは SDK とサーバーコンテナの間にあるステートレスプロキシサーバーを経由します。このプロキシはリクエストの送信元とエンドポイントを検証しますが、イベントに関するデータを検査または保存することはありません。GA4 が EU 域内のデバイスからデータを収集する方法と同様、EU 域内のトラフィック用のプロキシは EU 域内に配置されます。
- 自動的に記録されるアプリ内購入は、Google Play バックエンドとの統合に依存しており、サーバーコンテナには送信されません。
- app_remove イベントは Android では報告されません。
SDK データとコンバージョンを Google 広告にインポートするには、Google アナリティクスのアプリデータストリームを Google 広告アカウントに接続する必要があります。サーバーサイドタグ設定では、SDK と Google 広告の統合は行われません。

API

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

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