高プライバシーポストバック & ポストバックマクロ：アドネットワーク向け

多くのケースにおいて、ユーザーのATTへの同意状況に応じて、IDFAは配信面アプリ、広告主アプリ、またはその両方で使用できなくなるでしょう。そのようなシナリオにおいて、AppsFlyerでは確率論的モデリングと高プライバシー一括設定の機能を活用してアトリビューションを実施することがあります。

［推奨］計測情報を最大限充実させるために、表に記載されているパラメータを全て送信してください。

1. 計測URLに以下の各種パラメータを追加してください：

   識別情報	クリック パラメータ	例
   Campaign（キャンペーン）	c	US_20_30
   Campaign ID	af_c_id	12345
   Adset	af_adset	ADSET_1
   Adset ID	af_adset_id	56789
   Ad	af_ad	creative_name
   Ad ID	af_ad_id	34567
   Site ID	af_siteid	abcdefgh12345678
   Subsite ID	af_sub_siteid	abcdefgh12345678
   Channel（チャネル）	af_channel	channel_name
   Ad Type	af_ad_type	video
   iOSの端末モデル*	af_model	以下のどちらかを入力してください。 iphone (すべて小文字) ipad (すべて小文字)
   OS*	af_os	端末のOSバージョンを入力してください。
   ※ 一部の情報は、ユーザーエージェントを介して提供される場合があります。その場合には、特定のパラメータを使って送信された値の方が計測時に優先されます。

   
   クリックURLへのキャンペーン詳細の情報追加

   次の例を参考に、キャンペーン詳細に関するパラメータをクリックURLに追加してください：

   https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}&af_ad_type={Ad type}&af_siteid={PublisherId}

2. 各クリックURLに、以下の必須パラメータを追加してください*：
   
   

    警告

   クリックURLが各必須パラメータを渡さない場合、配信しているキャンペーンに紐づくべきインストールの大部分があなたの媒体成果として反映されなくなる可能性があるので注意してください。

   • IP
   • User-agent 

   *AppsFlyerへリダイレクトするシンプルなHTTPリファラを使用してクリックを送信している場合には、これらのパラメータを追加する必要はありません。 

   以下の方法のいずれかを使用している場合には、記載されている取得方法などを参考にしてクリックURLへパラメータとその値を追加してください： 

   • アプリ内でのリダイレクト(アプリ面)
   • サーバーtoサーバーでのクリック計測 (S2S)  

    高プライバシー計測用のパラメータ

   パラメータ名	必須	取得方法
   端末の言語設定と地域情報 af_lang	いいえ	NSString *language = [[NSLocale preferredLanguages] objectAtIndex:0]; ［推奨］言語と地域情報を左記の形式で提供してください。例：en-US
   User-agent af_ua	はい	以下の形式でユーザーエージェントを取得してください。 Mozilla%2F5.0+%28iPhone%3B+CPU+iPhone+OS+13_3_1 +like+Mac+OS+X%29 AppleWebKit%2F605.1.15+%28KHTML%2C +like+Gecko%29+Mobile%2F15E148 CFNetworkのユーザーエージェントは取得せず、それ以外のユーザーエージェントを取得してください。 ユーザーエージェントはURLエンコードされている必要があります。
   端末のIPアドレス af_ip	はい	推奨：可能であれば、af_ipのパラメータを使用する形で端末のIPアドレスを提供してください。 その他のオプション：利用可能な場合には、AppsFlyer側でX-Forwarded-For内のIPを利用します。

   
   クリックURLへのパラメータ追加

   クリック計測URLにおいて上記の必須パラメータをパスするには、以下の例を参考にしてください： 

   https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}&af_ad_type={Ad-type}&af_siteid={PublisherId}&af_ua={USER-AGENT}&af_lang={LANGUAGE}&af_ip={IP}

   サンプル

   GET https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID} &af_ad_type={Ad type}&af_siteid={PublisherId} &af_ua=Mozilla%2F5.0%20%28iPhone%3B%20CPU%20iPhone%20OS%2012_1_4%20 like%20Mac%20OS%20X%29%20AppleWebKit% 2F605.1.15%20%28KHTML%2C%20like%20Gecko%29%20Mobile%2F16D57&af_lang=en-US&af_ip=11.11.1.11

   * クエリパラメータはURLエンコードする必要があります。

   クリックURLヘッダー上で、データをパスしてください。

   クリックURLヘッダー上で各フィールドを渡すには、以下の例を使用してください。

   GET https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}&af_ad_type={Ad type}&af_siteid={PublisherId} accept-language: en-US,en;q=0. User-Agent: Mozilla/5.0(iPhone; CPU iPhone OS 13_5_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 X-Forwarded-For: 11.11.1.11,222.222.2.222

高プライバシーポストバックを受け取るには、レギュラーポストバックの連携に加えて、高プライバシーポストバックの連携を行う必要があります。高プライバシーポストバックの設定は、AppsFlyerのパートナーアカウント上でご自身で設定可能です。

レギュラーポストバックと高プライバシーポストバックのテンプレートの違い

• ポストバックは1時間毎にまとめて送信されます。
  • このバッチにはインストール、アプリ内イベントなどすべてのイベントタイプが含まれます。
  • このバッチには、成果の紐付いたアトリビューションデータと、ブロックされたリジェクトポストバックの両方が含まれます。
  • なお、0.001%のポストバックデータが後から別のバッチで送信される可能性があり、最大で24時間の遅延が発生する可能性があります。
• ポストバックの送信時間は実際のイベント発生時間とは異なります。
• タイムスタンプのマクロについて：
  • インストールとアプリ内イベントのデータの場合、タイムスタンプは発生した時間単位での情報に丸められます。
    例："22:55:30"というデータは"22:00:00"としてレポートされます。
  • UTCのタイムゾーンが適用されます。
    タイムスタンプの例：(2020-07-20 20:00:00)
• 高プライバシーポストバックでは、クリックID、Customer User ID、AppsFlyer ID、IDFA、IDFV、デバイスモデル、OSバージョン、キャリアといったパラメータは利用できません。

連携のために必要なアドネットワーク側のアクション

1. AppsFlyerのパートナーアカウント上での、高プライバシーポストバックの設定 
2. 高プライバシーポストバックの連携テスト

高プライバシーポストバックのエンドポイント [必要に応じて]

高プライバシーポストバックで利用可能なポストバックマクロ

AppsFlyerの管理画面上にある、ポストバック管理の機能を使って、高プライバシーポストバックを設定してください。

前提条件：

• 高プライバシーポストバックの設定を管理するには、AppsFlyerと有効な連携設定 / パートナーアカウントが必要です。パートナーアシスタントウィジェットを使用して連携を作成してください。
• ポストバック管理の画面は、パートナーアカウントのアドミン権限のみが利用可能で、チームメンバーにはアクセス権がありません。

ポストバックを設定するには：

1. トップバーから、アカウントメニュー（メールアドレスのドロップダウン） > ポストバック管理を開きます。
2. ポストバックタイプは高プライバシーポストバックを選択してください。 
3. トグルをONにして、設定画面をアクティブにしてください。

   

4. エンドポイントのアドレスを入力してください：AppsFlyerがポストバックを送信するエンドポイントのURLです。インストールとアプリ内イベントで、それぞれ関連するURLを入力してください。
5. ポストバック内に含めたいパラメータを入力してください。
   • パラメータ名：AppsFlyerのパラメータ表示名
   • 受け取り側のパラメータ名：御社側で値を受け取る際の各パラメータ名
   • パラメータの値(いくつかのパラメータで利用可能)：値のフォーマットを選択してください。例えばBoolean値の場合、"true"/"false"と1/0、どちらで受け取るのかを選択します。
   • Install: インストールのポストバックに含めたいパラメータにチェックを入れてください。
   • In-app event: アプリ内イベントのポストバックに含めたいパラメータにチェックを入れてください。

   

   高プライバシーポストバック用のマクロ一覧

6. ［任意］AppsFlyerでは提供していないカスタムパラメータも追加可能です。

   

7. 最後に、作成されたポストバックテンプレートのプレビューを確認して、全て正しく設定されていることを確認してください。

   

8. ［保存］をクリックしてください。この設定を保存すると、その変更内容がすぐに適用・有効になります。

問題が発生した場合は、パートナーアシスタントウィジェットを使用してお問い合わせください。

アナリティクスパートナーに対して、ポストバックは以下のように送信されます：

• AP OFF：制約なく、ユーザーレベルのポストバックが送信されます。
• AP ON：ユーザーの流入元とATTのステータスに応じて、以下表のようにポストバックが送信されます。

ATTステータスとユーザーの流入元毎のポストバックタイプ：アナリティクスパートナー向け

SKAdNetworkはAppleがiOS端末向けに提供しているアトリビューション技術です。一方、高プライバシーポストバックは高プライバシー一括設定(AAP)のフレームワークの一部であり、AppsFlyerによるアトリビューションに関連するものです。AAPにより、広告主はAppsFlyerのプラットフォームを介してユーザーレベルのアトリビューションデータの可用性を制御できます。そして多くのアドネットワークがAPとSKAdNetworkの両方の連携をサポートしています。