タグマネージャー + Firebase: スタートガイド

概要

デベロッパーは、Google タグマネージャー管理画面を使用すると、アプリのバイナリを再ビルドしてアプリマーケットプレイスに再送信しなくても、モバイルアプリに測定タグとピクセルを実装して管理することができます。Firebase Analytics を使用しているデベロッパーは、Google タグマネージャーを簡単に追加でき、アプリの公開後も、実装の管理や変更に役立てることができます。

デベロッパーは重要なイベントをログに記録し、どのトラッキングタグやピクセルを配信するかを後で決定できます。タグマネージャーでは現在、次のサービスのタグがサポートされています。

Firebase Analytics
Google アナリティクス
Floodlight
Google 広告
adjust
AppsFlyer
Apsalar
Kochava
Tune
カスタム関数呼び出し（他のサービス用）

事前の準備

まず、以下の準備を行います。

Firebase SDK をインストールします。
Firebase コンソールで、Firebase プロジェクトにアプリを追加します。
アプリに Firebase Analytics を追加します。
Google タグマネージャーアカウントを作成します。
Google タグマネージャーコンテナを設定します。

次のセクションでは、Android アプリで Google タグマネージャーを設定および使用する手順について説明します。

1. Google タグマネージャーをプロジェクトに追加する

モジュールの Gradle ファイル（通常は app/build.gradle）に、タグマネージャーライブラリに対する次の依存関係を追加します。
```
dependencies {
  // ...
  compile 'com.google.android.gms:play-services-tagmanager:11.0.4'
}
```
Google タグマネージャーアカウントにログインします。
モバイル向けのコンテナを選択します。
上部のナビゲーションバーにある [バージョン] をクリックします。
選択したコンテナバージョンで [アクション] > [ダウンロード] をクリックします。
app/src/main/assets/containers フォルダが存在しない場合は作成します。ダウンロードしたコンテナをフォルダにコピーします。

2. イベントと変数をログに記録する

Google タグマネージャーでは、Firebase Analytics のイベント、パラメータ、ユーザープロパティを使用して、Google タグマネージャーの管理画面で設定したタグのトリガーやビルドを行います。この意味で、Firebase Analytics の実装はデータレイヤーとして機能します。

イベントのログ記録とユーザープロパティの設定の手順については、Firebase Analytics のデベロッパー向けドキュメントをご覧ください。

タグマネージャーで変数を設定する

Google タグマネージャーで使用する Firebase イベントパラメータとユーザープロパティの値を取得するには、タグマネージャーの管理画面で変数を設定します。

たとえば、アプリで次のカスタムイベントをログに記録しているとします。

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

Google タグマネージャーで新しいイベントパラメータ変数を次のように設定して、image_name と full_text parameter の値を取得できます。

変数名: Image Name
変数タイプ: イベントパラメータ
イベントパラメータキー名: image_name

および

変数名: Full Text
変数タイプ: イベントパラメータ
イベントパラメータキー名: full_text

同様に、アプリで次のユーザープロパティを設定しているとします。

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

Google タグマネージャーで新しい Firebase ユーザープロパティ変数を次のように設定して、favorite_food の値を取得できます。

変数名: Favorite Food
変数タイプ: Firebase ユーザープロパティ
イベントパラメータキー名: favorite_food

Firebase Analytics イベントを変更またはブロックする

Google タグマネージャーを使用すると、Firebase Analytics にログが記録される前に、イベントを変更したりブロックしたりできます。イベントを変更すると、アプリを更新しなくても、イベントパラメータの値を追加、削除、変更したり、イベント名を調整したりできます。ブロックされていないイベントは、Firebase Analytics にログが記録されます。

Firebase Analytics は一部のイベントとユーザープロパティも自動的にログに記録します。こうしたログ記録を有効にするために、コードを追加する必要はありません。これらの自動的に収集されるイベントやプロパティは、Google タグマネージャーで使用できますが、ブロックすることはできません。

3. タグを配信する

Firebase イベント名変数、Firebase イベントパラメータ変数、その他の変数が、トリガーを設定するために使用されます。トリガー条件は、Firebase イベントをログに記録するたびに評価されます。デフォルトでは、Firebase Analytics イベントは自動的に配信されます。タグマネージャーに Firebase Analytics タグを追加して、イベントが Firebase Analytics に送信されるのをブロックできます。

4. コンテナをプレビュー、デバッグし、公開する

あるバージョンのコンテナを公開する前に、そのコンテナをプレビューして、意図したとおりに機能することを確認する必要があります。Google タグマネージャーを使用すると、管理画面でリンクと QR コードを生成し、それらを使用してアプリを開いて、各バージョンのコンテナをプレビューできます。詳細ログ記録モードを有効にして、予期しない動作をデバッグすることもできます。

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

コンテナをプレビューする前に、Google タグマネージャーの管理画面で、プレビューするコンテナのバージョンを選択し、[プレビュー] を選択することにより、プレビュー URL を生成します。後の手順で使用するために、このプレビュー URL を保存しておきます。

プレビュー URL は、タグマネージャー管理画面のプレビューウィンドウで利用できます — **図 1:** タグマネージャーの管理画面からプレビュー URL を取得する。

コンテナをプレビューするには（Android Studio を使用している場合は、手順 3 に進みます）:

次のプレビューアクティビティを AndroidManifest ファイルに追加します。

<!--  Add preview activity. -->
<activity
  android:name="com.google.android.gms.tagmanager.TagManagerPreviewActivity"
  android:noHistory="true">  <!-- optional, removes the previewActivity from the activity stack. -->
  <intent-filter>
    <data android:scheme="tagmanager.c.com.example.app" />
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE"/>
  </intent-filter>
</activity>

次の行を変更して、アプリのパッケージ名を含めます。
```
<data android:scheme="tagmanager.c.com.example.app"/>
```
Google タグマネージャーの管理画面で、プレビューリンクを生成します。
1. Google タグマネージャーアカウントにログインします。
2. モバイル向けのコンテナを選択します。
3. 上部のナビゲーションバーにある [バージョン] をクリックします。
4. プレビューするコンテナバージョンで [アクション] > [プレビュー] をクリックします。
5. アプリのパッケージ名を入力します。
6. [開始プレビューリンクを作成] をクリックします。
アプリを停止し、生成されたプレビューリンクまたは QR コードを使用してアプリを起動します。
プレビューモードを終了するには、管理画面の [終了プレビューリンクを作成] で生成されたリンクをクリックします。

コンテナをデバッグする

コンテナの実装に関する問題を解決するには、詳細ログ記録を有効にします。

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

コンテナを公開する

コンテナをプレビューし、機能していることを確認したら、コンテナを公開できます。コンテナを公開すると、モバイルアプリユーザーがお客様のタグ設定を利用できるようになります。

次のステップ

高度な設定をご覧ください。