どのようにお手伝いできますか?

アドネットワーク向けiOS連携テスト

  • 更新

概要:AppsFlyer Partner Integrationsアプリで通常のポストバックと高プライバシーモード(AP)のポストバックを発生させ、AppsFlyerとのiOS連携をテストします。

iOS連携テスト 

テストでは、以下を行います。

  • iOS版のAppsFlyer Partner Integrationsアプリを使い、テスト用にアプリをインストールし、購入のアプリ内イベントを発生させます。これにより、指定したエンドポイントにポストバックが送信されます。ログインと登録のアプリ内イベントもテストできます。 
  • ポストバックを受信したら、自社システムに取り込み、処理できることを確認します。

テストの範囲

広告主は、高プライバシーモード(AP)の設定で、アドネットワークと共有するデータを制御します。この設定とアプリユーザーのATT設定の組み合わせにより、送信するポストバックの種類や、アドネットワークと共有するデータの内容が変わります。詳しくは、高プライバシーモード(AP)のポストバックガイドを参照してください。以下の表に、設定の組み合わせに応じたテストシナリオを示します。

各シナリオで、インストールとアプリ内イベントをテストできます。アプリ内イベントについては、アプリ内イベントのマッピングを使い、広告主のイベントを自社のイベントに対応付けることができます。

テストシナリオと設定の組み合わせ

シナリオ

高プライバシーモード(AP)の設定 アプリでのATT設定  送信されるポストバックの種類
A オフ 許可 通常
B オン アプリにトラッキングしないように要求 高プライバシーモード(AP)

テストの実施

事前準備を済ませてから、以下の各セクションの手順に沿ってテストを実施してください。各テストのセクションには、結果の記録に使用できる表があります。

事前準備

テストを始める前に、以下の準備を済ませてください。

事前準備
AppsFlyerとの標準の連携を完了します。必要に応じて、Partner AssistantのウィジェットからAppsFlyerにお問い合わせください。
AppsFlyerとの高プライバシーモード(AP)の連携を完了します。必要に応じて、Partner AssistantのウィジェットからAppsFlyerにお問い合わせください。
iOSテストアプリと自社アカウントの連携を設定します。
テストアプリが自社アカウントに連携されていることを確認します。
アプリ内イベントを自社のイベント名にマッピングします。マッピングするイベント名:purchase、login、registration
アトリビューションリンクを準備します。
iOS 14.5以降のデバイスでのテスト

高プライバシーモード(AP)がオフの場合のテスト

ポストバックを発生させるには、次の手順を実行します。

  1. AppsFlyer管理画面で、[Enable Advanced Privacy(高プライバシーモードを有効にする)]をオフにします。
  2. テストデバイスで、以下を行います。
    1. テストアプリがインストールされていないことを確認します。インストールされている場合は削除します。
    2. プライバシー設定で、[アプリからのトラッキング要求を許可]がオンになっていることを確認します。

      PartnerIntegrationAllow.png

  3. アトリビューションリンクをテストデバイスに送信します。
  4. デバイスのブラウザーでアトリビューションリンクを開きます。
    App Storeにリダイレクトされます。
  5. アプリをダウンロードして起動します。
    ATTの許可を求めるダイアログが表示されます。

    AppDialogue_us-en.png

  6. [許可]をタップします。
    [Install Data(インストールデータ)]画面が表示されます。

    PartnerIntegrationInstallData.png

  7. [ATT Status(ATTの許可状況)]をタップします。
    [Authorized(許可済み)]と表示されます。
  8. 以下のパラメータで、アトリビューションが正しく行われたことを確認します。正しくアトリビューションされていない場合は、トラブルシューティングを参照してください。

    1. install_time:現在の時刻に近い値になっていること。時刻はUTCです。 
    2. af_status: Non-organic:この値になっていない場合、インストールはアトリビューションされていません。 
    3. media_source:自社のアドネットワークになっていること。 
  9. [In-App Event Tests(アプリ内イベントのテスト)]をタップします。

    AppPurchase.png

  10. [Purchase Event(購入イベント)]をタップします。
    購入イベントの確認メッセージが表示されます。 
  11. 以下を確認します。
    1. インストールと購入のポストバックを受信していること。
    2. イベント名が正しくマッピングされていること(アプリ内イベントをマッピングした場合)。
    3. ポストバックを自社システムに取り込み、処理できること。

高プライバシーモード(AP)がオフの場合のテスト結果

ポストバック

イベントを発生させた時刻 

想定されるポストバックの種類 実際に受信したポストバック(合格 / 不合格) ポストバックの検証(合格 / 不合格)
インストール   通常    
アプリ内イベント:購入   通常    

高プライバシーモード(AP)がオンの場合のテスト

ポストバックを発生させるには、次の手順を実行します。

  1. AppsFlyer管理画面で、[Enable Advanced Privacy(高プライバシーモードを有効にする)]をオンにします。
  2. テストデバイスで、以下を行います。
    1. テストアプリがインストールされていないことを確認します。インストールされている場合は削除します。
    2. プライバシー設定で、[アプリからのトラッキング要求を許可]がオンになっていることを確認します。

      PartnerIntegrationAllow.png

  3. アトリビューションリンクをテストデバイスに送信します。
  4. デバイスのブラウザーでアトリビューションリンクを開きます。
    App Storeにリダイレクトされます。
  5. アプリをダウンロードして起動します。
    ATTの許可を求めるダイアログが表示されます。

    AppDialogue_us-en.png

  6. [アプリにトラッキングしないように要求]をタップします。
    [Install Data(インストールデータ)]画面が表示されます。

    PartnerIntegrationInstallData.png

  7. [ATT Status(ATTの許可状況)]をタップします。
    [Denied(拒否済み)]と表示されます。
  8. 記載されたパラメータで、アトリビューションが正しく行われたことを確認します。正しくアトリビューションされていない場合は、トラブルシューティングを参照してください。 

    1. install_time:現在の時刻に近い値になっていること。時刻はUTCです。 
    2. af_status: Non-organic:この値になっていない場合、インストールはアトリビューションされていません。 
    3. media_source:自社のアドネットワークになっていること。 
  9. [In-App Event Tests(アプリ内イベントのテスト)]をタップします。

    AppPurchase.png

  10. [Purchase Event(購入イベント)]をタップします。
  11. 以下を確認します。
    1. インストールと購入のポストバックを受信していること。
    2. イベント名が正しくマッピングされていること(アプリ内イベントをマッピングした場合)。
    3. ポストバックを自社システムに取り込み、処理できること。

高プライバシーモード(AP)がオンの場合のテスト結果

ポストバック

イベントを発生させた時刻 

想定されるポストバックの種類 実際に受信したポストバック(合格 / 不合格) ポストバックの検証(合格 / 不合格)
インストール   高プライバシーモード(AP)    
アプリ内イベント:購入   高プライバシーモード(AP)    

補足情報と手順

Partner Integrationsテストアプリについて

Partner Integrationsアプリは、App Storeで入手できます。このアプリは、インストールとアプリ内イベントをAppsFlyerに送信します。 

アプリを初めて起動すると、iOSのトラッキングの許可を求めるダイアログが表示されます。その後、[Install Data(インストールデータ)]画面に、AppsFlyerに記録されたコンバージョンデータが表示されます。アプリの画面を操作して、テスト用のアプリ内イベントを発生させます。

PartnerIntegrationInstallData.png

以下の機能を利用できます。

  • [In-App Event Tests(アプリ内イベントのテスト)]
    purchase、login、registrationのアプリ内イベントを送信します。テストアプリのイベント名を自社のイベント名にマッピングすると、ポストバックに自社のイベント名が設定されます。
  • [ATT Status(ATTの許可状況)]
    iOSが報告する現在のATTの許可状況を、[Authorized(許可済み)]または[Denied(拒否済み)]として返します。 ATTの許可状況は、ATTの許可ダイアログでのユーザーの選択と、デバイスの[アプリからのトラッキング要求を許可]の設定によって決まります。 

アトリビューションリンク

以下のいずれかの方法で、AppsFlyer管理画面からアトリビューションリンクを準備します。

  • AppsFlyer管理画面でリンクを生成します。
  • 以下のサンプルリンクを編集します。

管理画面でリンクを生成するには、次の手順を実行します。

  1. AppsFlyerで、[My Apps(マイアプリ)]に移動します。
  2. id1543229303を選択します。
  3. サイドメニューで[Collaborate(連携)] > [Active Integrations(有効な連携)]を選択し、自社のアドネットワークを選んで[Attribution link(アトリビューションリンク)]タブを開きます。
  4. [Attribution link(アトリビューションリンク)]タブで、表に記載されたパラメータを設定します。必要に応じて、ほかのパラメータも追加できます。
    パラメータ 設定値の例 補足
    キャンペーン c-test-2020-12-20 ポストバックで識別しやすい値を設定します。
  5. 生成したリンクを、後で使用できるようにコピーします。 

アトリビューションリンクの例:


https://app.appsflyer.com/id1543229303?pid=pitestap_int&c=c-test-2020-12-20

高プライバシーモード(AP)の設定

AdvancedPrivacyOff.png

[Enable Advanced Privacy(高プライバシーモードを有効にする)]の設定を変更するには、次の手順を実行します。 

  1. AppsFlyerで、[My Apps(マイアプリ)]に移動します。
  2. アプリid1543229303を選択します。
  3. サイドメニューで[Collaborate(連携)] > [Active Integrations(有効な連携)]を選択し、自社のアドネットワークを選んで[Integration(連携)]タブを開きます。
  4. 各テストシナリオに合わせて、[Enable Advanced Privacy(高プライバシーモードを有効にする)]を設定します。 
  5. [Save Integration(連携設定を保存)]をクリックします。

テストアプリと自社アカウントの連携の確認

自社アカウントでテストアプリを利用できることを確認するには、次の手順を実行します。 

  1. AppsFlyerで、[My Apps(マイアプリ)]に移動します。
  2. [Available Apps(利用可能なアプリ)]に、Partner Integrations id1543229303アプリが表示されていることを確認します。表示されていない場合は、担当のPartner Development Managerにお問い合わせください。 

トラブルシューティング

症状 原因 / 対処方法
インストール日時が現在の時刻と一致しない

インストール前にアプリが削除されていませんでした。

アプリを削除し、手順をやり直してください。 

メディアソースが自社のアドネットワークになっていない アトリビューションリンクのpidに、正しい値が設定されていることを確認してください。正しいアトリビューションリンクを使用していることを確認してください。
af_statusがOrganicになっている

デバイスのiOSバージョンが、事前準備に記載された条件を満たしていることを確認してください。 

アトリビューションリンクの形式、特にpidの値を確認してください。