[注意] この記事はSKAdNetworkのポストバックには一切関係なく、広告主向けのものでもありません。
高プライバシーポストの更新情報
本ページ内に記載されている高プライバシーポストバックの機能は、以下条件に全て当てはまった場合に有効になります:
- ユーザーの端末がiOS 14.5以上を搭載していること
- 高プライバシーポストバックがONになっていること
この記事では以下の内容について記載しています:
- 高プライバシーポストバックが与えるパートナーへの影響
- アトリビューションの対象となるために必要な、Click URLの要件
- AppsFlyerの管理画面上での、高プライバシーポストバックのテンプレートの設定方法
- 高プライバシーポストバックとSKAdNetworkの違い
高プライバシーポストバックでのデータ共有の原則
iOS14.5以降、AppsFlyerの高プライバシー一括設定(AAP)のフレームワークはユーザーレベルのアトリビューションデータの可用性を管理する機能を広告主へ提供します。
アドネットワークにとっては、このAAPのフレームワークは高プライバシーポストバック(AP)の使用をもって適用されます。わかりやすく、このページでは高プライバシーポストバックをAPと略して記載してきます。
AP doesn't impact the customer's ability to make aggregated data available to partners or ad networks.
APの設定によって影響を受けるデータについて
When AP is on, the data customers may make available via postbacks or other reporting methods is aggregated only. User-level data, including Protect360 fraud-related reports, is not included.
In the context of postbacks, different postback types are used depending on whether an advertiser ID is available and other factors.
現在のAP設定は、アプリごとに確認できます: AppsFlyerのサイドメニューから、連携> 連携済みパートナー > アドネットワークを選択 > 連携タブデフォルト設定はONになっています。 The default setting is on.
ポストバックを送信するためのテンプレートの種類
- 通常のテンプレート:ユーザー識別子とアトリビューションデータマクロを使用したAppsFlyerとの既存の連携テンプレート。このテンプレートは、ユーザーレベルのアトリビューションデータを含むポストバックを送信するために使用されます。
-
高プライバシーポストバックテンプレート:ユーザー識別子マクロのないテンプレート。このテンプレートは、集計アトリビューションデータを含むポストバックを送信するために使用されます。
注意: 高プライバシーポストバックが必要で、高プライバシー連携が完了していない場合、ポストバックは送信されません。高プライバシー連携の作業はパートナーアカウント上のポストバック管理の画面を使って、ご自身で設定が可能です。
注意
- エンドユーザーが広告主アプリと広告配信アプリの両方でATTに同意した場合、レギュラーポストバックのテンプレートを使って成果の紐付いた媒体と成果の紐付いていない媒体へもポストバックが送信されます。
-
例外: Apple Search Ads(ASA)に紐づくインストールの場合、以下の条件で広告主に対して高プライバシーがオンになっている場合でも、ASAはインストールポストバックをアドネットワークに送信します。
- An Advertiser ID is unavailable
- アドネットワークのインストールポストバックを、オーガニックを含むすべてのメディアソースに設定した場合
- アドネットワークが高プライバシーポストバックをサポートしていない場合
使用されるポストバックの種類について
The following table describes postback types based on Advertiser ID availability and Advanced Privacy status.
iOS14.5以降使用されるポストバックの種類
| AP設定 | Advertiser ID Availability | APをサポートしている媒体への紐付いた成果*のポストバック | APをサポートしていない媒体への紐付いた成果*のポストバック | 紐付いていない成果のポストバック* | |
|---|---|---|---|---|---|
| 広告掲載アプリ | 広告主アプリ | ||||
| ON | Available | 拒否 | 高プライバシーポストバックテンプレート (集計データ) | ポストバック なし |
なし |
| ON | 拒否 | Available | 高プライバシーポストバックテンプレート (集計データ) | ポストバック なし |
(媒体関連の情報は利用不可)* |
| ON | Available | Available | Regular template. This includes available IDs like: IDFA, IDFV, CUID, Click ID and attribution fields. |
https://support.appsflyer.com/hc/ja/articles/360011316197#types-of-templates-for-sending-postbacks レギュラーポストバック (IDFA, IDFV, CUID, Click IDなどのユーザー情報を含む) |
レギュラーテンプレート(IDFA / IDFV / CUID / ClickIDなどの利用可能な各種IDと、媒体関連の情報を含む) Attribution fields aren't available.* |
| ON | 拒否 | 拒否 | 高プライバシーポストバックテンプレート (集計データ) | ポストバック なし |
なし |
| OFF | Not considered | Not considered | レギュラーテンプレート | レギュラーテンプレート |
レギュラーテンプレート (媒体関連の情報は利用不可)* |
(*)パートナーとのデータ共有の原則
特定のイベントについて、AppsFlyerでは複数のアドネットワークがポストバックを受け取ることが可能です。送信されるポストバックは以下の通りです:
- Attributed partner: Ad network credited with the event
-
成果が紐づけられなかったパートナー:成果やイベントが紐付いていない連携済みパートナーも、アプリ内イベントのポストバック設定において、送信オプションの設定を、オーガニックを含むすべてのメディアソースにした場合に、ポストバックを受け取ります。広告主アプリにおいてATTダイアログにユーザーが同意した場合、ポストバックに他社媒体情報は含まれませんが、各種ユーザーIDは含まれます。(この送信オプションの機能は全てのアドネットワークでサポートしているわけではありません。 )
Web面での広告配信
アドネットワークがWeb面上で広告を表示している場合、APの挙動が異なります。
そのクリックがWeb面とアプリ面のどちらから送信されたものであるかを示すには、クリック計測URLにaf_media_type=webもしくは af_media_type=appのパラメータを新たに追加する必要があります。
af_media_typeのパラメータが送信されない場合、常にアプリ面として取り扱われます。
APがON かつ iOS14.5以降において使用されるポストバックタイプ
| ATTのステータス | 紐付いた成果のポストバックタイプ* | 紐付いていない成果のポストバックタイプ* | |
|---|---|---|---|
| 広告掲載アプリ | 広告主アプリ | ||
| N/A | 許可 | Advanced Privacy | なし |
| N/A | 許可 | Regular. User-level with the following IDs: IDFA, IDFV, CUID, Click ID. | Regular. User-level IDs only. |
Integration
クリックURLをアップデートして、高プライバシーポストバックの連携を完了してください。
Click URL requirements
多くのケースにおいて、ユーザーのATTへの同意状況に応じて、IDFAは配信面アプリ、広告主アプリ、またはその両方で使用できなくなるでしょう。そのようなシナリオにおいて、AppsFlyerでは確率論的モデリングと高プライバシー一括設定の機能を活用してアトリビューションを実施することがあります。
[推奨]計測情報を最大限充実させるために、表に記載されているパラメータを全て送信してください。
-
クリック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 The device model. Values permitted:
- iphone (すべて小文字)
- ipad (すべて小文字)
OS* af_os The operating system version ※ 一部の情報は、ユーザーエージェントを介して提供される場合があります。その場合には、特定のパラメータを使って送信された値の方が計測時に優先されます。
クリック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} -
各クリックURLに、以下の必須パラメータを追加してください*:
Caution
クリックURLが各必須パラメータを渡さない場合、配信しているキャンペーンに紐づくべきインストールの大部分があなたの媒体成果として反映されなくなる可能性があるので注意してください。
- IP
- User-agent
*AppsFlyerへリダイレクトするシンプルなHTTPリファラを使用してクリックを送信している場合には、これらのパラメータを追加する必要はありません。
以下の方法のいずれかを使用している場合には、記載されている取得方法などを参考にしてクリックURLへパラメータとその値を追加してください:
- アプリ内でのリダイレクト(アプリ面)
- サーバーtoサーバーでのクリック計測 (S2S)
高プライバシー計測用のパラメータ
パラメータ名 必須 Extraction method 端末の言語設定と地域情報
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/15E148X-Forwarded-For: 11.11.1.11,222.222.2.222
高プライバシーポストバックの仕様について
高プライバシーポストバックを受け取るには、レギュラーポストバックの連携に加えて、高プライバシーポストバックの連携を行う必要があります。高プライバシーポストバックの設定は、AppsFlyerのパートナーアカウント上でご自身で設定可能です。
レギュラーポストバックと高プライバシーポストバックのテンプレートの違い
- ポストバックの送信時間は実際のイベント発生時間とは異なります。
- タイムスタンプのマクロについて:
- インストールとアプリ内イベントのデータの場合、タイムスタンプは発生した時間単位での情報に丸められます。
例:"22:55:30"というデータは"22:00:00"としてレポートされます。 - UTCのタイムゾーンが適用されます。
タイムスタンプの例:(2020-07-20 20:00:00)
- インストールとアプリ内イベントのデータの場合、タイムスタンプは発生した時間単位での情報に丸められます。
- 高プライバシーポストバックでは、クリックID、Customer User ID、AppsFlyer ID、IDFA、IDFV、デバイスモデル、OSバージョン、キャリアといったパラメータは利用できません。
連携のために必要なアドネットワーク側のアクション
重要!
正当なイベントのポストバックと拒否されたポストバックを区別できるようにするには、拒否されたポストバックマクロを構成する必要があります。
- 拒否されたインストール/イベントのポストバックを有効にするには、パートナーアシスタントウィジェットを使用してお問い合わせください。
高プライバシーポストバックのエンドポイント [必要に応じて]
| ポストバックの種類 |
|---|
| インストール |
| アプリ内 |
高プライバシーポストバックで利用可能なポストバックマクロ
| ポストバックマクロ名 | 備考 | 全ポストバック向けの基本パラメータ | アプリ内イベント専用のパラメータ | Optional parameters for rejected attribution |
|---|---|---|---|---|
| af_ad | クリエイティブ名 | はい | ||
| af_ad_id | 34567 | はい | ||
| af_ad_type | 例: banner, footer, video |
はい | ||
| af_adset | ADSET_1 | はい | ||
| af_adset_id | 56789 | はい | ||
| 取得方法 | - | はい | ||
| アプリによって異なるイベント名が入ります | - | はい | ||
| attributed_touch_hour |
Rounded down to the nearest hour. Format: |
はい | ||
| attributed_touch_type | 例:click, impression | はい | ||
| blocked_reason | 検証ルール/Protect360に関連します | はい | ||
| blocked_reason_value | 検証ルール/Protect360に関連します | はい | ||
| blocked_sub_reason | 検証ルール/Protect360に関連します | はい | ||
| bundle_id | 広告主側で設定 | はい | ||
| c | キャンペーン名など 例:US_20_30 |
はい | ||
| af_c_id | キャンペーンIDなど 例:12345 |
はい | ||
| af_channel | チャネル名 | はい | ||
| country_code | コンバージョン記録時のISO国コード | はい | ||
| event_hour |
Rounded down to the nearest hour. Format: |
はい | ||
| event_name | As reported by the app | はい | ||
| event_revenue | event_currencyに基づく収益金額 | はい | ||
| event_revenue_ currency |
収益の通貨単位 | はい | ||
| event_revenue_usd | USDに換算された収益金額 | はい | ||
| 時間(Hour)単位に切り捨て |
Rounded down to the nearest hour. Format: |
はい | ||
| is_first | そのアプリ内イベントが、そのユーザーにとって初めて発火されたイベントだった場合にはTrueが入ります | はい | ||
| is_primary |
Use to deduplicate Boolean: 0, 1 |
はい | ||
| is_retargeting |
Use to deduplicate Format: |
はい | ||
| is_reengagement | Format: 注(2)を参照してください |
はい | ||
| is_reattribution |
Use to deduplicate Format: |
はい | ||
| match_type | 例:id_matching, probabilistic | はい | ||
| event_id | アドネットワークのプラットフォーム上で発生したイベントと称号するための名称またはIDです | はい | ||
| platform | 例:ios, android | はい | ||
| postback_id | ポストバック毎にユニークなID | はい | ||
| retargeting_ conversion_type |
例:re-engagement, re-attribution | はい | ||
| af_siteid | abcdefgh12345678 | はい | ||
| af_sub_siteid | abcdefgh12345678 | はい | ||
|
注: (1) 利用可能なタイムスタンプ形式:
(2) Booleanの形式が利用可能
| ||||
高プライバシーポストバックの設定方法について
AppsFlyerの管理画面上にある、ポストバック管理の機能を使って、高プライバシーポストバックを設定してください。
前提条件:
- 高プライバシーポストバックの設定を管理するには、AppsFlyerと有効な連携設定 / パートナーアカウントが必要です。パートナーアシスタントウィジェットを使用して連携を作成してください。
-
ポストバック管理の画面は、パートナーアカウントのアドミン権限のみが利用可能で、チームメンバーにはアクセス権がありません。
ポストバックを設定するには:
- トップバーから、アカウントメニュー(メールアドレスのドロップダウン) > ポストバック管理を開きます。
- ポストバックタイプは高プライバシーポストバックを選択してください。
-
Activate the builder.
- エンドポイントのアドレスを入力してください:AppsFlyerがポストバックを送信するエンドポイントのURLです。インストールとアプリ内イベントで、それぞれ関連するURLを入力してください。
-
ポストバック内に含めたいパラメータを入力してください。
- パラメータ名:AppsFlyerのパラメータ表示名
- 受け取り側のパラメータ名:御社側で値を受け取る際の各パラメータ名
- パラメータの値(いくつかのパラメータで利用可能):値のフォーマットを選択してください。例えばBoolean値の場合、"true"/"false"と1/0、どちらで受け取るのかを選択します。
- Install: インストールのポストバックに含めたいパラメータにチェックを入れてください。
- In-app event: アプリ内イベントのポストバックに含めたいパラメータにチェックを入れてください。
https://support.appsflyer.com/hc/ja/articles/360011316197#advanced-privacy-postback-specification
-
[任意]AppsFlyerでは提供していないカスタムパラメータも追加可能です。
-
最後に、作成されたポストバックテンプレートのプレビューを確認して、全て正しく設定されていることを確認してください。
- [保存]をクリックしてください。この設定を保存すると、その変更内容がすぐに適用・有効になります。
問題が発生した場合は、パートナーアシスタントウィジェットを使用してお問い合わせください。
追加情報
アナリティクスパートナー向けのAP
アナリティクスパートナーに対して、ポストバックは以下のように送信されます:
- AP OFF:制約なく、ユーザーレベルのポストバックが送信されます。
- AP on: Postback type depends on user source and Advertiser ID availability, as detailed in the following table.
ATTステータスとユーザーの流入元毎のポストバックタイプ:アナリティクスパートナー向け
| User source | Advertiser ID availability | アナリティクスパートナー向けのポストバックタイプ | |
|---|---|---|---|
| 広告掲載アプリ | 広告主アプリ | ||
|
非オーガニック
|
Available | Available | Regular |
| 拒否 | Available | なし | |
| Any value | 拒否 | なし | |
| オーガニック / Web | N/A | Available | Regular |
| オーガニック / Web | N/A | 拒否 | なし |
APとSKAdNetwork
SKAdNetworkはAppleがiOS端末向けに提供しているアトリビューション技術です。一方、高プライバシーポストバックは高プライバシー一括設定(AAP)のフレームワークの一部であり、AppsFlyerによるアトリビューションに関連するものです。 AAPにより、広告主はAppsFlyerのプラットフォームを介してユーザーレベルのアトリビューションデータの可用性を制御できます。そして多くのアドネットワークがAPとSKAdNetworkの両方の連携をサポートしています。