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

高プライバシーモード(AP)のガイドとポストバックマクロ | アドネットワーク向け

  • 更新
概要:高プライバシーモード(AP)が有効な場合の、パートナーへのデータ共有について説明します。アドネットワーク向けに、APのポストバックを設定する手順を紹介します。注意:この記事はSKAdNetworkのポストバックを扱うものではありません。また、広告主向けの設定手順でもありません。 

アドネットワーク向けAPの最新情報

この記事で説明するAPのポストバックの仕組みは、以下の条件をすべて満たす場合に適用されます。

  • ユーザーのデバイスがiOS 14.5以降である
  • APが有効になっている

AdvancedPrivacy.png

この記事で説明する内容: 

アドネットワークへのデータ共有に関するAPの基本方針

iOS 14.5以降では、AppsFlyerの高プライバシー一括設定(AAP)により、AppsFlyerプラットフォームを通じて共有するユーザーレベルのアトリビューションデータを広告主が管理できます。 

アドネットワークとのデータ共有では、このAAPの仕組みが高プライバシーモード(AP)として実装されています。この記事では、読みやすさを考慮し、「高プライバシーモード」と「AP」を同じ意味で使用します。 

APを有効にしても、広告主はパートナーやアドネットワークに集計データを共有できます。  

APの影響を受けるデータ

APが有効な場合、広告主がポストバックなどのレポート手段を通じて共有できるのは集計データのみです。 Protect360の不正関連レポートを含め、ユーザーレベルのデータは共有されません。

ポストバックでは、広告IDを取得できるかどうかなどの条件に応じて、異なる種類のポストバックが使用されます。

APの設定はアプリごとに確認できます。AppsFlyerのサイドメニューで[連携(Collaborate)] > [有効な連携(Active Integrations)]を選択し、対象のアドネットワークを開いて連携タブを確認してください。 デフォルトでは有効になっています。 

APforPartners2.png

ポストバックの送信に使用するテンプレートの種類

  • 通常のテンプレート:ユーザー識別子とアトリビューションデータのマクロを含む、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が含まれますが、アトリビューションデータは含まれません。(このオプションに対応していないアドネットワークもあります。)

    InAppEventAll.png

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)の仕組みや、プライバシーを保護するその他のキャンペーン計測手法を使用してアトリビューションを行います。

[推奨]アトリビューションの機会を最大限に確保するため、以下に挙げるパラメータをすべて送信してください。

  1. クリック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}
  2. クリック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%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エンコードする必要があります。

    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/15E148

    X-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のバージョン、通信事業者のパラメータは使用できません。

連携のためにアドネットワーク側で必要な対応:

  1. AppsFlyer管理画面でAPのポストバックを設定します。 
  2. AP連携をテストします。

重要

  • 正当なイベントのポストバックと拒否されたイベントのポストバックを区別するには、拒否されたイベント用のポストバックマクロを設定する必要があります。

  • 拒否されたインストール/イベントのポストバックを有効にするには、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)使用できるタイムスタンプの形式:

  • [デフォルト]文字列:YYYY-MM-DD HH:MM:SS
  • エポック時刻:10桁のUNIXタイムスタンプ 

(2)使用できるブール値の形式

  • [デフォルト]数値:0、1 
  • 文字列:false、true

APのポストバックを設定する

AppsFlyer管理画面の[ポストバック管理]から、APのポストバックを設定します。

前提条件:

  • APのポストバックを管理するには、AppsFlyerとの連携が有効になっている必要があります。 Partner Assistantウィジェットから、連携の作成を依頼してください。
  • AppsFlyerAdmin_us-en.png ポストバックを管理できるのはアカウント管理者のみです。チームメンバーはアクセスできません。

ポストバックの設定手順:

  1. 上部バーのアカウントメニュー(メールアドレスのプルダウン)を開き、ポストバック管理を選択します。
  2. ポストバックの種類で高プライバシーモード(AP)を選択します。 
  3. ポストバックの設定ツール(ビルダー)を有効にします。

    postback-management-enter-endpoint_en-us.png

  4. エンドポイントのアドレスを入力します。AppsFlyerからのポストバックを受信するエンドポイントのURLです。インストール、アプリ内イベント、またはその両方のURLを入力してください。
  5. ポストバックに含めるパラメータを入力します。

    • パラメータ名:AppsFlyerの画面上でのパラメータ名。
    • 受信側のパラメータ(Your receiving parameter):パートナー側で対応する受信パラメータ。
    • パラメータ値(一部のパラメータで設定可能):値の形式を選択します。たとえば、ブール値の場合、true/falseと1/0のどちらで受信するかを選択します。
    • インストール:チェックを入れると、インストールポストバックにそのパラメータが含まれます。
    • アプリ内イベント:チェックを入れると、アプリ内イベントポストバックにそのパラメータが含まれます。

    postback-management-parameters_en-us.png

    APのポストバックマクロの一覧。

  6. [任意]AppsFlyerが提供していない独自のパラメータを追加します。

    postback-management-custom-parameters_en-us.png

  7. 最後にポストバックテンプレートのプレビューを確認し、設定内容に問題がないことを確かめます。

    postback-management-template_en-us.png

  8. 保存をクリックします。ポストバックを保存すると、変更内容はすぐに反映されます。

問題がある場合は、Partner Assistantウィジェットからお問い合わせください。

補足情報

分析パートナー向けのAP

分析パートナーには、以下のようにポストバックが送信されます。

  • APが無効な場合:広告主は、ユーザーレベルのポストバックデータを制限なく共有できます。
  • APが有効な場合:ユーザーの流入元と広告IDの取得可否に応じて、ポストバックの種類が異なります。詳細は以下の表を参照してください。

ATTステータスとユーザーの流入元に応じた、分析パートナーへのポストバックの種類

ユーザーの流入元 広告IDの取得可否 分析パートナーへのポストバックの種類
パブリッシャーのアプリ  広告主のアプリ

非オーガニック 


 

 


 

 

取得可能 取得可能 通常のポストバック
取得不可 取得可能 送信なし
問わない 取得不可 送信なし
オーガニックまたはWeb 該当なし 取得可能 通常のポストバック
オーガニックまたはWeb 該当なし 取得不可 送信なし

APとSKAdNetworkの比較

SKAdNetworkは、Appleが提供するiOSデバイス向けのアトリビューション技術です。高プライバシーモード(AP)は、AppsFlyerの高プライバシー一括設定(AAP)の一部であり、AppsFlyerのアトリビューションに適用されます。 AAPにより、広告主はAppsFlyerプラットフォームを通じて共有するアトリビューションデータを管理できます。アドネットワークは通常、APとSKAdNetworkの両方の連携に対応しています。