Protect360 для интегрированных партнеров.

Краткий обзор. Интегрированные партнеры (рекламные сети и агентства) могут отслеживать мошенничество, связанное с выявлением и блокировкой трафика механизмами ProtectLite и Protect360, а также правилами валидации клиентов, определенными вручную.

Обзор

AppsFlyer выявляет и блокирует мошенничество следующим образом: 

  • ProtectLITE: Базовая защита от мошенничества для всех клиентов. 
  • Protect360: Расширенная защита от мошенничества для рекламодателей с премиум-планом подписки. 

Рекламодатели должны предоставить:

  • Разрешения рекламным сетям на доступ к дэшборду Protect360 и отчетам по сырым данным (включая ProtectLite), а также доступ к агрегированным данным о внутренних событиях приложения (для выявления мошенничества в приложениях).
  • Разрешения агентствам на доступ к дэшборду Protect360 и сырым данным.

При наличии нужных разрешений интегрированные партнеры могут:

  • Просматривать данные, связанные с трафиком, сгенерированным этим партнером.
  • Скачать соответствующие отчеты по сырым данным.

Рекламным сетям также доступны отчеты по сырым данным об ограничении кликов и показов, а также о кликах с неудачными подписями, для которых разрешение рекламодателя не требуется.

 Примечание

Для рекламодателей, которые работают с рекламными сетями через агентство: чтобы доступ к данным имели и рекламная сеть, и агентство, рекламодатель должен настроить в AppsFlyer интеграцию с ними обоими и разрешить им обоим доступ к данным.

Если интегрировано и имеет доступ только агентство, у рекламной сети не будет доступа к данным.

Представление дэшборда

Необходимые условия: Разрешение рекламодателя на доступ к ProtectLite и Protect360. 

Интегрированные партнеры могут просматривать дэшборд и диаграммы; см. следующий скриншот.

Узнайте больше о том, какие данные доступны на дэшбордах ProtectLite и Protect360.

Ограничения:

  • Рекламные сети не могут получить доступ к дэшборду аномалий. У агентств есть доступ к данным, но они будут видеть данные только при поступлении трафика из источников, которым AppsFlyer доверяет и которые характеризуются низким уровнем мошенничества, что позволяет составить основу для сравнения других медиа-источников.

p360_dashboard_1.jpg

Отчеты по сырым данным

Необходимые условия: Разрешение рекламодателя на доступ к ProtectLite и Protect360. 

Отчеты Protect360 по сырым данным показывают выявленное и заблокированное мошенничество с помощью ProtectLite, Protect360 и правил валидации.

Отчеты доступны через:

Узнайте больше об отчетах Protect360 по сырым данным.

API отчетности по Protect360 для рекламных сетей

  • Отчеты по сырым данным, перечисленные в этом разделе, доступны рекламным сетям через API.
  • Эквивалентные отчеты доступны на дэшборде на странице Экспорт данных.
  • Если у рекламодателя нет подписки Protect360, доступен только отчет об установках.

Необходимые условия

  • Чтобы получить доступ к данным рекламодателя с помощью API, рекламодатель предоставляет рекламной сети разрешение на доступ к дэшборду Protect360 и к данным по API. Рекламным сетям, имеющим доступ к дэшборду, разрешено использовать API. От рекламодателя не требуется никаких действий. 
  • Чтобы получить список приложений, для которых у вас есть разрешения Protect360, используйте API для получения списка приложений
  • Администратору необходимо получить токен аутентификации AppsFlyer V2.0, доступный на дэшборде.

Отчеты Protect360 по API

Отчет Актуальность данных Описание
Пост-атрибуционное мошенничество с событиями внутри приложения

Ежедневно 10:00 UTC

  • События в приложении, выполненные в результате установок, идентифицированных как мошеннические.
  • Любое другое событие в приложении, которое оценивается как мошенническое независимо от установки.

Отчет можно дополнительно отфильтровать по типу внутреннего события, как описано в таблице параметров ниже. 

Тема отчета: fraud-post-inapps

Установки после атрибуции

Ежедневно 10:00 UTC

  • Установки, идентифицированные как мошеннические после атрибуции. 
  • Отчет можно дополнительно отфильтровать по дате обнаружения, как описано в следующем разделе. 

Тема отчета: обнаружение

Установки

В реальном времени

Блокированные установки с причиной блокировки

Тема отчета: отчет о заблокированных установках

Внутреннее событие приложения В реальном времени

События в приложении, выполняемые заблокированными пользователями

Тема отчета: blocked_in-app_events_report

Клики В реальном времени

 Клики, выполненные заблокированными пользователями

Тема отчета: blocked_clicks_report

Процедура получения отчетов Protect360 рекламными сетями путем загрузки

Чтобы получить отчет по API:

  1. Определите необходимый отчет из предыдущего списка.
  2. Используйте соответствующий пример curl (в следующем разделе) для подготовки скрипта.
  3. Обязательно замените следующие заполнители своими данными:
    1. Идентификатор приложения
    2. С даты
    3. До даты
    4. Токен предъявителя (токен аутентификации AppsFlyer V2.0)
  4. Некоторые вызовы имеют дополнительные параметры, как описано в этой статье. 

Пример curl

Установки (blocked_installs_report)

Замените заполнители app_id, from, to и token.


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.}' \

Установки после атрибуции (обнаружение)

Замените заполнители app_id, from, to и token. 


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.}' \

Внутренние события (blocked_in_app_events_report)

Замените заполнители app_id, from, to и token.


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.}' \

Мошенничество с событиями в приложении после атрибуции (fraud_post_inapps)

Замените заполнители app_id, from, to и token.


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.}' \

Клики (blocked-clicks_report)

Замените заполнители app_id, from, to и token.


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.}' \

Справочное руководство по API Protect360 для рекламных сетей

Основы API

Основы API Protect360 для рекламных сетей:

Путь

https://hq1.appsflyer.com/api/adnets-data/v1/export/report_topic/app/app_id

Метод GET
Параметры пути (обязательные)
  • app_id:
    • Идентификатор приложения, указан на дэшборде AppsFlyer. Вставьте его точно так, как он показан на дэшборде.
    • Обязательно добавьте к приложениям iOS префикс id.
  • report_topic
Принятые типы контента application/json 
Авторизация
  • Токен предъявителя в заголовке запроса.
  • AppsFlyerAdmin_us-en.png Попросите администратора получить токен V2.0 со страницы токенов. Длина токена составляет около 700 символов. 
Ограничение предоставления данных Ограничение предоставления данных
Ограничение диапазона дат
  • Самая ранняя дата: 90 дней до текущих данных
  • 31 день из предыдущих 90 дней
Ограничения строк 200 тыс. строк
Характеристики отчета
  • Часовой пояс: UTC
  • Валюта: USD

Параметры API

Параметры API Protect360:

Параметр Описание Формат Обязательно/Не обязательно
app_id (идентификатор приложения)  Идентификатор приложения в том виде, в каком он отображается в AppsFlyer Строка Да
from (от)

Начало диапазона дат:

  • Для установок это дата установки.
  • Для внутренних событий приложения это дата события.
YYYY-MM-DD Да
to (по)

Конец диапазона дат:

  • Для установок это дата установки.
  • Для внутренних событий приложения это дата события.
YYYY-MM-DD Да
event_name (название события)

[Опционально для пост-атрибуционного мошенничества с событиями внутри приложения]

Отфильтруйте события по типу внутренних событий. Добавьте в отчет только конкретные события. Можно включить одно или несколько событий.

Пример использования: &event_name=af_purchase,af_login

Строка

Нет

 

detect-from

[Опционально для пост-атрибуционных установок]

Начало диапазона дат обнаружения мошенничества. (По умолчанию from.) 

YYYY-MM-DD Нет
detect-to

[Опционально для пост-атрибуционных установок]

Конец диапазона дат обнаружения мошенничества. (По умолчанию to.)

YYYY-MM-DD Нет

Коды возврата HTTP для API Protect360

Коды ошибок и решения:

Статус Код Симптом/сообщение Решение
OK 200 Пустой файл CSV

addtional_fields используется в URI более одного раза

OK

200

Пустой файл CSV

Убедитесь, что даты начала и окончания имеют формат гггг-мм-дд

OK 

200

Возвращается страница входа в AppsFlyer в формате HTML

В заголовке токена предъявителя нет токена

Bad request

400

Bad request

  • Ограничение диапазона дат.
    • Самая ранняя допустимая дата — за 90 дней до текущего дня
    • Период не может превышать 60 дней для установок и 90 дней для отчетов по внутренним событиям.
Не авторизовано

401

Не авторизовано

Токен найден, но он недействителен. Убедитесь, что для вашего аккаунта установлен токен версии 2.0. Попросите администратора получить текущий токен с дэшборда.

Not found

404

 

  • Указана неверная конечная точка
  • Убедитесь, что идентификатор приложения правильный.
  • Вы не авторизованы для доступа к приложению

Ограничение показов и кликов

Если в рекламной сети чрезвычайно высок процент мошеннических показов или кликов, Protect360 блокирует показы или клики рекламной сети в течение 24 часов. Это означает, что любые показы/клики, произошедшие после достижения порогового значения, не регистрируются AppsFlyer и не подлежат атрибуции. Заблокированные показы/клики отображаются на дэшборде Protect360 и в отчетах.

Алгоритм защиты от мошенничества AppsFlyer учитывает различные параметры при обнаружении мошенничества, включая количество показов/кликов, CVR, уровень обнаруженного мошенничества, нормальные колебания активности, отраслевые и географические показатели, а также собственные параметры. Алгоритм динамичен и обновляется ежечасно с учетом меняющихся тенденций.

Неоднократное срабатывание пороговых значений количества показов или кликов может привести к окончательному удалению партнерской интеграции с платформы AppsFlyer.

Пороговые значения для ограничения показов и кликов: 

  • Применяются ко всем рекламным сетям одинаково. Это означает, что нет рекламной сети, в которой чрезвычайно высокий уровень мошенничества с показами или кликами не приводил бы к ограничению количества кликов или показов.
  • Находятся на уровне приложений/рекламной сети. То есть при анализе мошенничества учитываются все кампании рекламной сети в приложении, а блокировка влияет на отчетность и атрибуцию всех кампаний рекламной сети в приложении (независимо от того, есть ли в аккаунте Protect360).
  • Обнуляются после 24-часового цикла, а блокировка действует до конца цикла. Сведения о том, когда начинается и заканчивается цикл, AppsFlyer сохраняет в тайне.
  • Невозможно изменить или остановить. Protect360 тщательно настроен и точен в обнаружении мошенничества, и алгоритм нельзя настроить или выключить вручную. 
  • Этого можно избежать, остановив кампании и издателей с аномальной активностью.

Вопросы и ответы

Часто задаваемые вопросы об ограничении показов и кликов:

В: Каков порог для сети?

О: Детали механизма блокировки кликов защищены, чтобы предотвратить попытки обойти ограничения. Тем не менее, пороговое значение достигается только в том случае, если количество показов/кликов превышает возможное поведение человека. Количество показов, кликов и установок за день даст вам четкое представление о том, есть ли проблема с флудингом из-за одного или нескольких издателей.

В: Как разблокировать сеть?

О: Сеть может обойти пороговое значение, остановив кампании и издателей с аномальной активностью. После блокировки сети необходимо дождаться окончания 24-часового цикла, чтобы возобновилась запись кликов.

В: Повлияет ли блокировка на клиентов AppsFlyer без Protect360?

О: Да, ограничение будет действовать независимо от того, есть ли у клиента Protect360 или нет. Механизм ограничения защищает всех клиентов от злоупотреблений кликами и показами.

В: Это не мошенничество. Сеть работает с дешевыми источниками, и иногда их качество низкое.

О: Низкая эффективность в обычном масштабе, исходящая от неподозрительных источников, не приводит к ограничению количества кликов. Алгоритм определяет эффективность, которая не может быть достигнута человеком.

В: Это мешает нам масштабировать кампании, и мы не хотим, чтобы эти показы/клики блокировались.

О: Алгоритм AppsFlyer lky защиты от мошенничества защищает клиентов от экстремальных и явных случаев флудинга. Это не влияет на масштабируемость, так как учитываются показы и клики, не вызванные человеком, где подавляющее большинство блокировок влекут за собой только обязательства. Если у вас есть проблемы, свяжитесь с AppsFlyer для их решения.

В: Это не мошенничество. Возможно, у AppsFlyer есть проблемы с обработкой количества показов/кликов?

О: У нас нет проблем с обработкой количества. Мы оказываем поддержку крупнейшим рекламодателям в мире и ежедневно обрабатываем миллиарды данных в реальном времени, включая огромное количество легитимных кликов. В рамках нашего стремления поддерживать масштабный рост с помощью обширных и точных данных мы действуем в интересах наших клиентов и предотвращаем явные случаи клик-флудинга. 

 

В: В чем причина изменения подхода, ограничивающего количество кликов в дополнение к установкам?

О: Мы постоянно совершенствуем механизмы предотвращения мошенничества в рамках нашего стремления защитить клиентов. До сих пор мы принимали показы/клики и просто блокировали установки. Однако в крайних случаях частота кликов невероятно высока, и в таких случаях нет смысла принимать их в наши системы.

В: Что делать, если мы ожидаем значительного увеличения трафика и количества показов/кликов (например, за счет новых кампаний)? Что можно сделать, чтобы избежать блокировки?

О: Алгоритм динамичен и обновляется ежечасно с учетом различных тенденций. Он достаточно сложен, чтобы выдерживать резкие скачки и не срабатывает из-за нормальных колебаний активности, включая внезапное и значительное увеличение объема. Тем не менее, партнеры могут использовать свои данные о показах и кликах и отчеты для выявления подозрительных источников и остановки этих кампаний.

В: Как проверить проблемный трафик и повысить эффективность кампании?

О: Партнеры могут использовать свои данные о показах и кликах и отчеты для выявления подозрительных источников и остановки этих кампаний. Партнеры также могут видеть заблокированные показы и клики на дэшбордах Protect360/ProtectLite в специальных столбцах, если они получили от рекламодателя необходимое разрешение на просмотр данных о мошенничестве на дэшборде.

 

В: Отправляются ли в сети электронные письма с уведомлениями об ограничении?

О: Что касается ограничения количества кликов, AppsFlyer отправляет рекламной сети уведомление по электронной почте при каждом достижении порога ограничения.

Подпись кликов

Рекламные сети могут добавлять подписи HMAC-SHA256 к своим кликам. 

Подписи позволяют AppsFlyer проверять клики и следить за тем, чтобы информация о кликах не была изменена мошенниками.

  • Подтвержденные клики регистрируются и атрибутируются к рекламной сети 
  • Недействительные клики отклоняются и: 
    • Обобщаются в отчетах Protect360, доступных рекламной сети (не рекламодателям).
    • Не влияют на коэффициент конверсии или пороговое значение количества кликов в рекламной сети.