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

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

  • 更新

概要:AppsFlyerとのiOSの連携を、専用のアプリを使うことでレギュラーモード、高プライバシーポストバックでそれぞれポストバックをテストすることが可能です。

iOSの連携テスト 

テストは以下の要素で構成されています。

  • iOS版のAppsFlyerのパートナー連携アプリを使用して、まずはテストインストールを発火させ、続いてアプリ内で購入イベントを実施してください。これらのテストによって、あなたのアドネットワークのエンドポイントへポストバックが送信されます。また、ログインと会員登録完了のイベントをテストすることも可能です。 
  • ポストバックを受信したら、それらをシステムへ取り込むことができるかを確認してください。

テストの範囲

アドネットワークと共有するデータは、広告主が高プライバシーポストバックの設定で管理します。この設定はアプリユーザーの ATT の設定状況と連動しており、ポストバックの種類とアドネットワークへ共有されるデータ内容に影響します (詳細は、 高プライバシーポストバックガイド を参照してください。 )以下の表で、利用可能な設定の組み合わせに応じた、テストシナリオを示しています。

各シナリオ毎に、インストールとアプリ内イベントのテストが可能です。アプリ内イベントに関しては、アプリ内イベントをマッピングして、広告主イベントをパートナー側のイベントにマッピングすることが可能です。

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

シナリオ

Advanced Privacy setting アプリ側のATT設定  送信されるポストバックの種類
A OFF 許可 Regular
B オン Ask app not to track 高プライバシー
モード

テスト

前提条件の準備を全て完了してから、以降のセクションに記載されているテスト手順に従ってください。各テストセクションには、テスト結果を記録するのを助ける表が記載されています。

前提条件

テストを開始する前に、前提条件の準備を全て完了してください。

前提条件
AppsFlyerとのスタンダードな連携の完了
(必要に応じて、 パートナーアシスタントウィジェットを使用してAppsFlyerへお問い合わせください。 If necessary, contact AppsFlyer using the partner assistant widget.
AppsFlyerとの高プライバシーポストバックの連携の完了
(必要に応じて、 パートナーアシスタントウィジェットを使用してAppsFlyerへお問い合わせください。 If necessary, contact AppsFlyer using the partner assistant widget.
iOSのテストアプリのパートナーアカウントへの追加
テストアプリがあなたのパートナーアカウント内に表示されていることを確認。
アプリ内イベントのマッピング:
マッピングするイベント名:purchase / login / registration Event names to be mapped: purchase, login, registration
計測リンクの準備
iOS14.5以降の端末でのテスト実行

テスト—高プライバシーポストバック:OFF

ポストバックを発火させるには:

  1. AppsFlyerの管理画面上で、高プライバシーポストバックを有効にするをOFFに設定してください。
  2. 端末上では:
    1. テストアプリがまだインストールされていないことを確認してください。 Delete it if necessary.
    2. iPhoneのプライバシー設定の項目内で、アプリのトラッキング要求を許可 の設定がONになっていることを確認してください。

      PartnerIntegrationAllow.png

  3. テスト端末に計測リンクを送信し、
  4. 端末のブラウザ内で、計測リンクを開いてください。そうすると、AppStoreへリダイレクトされます。
  5. アプリをダウンロードして開いてください。
    そうすると、ATTの同意ダイアログが表示されます。

    AppDialogue_us-en.png

  6. 許可をタップしてください。
    その後、以下のようなインストールデータのページが表示されます。

    PartnerIntegrationInstallData.png

  7. ATT Statusのボタンをタップしてください。
    [ Authorized (承認済) ] のステータスが表示されます。
  8. 以下のパラメータを使用して、アトリビューション内容を検証してください。検証がうまく行かない場合には、トラブルシューティングを確認してください。

    1. install_time(インストール時間): 現在の時刻に近い時刻が入ります。タイムゾーンはUTCで記録されます。 
    2. af_status: Non-organic  Non-organicと表示されていない場合、インストールはあなたのメディアソースに紐付けられていません。 
    3. media_source : あなたのアドネットワーク名 
  9. In-App Event Testsをタップしてください。

    AppPurchase.png

  10. Purchase Eventをタップしてください。
    そうすると、購入イベントの確認が表示されます。 
  11. Verify that:
    1. インストールと購入イベントのポストバックを受け取ったこと。
    2. イベント名が正しくマッピングされていること。 (イベント名をマッピングした場合)
    3. You are able to ingest the postback.

高プライバシーポストバックOFF—テスト結果

ポストバック

イベントを発火させた時間 

想定のポストバックの種類 実際に受け取ったポストバック(成功/失敗) ポストバック内容の検証(成功/失敗)
インストール   Regular    
アプリ内イベント:Purchase   Regular    

テスト—高プライバシーポストバックON

ポストバックを発火させるには:

  1. AppsFlyerの管理画面上で、高プライバシーポストバックを有効にするをONに設定してください。
  2. 端末上では:
    1. テストアプリがまだインストールされていないことを確認してください。 Delete it if necessary.
    2. iPhoneのプライバシー設定の項目内で、アプリのトラッキング要求を許可 の設定がONになっていることを確認してください。

      PartnerIntegrationAllow.png

  3. テスト端末に計測リンクを送信し、
  4. 端末のブラウザ内で、計測リンクを開いてください。そうすると、AppStoreへリダイレクトされます。
  5. アプリをダウンロードして開いてください。
    そうすると、ATTの同意ダイアログが表示されます。

    AppDialogue_us-en.png

  6. Appにトラッキングしないように要求をタップしてください。その後、以下のようなインストールデータのページが表示されます。

    PartnerIntegrationInstallData.png

  7. ATT Statusのボタンをタップしてください。
    [拒否]のステータスが表示されます。
  8. 以下のパラメータを使用して、アトリビューション内容を検証してください。検証がうまく行かない場合には、トラブルシューティングを確認してください。 

    1. install_time(インストール時間): 現在の時刻に近い時刻が入ります。タイムゾーンはUTCで記録されます。 
    2. af_status: Non-organic  Non-organicと表示されていない場合、インストールはあなたのメディアソースに紐付けられていません。 
    3. media_source : あなたのアドネットワーク名 
  9. In-App Event Testsをタップしてください。

    AppPurchase.png

  10. Purchase Eventをタップしてください。
  11. Verify that:
    1. インストールと購入イベントのポストバックを受け取ったこと。
    2. イベント名が正しくマッピングされていること。 (イベント名をマッピングした場合)
    3. You are able to ingest the postback.

高プライバシーポストバックON—テスト結果

ポストバック

イベントを発火させた時間 

想定のポストバックの種類 実際に受け取ったポストバック(成功/失敗) ポストバック内容の検証(成功/失敗)
インストール   高プライバシー
モード
   
アプリ内イベント:Purchase   高プライバシー
モード
   

補足情報および手順詳細について

パートナー連携テストアプリについて

The Partner Integrations app is available in the App Store. The app sends install and in-app events to the AppsFlyer platform. 

アプリを初めて開くと、iOSのATTダイアログが表示され、インストールデータのページにAppsFlyerのプラットフォーム上に記録されたコンバージョンデータが表示されます。また、アプリ内イベントのテストもアプリの画面内で発火可能です。

PartnerIntegrationInstallData.png

以下のような機能が利用可能です:

  • アプリ内イベントのテスト
    purchase(購入) / login(ログイン) / registration(登録完了)のアプリ内イベントを送信します。各アプリ内イベントをアドネットワーク側のイベント名にマッピングすることで、そのイベント名を使用したポストバックを生成することも可能です。
  • ATTステータス
    iOSによって記録された、現状のATTステータス([Authorized](承認) / [Denied](拒否))の値を返します。 ATTステータスは、ATTの同意ダイアログで計測したユーザー同意状況と、端末上での [Appからのトラッキング要求を許可] の設定内容に依って異なります。 

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

Prepare an attribution link in the AppsFlyer dashboard, using one of the following methods:

  • AppsFlyerの管理画面上で計測リンクを作成する。
  • 以下のサンプルリンクを編集する。

管理画面上で計測リンクを作成するには:

  1. AppsFlyerの管理画面で、My Appsのタブに移動してください。
  2. id1543229303を選択してください。
  3. サイドメニューから連携 > 連携済みパートナー > アドネットワークを選択 > 計測リンクタブへ移動します。
  4. 計測リンクタブ内で、以下に記載されているパラメータを設定してください。必要であれば、任意のパラメータをさらに追加することも可能です。
    パラメーター 値の例: Remark
    Campaign c-test-2020-12-20 Set a value that is identifiable in your postbacks
  5. Copy the resulting link for later use. 

計測リンクのサンプル:


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

高プライバシーポストバックの設定

AdvancedPrivacyOff.png

高プライバシーポストバックの設定を変更するには: 

  1. AppsFlyerの管理画面で、My Appsのタブに移動してください。
  2. id1543229303のアプリを選択してください。
  3. サイドメニューから 連携 > 連携済みパートナー > アドネットワークを選択 > 連携へ移動します。
  4. 高プライバシーポストバックを有効にするの項目をテストシナリオごとに適切な設定に変更し、設定を保存してください。 
  5. 連携を保存 をクリックします。

パートナーアカウントへのテストアプリの紐付け

あなたのパートナーアカウントで、テストアプリが利用可能かどうかの確認方法: 

  1. AppsFlyerの管理画面で、My Appsのタブに移動してください。
  2. id1543229303のAppIDを持つテストアプリが、パートナーアカウント内の利用可能なアプリに表示されているかどうかを確認してください。もし見当たらない場合には、担当PDMまでご連絡ください。 

トラブルシューティング

症状 Cause/corrective action
インストール時刻が現在の時刻ではない。

The app wasn't deleted before the install.

Delete the app and repeat the procedure. 

計測されたメディアソースがあなたのメディアソース名ではなかった。 計測リンクに正しいpidの値が設定されているかどうか確認してください。また、正しい計測リンクを使用しているかどうかも確認してください。
af_statusがOrganicで計測される。

端末のOSバージョンが、前提条件に記載されているものに従っているかを確認してください。 

計測リンクの形式、特にpidの値を確認してみてください。