Protect360：連携済みパートナー向け

概要

AppsFlyerでは以下の機能で不正を検知・ブロックします。

• ProtectLITE：全ての広告主に提供している基本的な不正対策機能 
• Protect360：追加の有償契約をした広告主向けのより高度な不正対策機能 

パートナーが不正検知機能を利用するには、広告主側で以下作業が必要です：

• アドネットワーク｜Protect360の管理画面とローデータへのアクセス（ProtectLITEを含む）と、集計されたアプリ内イベントデータへのアクセス（アプリ内イベント不正向け）の権限付与
• 代理店｜Protect360の管理画面とローデータへのアクセスの権限付与

また適宜権限を付与してもらうことで、連携済みパートナーは以下が可能になります：

• 関係するアドネットワークが生み出したトラフィックに関するデータの閲覧
• 関連するローデータレポートのダウンロード

また、クリックとインプレッションの上限設定、失敗したクリック署名については、アドネットワークが利用できるローデータレポートがあり、これについては広告主の許可は必要ありません。

管理画面表示

前提条件：ProtectLite / Protect360へのアクセスに関する、広告主からの権限付与が必要です。

連携済みパートナーは、管理画面とグラフを確認できるようになります。
(詳細は以下のスクリーンショットを確認してください。)

ProtectLITEとProtect360の画面で利用可能なデータの詳細についてはこちらを参照してください。   

制限：

• アドネットワークアカウントは［異常値］の画面にはアクセスできません。 一方代理店アカウントはアクセス権を持っていますが、他のメディアソースと比較するための基準値を作成できるように、AppsFlyerによって保証されているメディアソースからのトラフィックにおいて不正率が低い場合にのみ、データが表示されます。

ローデータレポート

前提条件：ProtectLite / Protect360へのアクセスに関する、広告主からの権限付与が必要です。

Protect360のローデータレポートでは、ProtectLITE / Protect360 / 検証ルールによって検知・ブロックされた不正データを提供しています。

利用可能なレポート：

• データ出力：AppsFlyer管理画面 左メニューのレポート > ローデータ出力へ移動します。
• API：アドネットワーク向けのレポートAPIのセクションを確認してください。 

Protect360のローデータレポートの詳細についてはこちらを参照してください。

Protect360のアドネットワーク向けレポートAPI

• アドネットワークは、このセクションに記載されているローデータレポートをAPI経由で利用可能です。
• 同様のレポートは、管理画面内のデータエクスポートのページからも取得可能です。
• 広告主が Protect360を契約していない場合には、インストールのレポートのみが閲覧可能です。

前提条件

• 広告主のデータにAPIでアクセスするには、予め広告主がアドネットワークに対して、"Protect360管理画面とAPIでのローデータへのアクセスを許可する"という権限を付与している必要があります。ダッシュボードにアクセスできる広告ネットワークは、APIの使用が許可されています。 広告主様によるご対応は必要ありません。
• Protect360へのアクセス権限を持っているアプリの一覧については、アプリリストの取得APIを使用してください。 
• パートナーアカウントのAdminアカウントは、AppsFlyerの管理画面からAppsFlyerのV2.0 認証トークンを取得する必要があります。

Protect360 APIレポート

Protect360のローデータレポートをダウンロードして取得する手順

APIを使用する場合：

1. 前述の表から、取得したいレポートを決めてください。
2. 関連するCurlサンプル (以下参照) を使用して、スクリプトを準備してください。
3. 以下のプレースホルダをそれぞれ置き換えてください：
   1. App ID
   2. From date (開始日)
   3. To date (終了日)
   4. Bearer token  (AppsFlyer V2.0 認証トークン)
4. 記事内に記載のあるように、一部のコールにはオプションのパラメータもあります。

Curl サンプル

curl --location --request GET 'https://hq1.appsflyer.com/api/adnets-data/v1/export/blocked_installs_report/app/{app_id}?from={2020-07-10}&to={2020-07-20}&additional_fields=keyword_id,store_reinstall,deeplink_url,oaid,blocked_reason,blocked_reason_value,blocked_reason_rule,blocked_sub_reason,match_type,device_category,gp_referrer,gp_click_time,gp_install_begin,amazon_aid,keyword_match_type' \
-H 'Authorization: Bearer {V2.0 api token placeholder. Note: The token has more than 700 characters.}' \

curl --location --request GET 'https://hq1.appsflyer.com/api/adnets-data/v1/export/detection/app/{app-id}?from={2020-06-10}&to={2020-07-20}&additonal-fields=fraud_reason,fraud_sub_reason,match_type,device_category,gp_referrer,gp_click_time,gp_install_begin,detection_date' \
-H 'Authorization: Bearer {V2.0 api token placeholder. Note: The token has more than 700 characters.}' \

curl --location --request GET 'https://hq1.appsflyer.com/api/adnets-data/v1/export/blocked_in_app_events_report/app/?from=YYYY-MM-DD&to=YYYY-MM-DD&additional_fields=keyword_id,store_reinstall,deeplink_url,oaid,blocked_reason,blocked_reason_value,blocked_reason_rule,blocked_sub_reason,match_type,device_category,gp_referrer,gp_click_time,gp_install_begin,amazon_aid,keyword_match_type' \
-H 'Authorization: Bearer {V2.0 api token placeholder. Note: The token has more than 700 characters.}' \

curl --location --request GET 'https://hq1.appsflyer.com/api/adnets-data/v1/export/fraud-post-inapps/app/{app-id}?from={2020-06-10}&to={2020-07-20}&additional_fields=match_type,device_category,gp_referrer,gp_click_time,gp_install_begin,fraud_reason,fraud_sub_reason,detection_date' \
-H 'Authorization: Bearer {V2.0 api token placeholder. Note: The token has more than 700 characters.}' \

curl --location --request GET 'https://hq1.appsflyer.com/api/adnets-data/v1/export/blocked_clicks_report/app/{app-id}?from={2020-06-10}&to={2020-07-20}&additional_fields=keyword_id,store_reinstall,deeplink_url,oaid,blocked_reason,blocked_reason_value,blocked_reason_rule,blocked_sub_reason,gp_referrer,gp_click_time,gp_install_begin,amazon_aid,keyword_match_type' \
-H 'Authorization: Bearer {V2.0 api token placeholder. Note: The token has more than 700 characters.}' \

Protect360 アドネットワーク API 仕様ガイド

インプレッションとクリックの上限ブロック(capping)

アドネットワークが非常に高いインプレッションとクリックの不正率を示す場合、Protect360はアドネットワークのインプレッションとクリックを24時間のサイクルでブロックします。つまり、閾値に達したあとに発生したインプレッションとクリックはAppsFlyerで記録されず、アトリビューションの対象にもなりません。これらのブロックされたインプレッションとクリックの情報は、Protect360の管理画面とレポートにのみ表示されます。

AppsFlyer不正防止アルゴリズムは、インプレッションとクリックの量、コンバージョン率、検出された不正率、アクティビティの変動、業界および地理的ベンチマーク、独自のパラメーターなど、不正を検出する際にさまざまなパラメーターを考慮します。このアルゴリズムは、変化傾向を考慮して、時間単位で動的に更新されます。

インプレッションやクリックの増大により閾値に達することが繰り返し発生した場合、AppsFlyerのプラットフォームとの連携を永久的に削除する可能性もあります。

インプレッションとクリックの上限ブロックの閾値について： 

• すべてのアドネットワークに対して、平等に適用されます。つまり、インプレッション不正やクリック不正の割合が極端に高くても上限ブロックされないアドネットワークは存在しません。
• アプリ/アドネットワークレベルである。つまり、不正分析では、アプリ上のすべてのアドネットワークのキャンペーンが考慮され、ブロックは、アプリ上のすべてのアドネットワークのキャンペーンのレポートとアトリビューションに影響します（アカウントにProtect360があるかどうかに関係なく）。
• 24時間サイクルでブロックはリセットされ、サイクルが終了するまではブロックが適用されます。サイクルの開始と終了の詳細については、非公開です。
• 変更または停止できません。Protect360は、不正検出において細かい調節がなされており、そのアルゴリズムは手動で調整または無効にすることはできません。
• 異常なアクティビティを持つキャンペーンとパブリッシャー(配信面)を停止することで、回避できる可能性があります。

クリック署名

アドネットワークは、 クリックに HMAC-SHA256 署名を追加できます。

この署名によりAppsFlyerはクリックを検証でき、 クリック情報が不正業者によって操作されていないことを確認します。

• 検証されたクリックは記録され、アドネットワークへ紐付けられます。
• 無効になったクリックは除外され、以下のように処理されます：
  • アドネットワーク向け(広告主向けではなく)に提供されるProtect360のレポート画面に集計されます。
  • アドネットワークのコンバージョン率やクリックの上限ブロックの閾値には影響を与えません。