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

概要

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

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

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

事前の準備

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

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

スタートガイド

  1. Google タグ マネージャーをプロジェクトに追加します
  2. イベントと変数をログに記録します
  3. タグを配信します
  4. コンテナをプレビュー、デバッグし、公開します

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

  1. モジュールの Gradle ファイル(通常は app/build.gradle)に、タグ マネージャー ライブラリに対する次の依存関係を追加します。
    dependencies {
      // ...
      compile 'com.google.android.gms:play-services-tagmanager:11.0.4'
    }
    
  2. Google タグ マネージャー アカウントにログインします。
  3. モバイル向けのコンテナを選択します。
  4. 上部のナビゲーション バーにある [バージョン] をクリックします。
  5. 選択したコンテナ バージョンで [アクション] > [ダウンロード] をクリックします。

    コンテナをダウンロードする

  6. app/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_namefull_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 に進みます):

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

コンテナをデバッグする

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

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

コンテナを公開する

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

次のステップ

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