アドネットワーク向けAPの最新情報
この記事で説明するAPのポストバックの仕組みは、以下の条件をすべて満たす場合に適用されます。
- ユーザーのデバイスがiOS 14.5以降である
- APが有効になっている
この記事で説明する内容:
- APによるデータ共有がパートナーに与える影響
- アトリビューションの対象となるためのクリックURLの要件
- AppsFlyer管理画面でのAPのポストバックの設定
- APとSKAdNetworkの違い
アドネットワークへのデータ共有に関するAPの基本方針
iOS 14.5以降では、AppsFlyerの高プライバシー一括設定(AAP)により、AppsFlyerプラットフォームを通じて共有するユーザーレベルのアトリビューションデータを広告主が管理できます。
アドネットワークとのデータ共有では、このAAPの仕組みが高プライバシーモード(AP)として実装されています。この記事では、読みやすさを考慮し、「高プライバシーモード」と「AP」を同じ意味で使用します。
APを有効にしても、広告主はパートナーやアドネットワークに集計データを共有できます。
APの影響を受けるデータ
APが有効な場合、広告主がポストバックなどのレポート手段を通じて共有できるのは集計データのみです。 Protect360の不正関連レポートを含め、ユーザーレベルのデータは共有されません。
ポストバックでは、広告IDを取得できるかどうかなどの条件に応じて、異なる種類のポストバックが使用されます。
APの設定はアプリごとに確認できます。AppsFlyerのサイドメニューで[連携(Collaborate)] > [有効な連携(Active Integrations)]を選択し、対象のアドネットワークを開いて連携タブを確認してください。 デフォルトでは有効になっています。
ポストバックの送信に使用するテンプレートの種類
- 通常のテンプレート:ユーザー識別子とアトリビューションデータのマクロを含む、AppsFlyerとの既存の連携テンプレートです。ユーザーレベルのアトリビューションデータを含むポストバックの送信に使用されます。
-
AP用テンプレート:ユーザー識別子のマクロを含まないテンプレートです。集計されたアトリビューションデータを含むポストバックの送信に使用されます。
注意:APのポストバックが必要な場合でも、AP連携が完了していなければポストバックは送信されません。 AP連携は、セルフサービスのポストバック管理(Postback Management)ツールで設定できます。
注意
- ユーザーが広告主とパブリッシャーの両方のアプリでATTに同意している場合、アトリビューション先のアドネットワークにも、それ以外のアドネットワークにも、通常のポストバックが送信されます。
-
例外:Apple Search Ads(ASA)にアトリビューションされたインストールでは、以下の条件を満たす場合、広告主がAPを有効にしていても、ASAからアドネットワークにインストールポストバックが送信されます。
- 広告IDを取得できない
- アドネットワークのインストールポストバックがオーガニックを含むすべてのメディアソースに設定されている
- アドネットワークがAPに対応していない
使用されるポストバックの種類
以下の表に、広告IDを取得できるかどうかとAPの設定に応じて使用されるポストバックの種類を示します。
iOS 14.5以降でのポストバックの種類
| APの設定 | 広告IDの取得可否 | APに対応しているアトリビューション先のパートナー*へのポストバックテンプレート | APに対応していないアトリビューション先のパートナー*へのポストバックテンプレート | アトリビューション先以外のポストバック受信パートナー* | |
|---|---|---|---|---|---|
| パブリッシャーのアプリ | 広告主のアプリ | ||||
| 有効 | 取得可能 | 取得不可 | AP用テンプレート(集計データ) | 送信なし | 送信なし |
| 有効 | 取得不可 | 取得可能 | AP用テンプレート(集計データ) | 送信なし |
アトリビューション関連のフィールドは含まれません。* |
| 有効 | 取得可能 | 取得可能 | 通常のテンプレート。 IDFA、IDFV、CUID、クリックIDなど、取得可能なIDとアトリビューション関連のフィールドが含まれます。 | 通常のテンプレート。 IDFA、IDFV、CUID、クリックIDなど、取得可能なIDとアトリビューション関連のフィールドが含まれます。 | 取得可能なIDを含む通常のテンプレート。アトリビューション関連のフィールドは含まれません。* |
| 有効 | 取得不可 | 取得不可 | AP用テンプレート(集計データ) | 送信なし | 送信なし |
| 無効 | 判定対象外 | 判定対象外 | 通常のテンプレート | 通常のテンプレート |
アトリビューション関連のフィールドは含まれません。* |
(*)パートナーへのデータ共有に関する基本方針
1つのイベントについて、複数のアドネットワークパートナーがポストバックの受信対象となる場合があります。送信されるポストバックは、以下のとおりです。
- アトリビューション先のパートナー:イベントがアトリビューションされたアドネットワーク。
-
アトリビューション先以外のパートナー:イベントがアトリビューションされていない連携パートナー。アプリ内イベントポストバック > 送信オプションがオーガニックを含むすべてのメディアソースに設定されている場合に送信されます。広告主のアプリでATTの同意を得ている場合、ポストバックにはユーザーIDが含まれますが、アトリビューションデータは含まれません。(このオプションに対応していないアドネットワークもあります。)
Webキャンペーン
アドネットワークがWeb上に広告を配信する場合、APの動作は異なります。
クリックの発生元がWebかアプリかを示すため、クリックURLにaf_media_type=webまたはaf_media_type=appを含めて送信する必要があります。
af_media_typeを送信しない場合、デフォルト値はappです。
APが有効な場合のiOS 14.5以降でのポストバックの種類
| ATTステータス | アトリビューション先のパートナー*へのポストバックの種類 | アトリビューション先以外のパートナー*へのポストバックの種類 | |
|---|---|---|---|
| パブリッシャーのアプリ | 広告主のアプリ | ||
| 該当なし | 同意なし | 高プライバシーモード(AP) | 送信なし |
| 該当なし | 同意あり | 通常のポストバック。次のIDを含むユーザーレベルのデータ:IDFA、IDFV、CUID、クリックID。 | 通常のポストバック。ユーザーレベルのIDのみ。 |
連携
クリックURLを更新し、AP連携を完了してください。
クリックURLの要件
パブリッシャーのアプリ、広告主のアプリ、またはその両方で、広告IDを取得できないケースは少なくありません。このような場合は、高プライバシー一括設定(AAP)の仕組みや、プライバシーを保護するその他のキャンペーン計測手法を使用してアトリビューションを行います。
[推奨]アトリビューションの機会を最大限に確保するため、以下に挙げるパラメータをすべて送信してください。
-
クリックURLに次のパラメータを追加してください。
識別項目 クリックパラメータ 例 キャンペーン c US_20_30 キャンペーンID af_c_id 12345 広告セット af_adset ADSET_1 広告セットID af_adset_id 56789 広告 af_ad creative_name 広告ID af_ad_id 34567 サイトID af_siteid abcdefgh12345678 サブサイトID af_sub_siteid abcdefgh12345678 チャネル af_channel channel_name 広告タイプ 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} -
クリックURLに次の必須パラメータを追加してください*。
注意
クリックURLで必須パラメータを送信しないと、自社が獲得に貢献したインストールの大半が自社にアトリビューションされなくなります。
- IPアドレス
- ユーザーエージェント
* AppsFlyerにリダイレクトする単純なHTTPリファラでクリックを送信する場合、追加の対応は不要です。
次のいずれかの方法を使用する場合は、以下の取得方法に従ってパラメータをクリックURLに追加してください。
- アプリ内からのリダイレクト
- サーバー間クリック(S2S)
APのアトリビューション用パラメータ
パラメータ 必須 取得方法 デバイスの言語とロケール
af_lang
いいえ NSString *language = [[NSLocale preferredLanguages] objectAtIndex:0];
[推奨]言語とロケールを指定してください。例:en-US。
ユーザーエージェント
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
はい 推奨する方法:デバイスのIPアドレスを取得できる場合は、af_ipパラメータで送信してください。
代替の方法:X-Forwarded-ForにIPアドレスが含まれている場合は、AppsFlyerがその値を使用します。
クリック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%20like%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エンコードする必要があります。
HTTPヘッダーでデータを送信する
クリックURLへのリクエストのHTTPヘッダーで各フィールドを送信するには、次の例を参照してください。
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
APのポストバック仕様
APのポストバックを受信するには、通常のポストバック連携に加えて、AP連携を設定する必要があります。 APのポストバックは、AppsFlyer管理画面で設定できます。
通常のテンプレートとAP用テンプレートの違い
- ポストバックの送信時刻は、実際のイベント発生時刻とは一致しません。
- タイムスタンプのマクロ:
- インストールとアプリ内イベントのタイムスタンプは、発生時刻の分・秒を切り捨て、1時間単位で報告されます。たとえば、22:55:30は22:00:00として報告されます。
- タイムスタンプはUTCで報告されます。タイムスタンプの例:(2020-07-20 20:00:00)
- APのポストバックでは、クリックID、顧客ユーザーID、AppsFlyer ID、IDFA、IDFV、デバイスのモデル、OSのバージョン、通信事業者のパラメータは使用できません。
連携のためにアドネットワーク側で必要な対応:
重要
正当なイベントのポストバックと拒否されたイベントのポストバックを区別するには、拒否されたイベント用のポストバックマクロを設定する必要があります。
- 拒否されたインストール/イベントのポストバックを有効にするには、Partner Assistantウィジェットからお問い合わせください。
APのポストバックエンドポイント[必要に応じて入力]
| ポストバックの種類 |
|---|
| インストール |
| アプリ内イベント |
APのアトリビューションで使用できるマクロ
| ポストバックマクロ(名前) | 説明 | すべてのポストバックに使用する基本パラメータ | アプリ内イベントの任意パラメータ | 拒否されたアトリビューションの任意パラメータ |
|---|---|---|---|---|
| af_ad | クリエイティブ名 | はい | ||
| af_ad_id | 34567 | はい | ||
| af_ad_type | 例:banner、footer、video | はい | ||
| af_adset | ADSET_1 | はい | ||
| af_adset_id | 56789 | はい | ||
| app_id | - | はい | ||
| app_name | - | はい | ||
| attributed_touch_hour |
分・秒を切り捨て、1時間単位で表します。 形式は注意事項(1)を参照。 |
はい | ||
| 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 |
分・秒を切り捨て、1時間単位で表します。 形式は注意事項(1)を参照。 |
はい | ||
| event_name | アプリから報告された値。 | はい | ||
| event_revenue | イベントの通貨で表した収益額。 | はい | ||
| event_revenue_ currency |
収益の通貨コード。 | はい | ||
| event_revenue_usd | 米ドルに換算した収益。 | はい | ||
| install_hour |
分・秒を切り捨て、1時間単位で表します。 形式は注意事項(1)を参照。 |
はい | ||
| is_first | 特定のユーザーがこのアプリ内イベントを初めて発生させた場合はtrue。 | はい | ||
| is_primary |
重複排除に使用します。 ブール値:0、1 |
はい | ||
| is_retargeting |
重複排除に使用します。 形式は注意事項(2)を参照。 |
はい | ||
| is_reengagement | 形式は注意事項(2)を参照。 | はい | ||
| is_reattribution |
重複排除に使用します。 形式は注意事項(2)を参照。 |
はい | ||
| 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)使用できるブール値の形式
| ||||
APのポストバックを設定する
AppsFlyer管理画面の[ポストバック管理]から、APのポストバックを設定します。
前提条件:
- APのポストバックを管理するには、AppsFlyerとの連携が有効になっている必要があります。 Partner Assistantウィジェットから、連携の作成を依頼してください。
-
ポストバックを管理できるのはアカウント管理者のみです。チームメンバーはアクセスできません。
ポストバックの設定手順:
- 上部バーのアカウントメニュー(メールアドレスのプルダウン)を開き、ポストバック管理を選択します。
- ポストバックの種類で高プライバシーモード(AP)を選択します。
-
ポストバックの設定ツール(ビルダー)を有効にします。
- エンドポイントのアドレスを入力します。AppsFlyerからのポストバックを受信するエンドポイントのURLです。インストール、アプリ内イベント、またはその両方のURLを入力してください。
-
ポストバックに含めるパラメータを入力します。
- パラメータ名:AppsFlyerの画面上でのパラメータ名。
- 受信側のパラメータ(Your receiving parameter):パートナー側で対応する受信パラメータ。
- パラメータ値(一部のパラメータで設定可能):値の形式を選択します。たとえば、ブール値の場合、true/falseと1/0のどちらで受信するかを選択します。
- インストール:チェックを入れると、インストールポストバックにそのパラメータが含まれます。
- アプリ内イベント:チェックを入れると、アプリ内イベントポストバックにそのパラメータが含まれます。
-
[任意]AppsFlyerが提供していない独自のパラメータを追加します。
-
最後にポストバックテンプレートのプレビューを確認し、設定内容に問題がないことを確かめます。
- 保存をクリックします。ポストバックを保存すると、変更内容はすぐに反映されます。
問題がある場合は、Partner Assistantウィジェットからお問い合わせください。
補足情報
分析パートナー向けのAP
分析パートナーには、以下のようにポストバックが送信されます。
- APが無効な場合:広告主は、ユーザーレベルのポストバックデータを制限なく共有できます。
- APが有効な場合:ユーザーの流入元と広告IDの取得可否に応じて、ポストバックの種類が異なります。詳細は以下の表を参照してください。
ATTステータスとユーザーの流入元に応じた、分析パートナーへのポストバックの種類
| ユーザーの流入元 | 広告IDの取得可否 | 分析パートナーへのポストバックの種類 | |
|---|---|---|---|
| パブリッシャーのアプリ | 広告主のアプリ | ||
|
非オーガニック
|
取得可能 | 取得可能 | 通常のポストバック |
| 取得不可 | 取得可能 | 送信なし | |
| 問わない | 取得不可 | 送信なし | |
| オーガニックまたはWeb | 該当なし | 取得可能 | 通常のポストバック |
| オーガニックまたはWeb | 該当なし | 取得不可 | 送信なし |
APとSKAdNetworkの比較
SKAdNetworkは、Appleが提供するiOSデバイス向けのアトリビューション技術です。高プライバシーモード(AP)は、AppsFlyerの高プライバシー一括設定(AAP)の一部であり、AppsFlyerのアトリビューションに適用されます。 AAPにより、広告主はAppsFlyerプラットフォームを通じて共有するアトリビューションデータを管理できます。アドネットワークは通常、APとSKAdNetworkの両方の連携に対応しています。