前提条件：連携の設定を始める前に、パートナーに問い合わせてアカウントを作成してください。

新しく連携を設定するには、以下の手順を実施します。

1. AppsFlyerで、［連携＞パートナー連携＞マーケットプレイス］タブに移動します。
   （既存の連携を編集する場合：［連携＞パートナー連携＞有効な連携］タブに移動します。）
2. 対象のアプリを選択します。
3. Google Analytics（GA4）を検索し、［連携する］を選択します。
4. ［連携］タブで、［パートナーを有効化］をオンにします。 
   注意：Google Analytics（GA4）と連携している間は、オン（有効）のままにしてください。詳細を見る
5. 以下の説明に従い、該当するタブで設定を完了します。

Google Analyticsの設定で使用するのは、［連携］タブのみです。

パートナー設定画面のヘッダーについて詳しくは、こちらを参照してください。

次の項目を設定します。

1. ［連携］タブで連携するアプリを選択し、［パートナーを有効化］をオンにします。

   注意：このパートナーと連携している間は、オン（有効）のままにしてください。

   パートナーの有効化について詳しくは、こちらを参照してください。

2. Firebase App IDに、Firebaseアプリの識別子を入力します。 Firebase App IDの確認方法は、Firebaseのドキュメントを参照してください。
3. API Secretに、Google Analyticsへのポストバックの認証に使用するAPIシークレットを入力します。 APIシークレットは、Google Analyticsの画面から生成します。シークレットの表示、編集、作成については、Googleのドキュメントの手順に従ってください。 Webデータストリームを選択するよう記載されている手順では、代わりにAndroidまたはiOSのデータストリームを選択してください。
4. 広告ID（IDFA）の代わりにカスタマーユーザーID（CUID）を送信するには、［カスタマーユーザーID］をオンにします。
5. ［デフォルトポストバック］セクションの［対象ユーザーの流入元］で、［オーガニックを含むすべてのメディアソース］を選択します。

AppsFlyerは、ユーザーのインストール後にGA4へポストバックを自動送信できます。インストールとリエンゲージメント（リアトリビューションを含む）が対象です。リエンゲージメントとは、すでにアプリをインストールしているユーザーが、キャンペーンリンクをクリックした後にアプリを開くことです。詳しくは、デフォルトポストバックを参照してください。

［連携］タブで、ポストバックで送信するAppsFlyerのアプリ内イベントをGoogle Analytics（GA4）のイベントに対応付けます。

1. ［アプリ内イベントポストバック］をオンにします。

2. ［イベントを追加］をクリックし、SDKイベントをリストに追加します。設定するフィールドを以下の表で説明します。

   パラメータ名	説明
   AppsFlyerイベント	アプリに組み込んだAppsFlyer SDKから受信したイベント名です。 ヒント：目的のイベントが表示されない場合は、 非オーガニックインストールのデバイスで対象イベントを発生させてから、もう一度確認してください。 ［AppsFlyerイベント］に名前を入力し、［カスタムイベントを作成］をクリックします。 詳しくは、カスタムイベントのマッピングを参照してください。
   パートナー側のイベント名／ID	パートナー側で定義されている各イベントの一意の名前またはIDです。次の方法で対応付けることができます。 テキストフィールド：対応するイベントIDをパートナーから取得します。 ドロップダウン：最も適切なAppsFlyerの定義済みイベントを選択します。 そのまま：名前を対応付けず、イベントをそのまま送信します。
   対象ユーザーの流入元	イベントの送信対象を選択します。 オーガニックを含むすべてのメディアソース：すべてのパートナーのイベントとオーガニックイベントのポストバックを送信します。
   送信するデータ	データなし（デフォルト）：イベント値を含めず、イベントそのものだけを送信します。 値と収益を送信する：収益値を含むすべてのイベントパラメータを送信します（イベントに収益値がある場合）。 値のみ送信し、収益は送信しない：収益値を除くすべてのパラメータを送信します。

3. ［任意］［条件を追加］アイコン（）をクリックし、イベントの条件を設定します。
4. ［連携を保存］をクリックします。
5. イベントポストバックのマッピングの共有

アプリ内イベントのマッピングを設定したら、対応付けたイベントを1行ずつ記載し、次の列を含む表を開発者に共有します。

• AF event：AppsFlyerのイベント名。
• Mapped to Google event：Google Analyticsのイベント名。

• AF event parameters（必須）：Google Analyticsに送信するイベントポストバックに必ず含める、AppsFlyerの定義済みイベントパラメータ。

イベントマッピング表

次の表には、Google Analyticsのすべてのイベントと、対応するAppsFlyerの定義済みパラメータが記載されています。対応付けたイベントのみを含む表を、開発者に共有してください。

Googleの予約済みイベント名

次のイベント名は予約済みのため、カスタムイベント名には使用できません。

• ad_activeview
• ad_click
• ad_exposure
• ad_query
• ad_reward
• adunit_exposure
• app_clear_data
• app_exception
• app_install
• app_remove
• app_store_refund
• app_update
• app_upgrade
• dynamic_link_app_open
• dynamic_link_app_update
• dynamic_link_first_open
• error
• firebase_campaign
• firebase_in_app_message_action
• firebase_in_app_message_dismiss
• firebase_in_app_message_impression
• first_open
• first_visit
• in_app_purchase
• notification_dismiss
• notification_foreground
• notification_open
• notification_receive
• notification_send
• os_update
• session_start
• user_engagement

app_instance_idはFirebaseアプリのインストールを、ga_session_idはFirebaseアプリのセッションを、それぞれ一意に識別します。これらの値をFirebase SDKから取得し、setAdditionalData APIを使ってGA4に送信します。

開発者に、以下の処理を実装するよう依頼します。

1. Firebaseからapp_instance_idとga_session_idのフィールドを取得します。
2. 初回起動前にsetAdditionalDataを呼び出し、インストール、セッション、アプリ内イベントにアプリインスタンスIDとga_session_idを含めます。

FirebaseAnalytics.getInstance(this).appInstanceId.addOnCompleteListener { task ->
   if (task.isSuccessful) {
       AppsFlyerLib.getInstance().setAdditionalData("app_instance_id", task.result)
    }
}

FirebaseAnalytics.getInstance(this).getAppInstanceId().addOnCompleteListener(task -> {
       if (task.isSuccessful()) {
           AppsFlyerLib.getInstance().setAdditionalData("app_instance_id", task.getResult());
       }
  });

let appInstanceId = Analytics.appInstanceID()
    AppsFlyerLib.shared().customData = ["app_instance_id": appInstanceId]

(void) fetchAnalyticsInstanceId {
           NSString *instanceID = [FIRAnalytics appInstanceID];
           [[AppsFlyerLib shared] setAdditionalData:@{@"app_instance_id": instanceID}];
}

using Firebase.Analytics;
    public class AnalyticsManager : MonoBehaviour
    {
        private async void Start()
        {
           AppsFlyer.initSDK(devKey, appID, this);
           string appInstanceId = await FirebaseAnalytics.GetAnalyticsInstanceIdAsync();
           Dictionary <string, string> customData = new Dictionary<string, string>();
           customData.Add("app_instance_id", appInstanceId);
           AppsFlyer.setAdditionalData(appInstanceId);
           AppsFlyer.startSDK();
        }
}

ga_session_idは、Firebaseアプリのセッションを一意に識別します。この値をFirebase SDKから取得し、setAdditionalData APIを使ってGA4に送信する必要があります。

開発者に、以下の処理を実装するよう依頼します。

1. Firebaseからga_session_idフィールドを取得します。
2. 初回起動前にsetAdditionalDataを呼び出し、セッションIDと、使用する場合はapp_instance_idを含めます。
3. APIの呼び出し時には、キーとしてga_session_idを使用します。

FirebaseAnalytics.getInstance(this).sessionId.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        AppsFlyerLib.getInstance().setAdditionalData("ga_session_id", task.result)
    }
}

FirebaseAnalytics.getInstance(this).getSessionId().addOnCompleteListener(task -> {
    if (task.isSuccessful()) {
        AppsFlyerLib.getInstance().setAdditionalData("ga_session_id", task.getResult());
    }
});

if #available(iOS 14.0, *) {
    Analytics.sessionID { sessionID, error in
        if let sessionID = sessionID {
            AppsFlyerLib.shared().customData = ["ga_session_id": sessionID]
        }
    }
}

- (void)fetchAnalyticsSessionId {
    if (@available(iOS 14.0, *)) {
        [FIRAnalytics sessionIDWithCompletion:^(NSString * _Nullable sessionID, NSError * _Nullable error) {
            if (sessionID) {
                [[AppsFlyerLib shared] setAdditionalData:@{@"ga_session_id": sessionID}];
            }
        }];
    }
}

using Firebase.Analytics;
using System.Threading.Tasks;
using AppsFlyerSDK;
using UnityEngine;
using System.Collections.Generic;

public class AnalyticsManager : MonoBehaviour
{
    private async void Start()
    {
        AppsFlyer.initSDK("yourDevKey", "yourAppID", this);

        // Get session ID
        string sessionId = await FirebaseAnalytics.GetSessionIdAsync();

        Dictionary<string, string> customData = new Dictionary<string, string>();
        customData.Add("ga_session_id", sessionId);
        AppsFlyer.setAdditionalData(customData);

        AppsFlyer.startSDK();
    }
}

GA4に送信するポストバックのイベントが、Google Analyticsに登録され、認識されていることを確認します。広告主がデータを確認する方法は、2つあります。

• GA4の探索では、関連するすべてのパラメータを含む、イベントのローデータを詳しく確認できます。前提条件：プロパティでBigQueryエクスポートを設定していること。

• イベントレポートでは、ポストバックのイベントを確認できます。このレポートは、1つ以上のレポートコレクションに含まれています。
  たとえば、ライフサイクルまたはゲームレポートコレクションの、エンゲージメント＞イベントからアクセスできます。 
  イベントレポートの詳細は、Googleのドキュメントを参照してください。

  

• トラフィック獲得レポートでは、Webサイトやアプリの訪問者の流入元を把握できます。

  ライフサイクルコレクションで、集客＞トラフィック獲得に移動します。

  トラフィック獲得レポートの詳細は、Googleのドキュメントを参照してください。