Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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（アプリ）クライアントをセットアップする

クライアントはタグマネージャーのリソースタイプのひとつで、コンテナに届いた特定の種類の HTTP リクエストからイベントを生成し、送信先（たとえば Google アナリティクス 4）に受け渡す役割を持ちます。この場合、HTTP リクエストは Google アナリティクス 4 のイベントなので、組み込みの Google アナリティクス: GA4（アプリ）クライアントを設定する必要があります。GA SDK やウェブサイトなどのデータソースごとに必要な GA4 クライアントは 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 アナリティクス 4 クライアントがそれをもとにイベントデータオブジェクトを生成し、その値がタグに引き継がれます。そのため、通常は、GA4 クライアントがリクエストを要求するたびにタグを配信することをおすすめします。

トリガーをセットアップする手順は次のとおりです。

作成したタグの設定画面で [トリガー] ボックス内をクリックします。
新しいトリガーを作成するには、右上のプラス アイコンをクリックします。
[トリガーの設定] をクリックして、トリガーのタイプを選択します。
リストから [カスタム] または [カスタムイベント] を選択します。
- カスタムトリガー タイプのトリガーは、サーバーサイドクライアントがイベントを生成するたびに、そのイベントの種類を問わずタグを配信するのがデフォルト動作です。
- カスタムイベント トリガータイプを使用すると、特定のイベント名または正規表現パターンに一致するイベントでタグを配信できます。
モバイルまたはウェブのイベントデータのみで配信するなど、このトリガーの発動条件のリストを有効にするには、[一部のイベント] を選択します。
1. [イベント名] が選択された状態で表示されます。そのセレクタをクリックし、リストから [組み込み変数を選択します] を選択します。
2. イベントを生成したクライアントの名前を自動的に返すには、[クライアント名] を選択します。
3. 先ほど構成したクライアントの名前を使用して、条件を設定します。条件の設定を済ませたトリガーは次のようになります。
  
  注: クライアントの名前は、前のステップで指定したものです。クライアントのタイプは Google アナリティクス: GA4（アプリ）です。クライアント名変数が返すのはクライアントの名前であり、タイプではない点に注意しましょう。
トリガーを保存し、わかりやすい名前を入力します。たとえば、「すべての 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 をコピーします。これは、Google タグマネージャーの [管理] > [コンテナの設定] > [サーバーコンテナの URL] で確認できます。
3. サーバーコンテナにルーティングするトラフィックの割合を選択します。すべてのトラフィックにサーバーサイドタグ設定を使用する前に、100% 未満のオプションを選択して、サーバーのセットアップと構成を検証できます。
  
  **注:** [デバッグデバイスのみ] オプションを使用すると、プレビューモードで開いたアプリのみがサーバーにデータを送信できます。
[保存] をクリックします。SDK は更新されたサーバーコンテナの URL を取得し、測定データをその URL に送信します。

既知の制限事項

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

API

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

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