Firebase SDKで記録したイベントをAppsFlyerに送信するための、Googleタグマネージャーの設定手順を説明します。
Googleタグマネージャーの設定
このセクションでは、Googleタグマネージャー(GTM)の画面で必要な設定を説明します。 GTMからAppsFlyerにイベントを送信するには、このセクションのすべての手順を実施する必要があります。記載された順に手順を進めてください。
以下の手順は、モバイルアプリ向けのGoogleタグマネージャーを対象としています。 Googleタグマネージャーの画面が各手順のスクリーンショットと異なる場合は、次の点を確認してください。
- Googleタグマネージャーのコンテナがモバイルアプリ用に設定されていること。
- コンテナのバージョンがv5であること。詳細は、こちらをご覧ください。
注意
このセクションでは購入イベントを例に説明しますが、送信したいほかのイベントにも同じ手順を適用できます。
1. イベントパラメータ変数の作成
イベントパラメータ変数を使うと、Googleタグマネージャーはイベントからデータを取得できます。イベントの送信時に、AppsFlyer IDとDevキーの変数も渡されます。 Googleタグマネージャーは、これらの変数を評価して値を取得します。イベントのデータには、次の2つの役割があります。
- AppsFlyer IDとDevキーをGoogleタグマネージャーに渡す
- イベント名とイベントパラメータをGoogleタグマネージャーに渡す
AppsFlyerデバイスIDとDevキー
GoogleタグマネージャーからAppsFlyerにイベントを送信する際は、必ずAppsFlyer IDとDevキーを含める必要があります。 Devキーにより、GoogleタグマネージャーとAppsFlyerのサーバーが通信できます。 AppsFlyer IDにより、イベントをどのユーザーに紐付けるかをAppsFlyerが判別できます。
- Googleタグマネージャーで[変数]、[新規]の順にクリックします。
- 変数名を「AppsFlyer Dev Key」にし、[変数の設定]をクリックします。
- [イベントパラメータ]を選択します。
- [カスタムパラメータ]を選択します。
- [イベントパラメータ]フィールドに「dev_key」と入力して保存します。
- AppsFlyer IDについても同様に、変数名を「AppsFlyer Device ID」にし、[イベントパラメータ]フィールドに「af_id」と入力します。
例
以下はGTM画面のスクリーンショットです。イベントパラメータの設定完了後の状態を示しています。
重要
iOSでは、追加のイベントパラメータを設定する必要があります。上記と同じ手順を進めます。変数を作成し、名前を「Apple App ID」にします。[イベントパラメータ]フィールドに「apple_app_id」と入力して保存します。
次に、アプリ内でAppsFlyer IDとDevキーの変数を作成・設定します。この手順は、イベントの送信セクションで説明します。
収益と価格
ほとんどのアプリ内イベントには、イベント値のパラメータが必要です。この例ではaf_revenueとaf_priceを使用しますが、任意のイベントパラメータを送信できます。アプリでイベントを設定したら、Googleタグマネージャーで収益と価格の変数を作成します。これらの変数は、後でPurchaseイベントのタグに使用します。
- Googleタグマネージャーで、af_revenueとaf_priceの2つのイベントパラメータ変数を作成します。
- 「af_revenue」の変数名を「Revenue」にし、[イベントパラメータキー]を「af_revenue」に設定します。
- 「af_price」の変数名を「Price」にし、[イベントパラメータキー]を「af_price」に設定します。
例
以下はGTM画面のスクリーンショットです。イベントパラメータの設定完了後の状態を示しています。
注意
この例では、RevenueとPriceのイベントパラメータ変数の作成方法を示しています。送信するイベントに応じて、任意のイベントパラメータの変数を作成できます。
2. 購入イベントのトリガーの作成
GoogleタグマネージャーがAppsFlyerへの送信対象イベントを判断できるように、イベントのトリガーを設定します。
- Googleタグマネージャーで[トリガー]、[新規]の順にクリックします。
- トリガー名を「Purchase」にし、[トリガーの設定]をクリックします。
- [カスタム]を選択します。
- [一部のイベント]を選択します。
- 条件として、[イベント名]が「af_purchase」と等しい場合にトリガーが発火するよう設定します。
- [保存]をクリックします。
例
以下はGTM画面のスクリーンショットです。トリガーの最終的な設定は、次のようになります。
3. 購入イベントのタグの作成
必要な変数とイベントトリガーを設定したら、Purchaseイベントのタグを作成できます。
- Googleタグマネージャーで[タグ]、[新規]の順にクリックします。
- タグ名を「Purchase」にし、[タグの設定]をクリックします。
- AppsFlyerを選択します。
-
[アプリケーションID]フィールドに、組み込み変数のApp IDを設定します。
重要
iOSでは、[アプリケーションID]フィールドにカスタム変数「apple_app_id」を設定します。
- [Devキー]フィールドで、「AppsFlyer Dev Key」変数を選択します。
- [AppsFlyerデバイスID]フィールドで、「AppsFlyer Device ID」変数を選択します。
- [イベント名]フィールドに、組み込み変数のEvent Nameを設定します。
- [イベント通貨]フィールドに、USDなどの通貨コードを設定します。
- [イベント値を追加]を2回クリックします。
- 次のように設定します。
キー:af_revenue、値:イベントパラメータ変数「Revenue」を選択
キー:af_price、値:イベントパラメータ変数「Price」を選択 - [トリガー]セクションの[配信トリガー] に、「Purchase」イベントのトリガーを設定します。
- [保存]をクリックします。
例
以下はGTM画面のスクリーンショットです。タグの最終的な設定は、次のようになります。
4. タグマネージャーのコンテナの公開
- Android:app/src/main/assets/containers
- iOS:ルートフォルダ/container