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

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

  • 更新
概要:概要:高プライバシーポストバックが有効になっている場合の、パートナーへのデータ共有について記載しています。ご注意くださいこの記事はSKAdNetworkのポストバックには一切関係なく、広告主向けのものでもありません。 

高プライバシーポストの更新情報

本ページ内に記載されている高プライバシーポストバックの機能は、以下条件に全て当てはまった場合に有効になります:

  • ユーザーの端末がiOS 14.5以上を搭載していること
  • 高プライバシーポストバックがONになっていること

AdvancedPrivacy.png

この記事では以下の内容について記載しています:

高プライバシーポストバックでのデータ共有の原則

iOS14.5以降、AppsFlyerの高プライバシー一括設定(AAP)のフレームワークはユーザーレベルのアトリビューションデータの可用性を管理する機能を広告主へ提供します。  

アドネットワークにとっては、このAAPのフレームワークは高プライバシーポストバック(AP)の使用をもって適用されます。わかりやすく、このページでは高プライバシーポストバックをAPと略して記載してきます。  

また、APはアドネットワークや代理店も利用可能である集計データの可用性には何も影響しませんのでご安心ください。  

APの設定によって影響を受けるデータについて

APがONになっている場合、iOS14.5以上のOSでATTに同意しなかった端末のユーザーレベルのデータは、ポストバックやProtect360の不正関連のレポートを含む各種レポート機能において利用できなくなります。

つまりポストバックにおいて、ユーザーのATT同意状況とその他の要因によって、異なるタイプのポストバックが都度使用されることになります。  

 デフォルト設定はAPがONになっています。  

APforPartners2.png

  • レギュラーテンプレートレギュラーポストバック:AppsFlyerとの既存のポストバック連携のテンプレートで、ユーザー識別子やclickID、アトリビューションデータに関するマクロが含まれています。
  •  
    注記:AP連携の作業はパートナーアカウント上のポストバック管理の画面を使って、ご自身で設定が可能です。

 注意

  • エンドユーザーが広告主アプリと広告配信アプリの両方でATTに同意した場合、レギュラーポストバックのテンプレートを使って成果の紐付いた媒体と成果の紐付いていない媒体へもポストバックが送信されます。  
    •  

使用されるポストバックの種類について

以下の表は、iOS14.5以降のユーザーデータに適用されるものです。

ご注意ください  

iOS14.5以降使用されるポストバックの種類

AP設定

ATTのステータス APをサポートしている媒体への紐付いた成果*のポストバック   APをサポートしていない媒体への紐付いた成果*のポストバック   紐付いていない成果のポストバック*

広告掲載アプリ

広告主アプリ

オン

承認

許可されていません

ポストバックなし

なし

オン

許可されていません

承認

ポストバックなし

レギュラーテンプレート

(媒体関連の情報は利用不可)*

オン

承認

承認

レギュラーテンプレート

レギュラーテンプレート (媒体関連の情報は利用不可)*

オン

許可されていません

許可されていません

ポストバックなし

なし

オフ

考慮外

考慮外

レギュラーテンプレート

レギュラーテンプレート

レギュラーテンプレート

(媒体関連の情報は利用不可)*

(*)パートナーとのデータ共有の原則

特定のイベントについて、AppsFlyerでは複数のアドネットワークがポストバックを受け取ることが可能です。送信されるポストバックは以下の通りです:

  • 成果の紐付け先ではないパートナー:成果やイベントが紐付いていない連携済みパートナーも、アプリ内イベントのポストバック設定において、送信オプションの設定を、オーガニックを含むすべてのメディアソースにした場合に、ポストバックを受け取ります。広告主アプリにおいてATTダイアログにユーザーが同意した場合、ポストバックに他社媒体情報は含まれませんが、各種ユーザーIDは含まれます。(この送信オプションの機能は全てのアドネットワークでサポートしているわけではありません。)

    InAppEventAll.png

Web面での広告配信

アドネットワークがWeb面上で広告を表示している場合、APの挙動が異なります。

APがON かつ iOS14.5以降において使用されるポストバックタイプ

ATTのステータス 紐付いた成果のポストバックタイプ* 紐付いていない成果のポストバックタイプ*

広告掲載アプリ

広告主アプリ

N/A

許可されていません

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

なし

N/A

承認

レギュラーポストバックIDFA, IDFV, CUID, Click ID

レギュラーポストバック(媒体情報は含まれず、IDFAなどのユーザー情報のみ)

統合

クリックURLをアップデートして、高プライバシーポストバックの連携を完了してください。

クリックURLのパラメータについて

多くのケースにおいて、ユーザーの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

    広告

    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

    広告タイプ

    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

    ユーザーエージェント

    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}

    サンプル

    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

    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

    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

高プライバシーポストバックの仕様について

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

  • ポストバックは1時間毎にまとめて送信されます。
    • このバッチにはインストール、アプリ内イベントなどすべてのイベントタイプが含まれます。
    • このバッチには、成果の紐付いたアトリビューションデータと、ブロックされたリジェクトポストバックの両方が含まれます。
    • なお、0.001%のポストバックデータが後から別のバッチで送信される可能性があり、最大で24時間の遅延が発生する可能性があります。
  • ポストバックの送信時間は実際のイベント発生時間とは異なります。
  • タイムスタンプのマクロについて:
    • インストールとアプリ内イベントのデータの場合、タイムスタンプは発生した時間単位での情報に丸められます。例:"22:55:30"というデータは"22:00:00"としてレポートされます。
    • UTCのタイムゾーンが適用されます。例: "timestamp" : 15848352001232024-02-26

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

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

 重要!

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

ポストバックの種類
インストール
アプリ内

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

ポストバックマクロ名

備考 全ポストバック向けの基本パラメータ アプリ内イベント専用のパラメータ  リジェクトされた計測データ専用のパラメータ
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

時間(Hour)単位に切り捨て 

Format:注(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

時間(Hour)単位に切り捨て 

Format:注(1)を参照してください

はい    
event_name アプリによって異なるイベント名が入ります   はい  
event_revenue event_currencyに基づく収益金額   はい  
event_revenue_
currency
収益の通貨単位   はい  
event_revenue_usd USDに換算された収益金額   はい  
install_hour

時間(Hour)単位に切り捨て 

Format:注(1)を参照してください

はい    
is_first そのアプリ内イベントが、そのユーザーにとって初めて発火されたイベントだった場合にはTrueが入ります   はい  
is_primary

重複除外に利用可能

ブール値2024-02-26

  はい  
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) Booleanの形式が利用可能

  • [デフォルト] 数値:0, 1 2024-02-26 
  • String: false, true

高プライバシーポストバックの設定方法について

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

前提条件:

  • 高プライバシーポストバックの設定を管理するには、AppsFlyerと有効な連携設定 / パートナーアカウントが必要です。

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

  1. 管理画面右上のアカウントメニュー(メールアドレスのドロップダウン)> ユーザー管理を開きます。
  2. 高度なプライバシー:: 
  3. トグルをONにして、設定画面をアクティブにしてください。

    postback-management-enter-endpoint_en-us.png

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

    postback-management-parameters_en-us.png

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

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

    postback-management-custom-parameters_en-us.png

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

    postback-management-template_en-us.png

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

追加情報

アナリティクスパートナー向けのAP

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

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

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

流入元

ATTのステータス アナリティクスパートナー向けのポストバックタイプ

広告掲載アプリ

 広告主アプリ

非オーガニック



承認

承認

レギュラーポストバック

許可されていません

承認

なし

上記以外

許可されていません

なし

オーガニック / Web

N/A

承認

レギュラーポストバック

オーガニック / Web

N/A

許可されていません

なし

SKAdNetwork

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