Краткий обзор. Отправляйте сырые данные о событиях атрибуции на серверные конечные точки.
Материал по теме: Сравнение инструментов доставки сырых данных
Push API V2.0
Push API передает события с сырыми данными, создаваемые средствами атрибуции AppsFlyer и SKAN, в виде сообщений на ваши серверы. Вы можете выбрать типы и контент сообщений и задать конечные точки.
Доступные типы сообщений, частота обновления данных и поля зависят от выполняющей атрибуцию инфраструктуры (AppsFlyer или SKAN), как описано в следующих разделах.
Сообщения атрибуции AppsFlyer
| Характеристика | Детали |
|---|---|
| Разделение сообщений на типы |
Пример: Сообщение содержит следующие данные:
Используя таблицу, определяем, что оно является событием установки, выполненной органическим пользователем. |
| Актуальность данных |
Сообщения отправляются вскоре после регистрации события на платформе AppsFlyer. Обычно в течение нескольких минут. |
| Содержание сообщения (поля) |
|
| Формат полей меток времени |
|
|
Атрибуция контекст |
Тип сообщения |
Поле conversion_type |
Поле campaign_type |
Поле event_name |
|---|---|---|---|---|
| Привлечение пользователей | Установка* | установка |
Неорганический: UA Органические: organic |
установка |
| Привлечение пользователей | События внутри приложения при установке | установка |
Неорганический: UA Органические: organic |
Имена событий, определяемые рекламодателем |
|
Ретаргетинг |
повторное вовлечение | повторное вовлечение | retargeting | повторное вовлечение |
| Ретаргетинг | События повторного вовлечения внутри приложения | повторное вовлечение | retargeting | Имена событий, определяемые рекламодателем |
| Ретаргетинг | Реатрибуция | Повторные установки | retargeting | Реатрибуция |
| Привлечение пользователей | Повторные установки | Повторные установки |
Неорганический: UA Органические: organic |
Повторные установки |
| Ретаргетинг | События реатрибуции внутри приложения | Повторные установки | retargeting | Имена событий, определяемые рекламодателем |
| * Некоторые установки, связанные с атрибуцией по просмотрам, атрибутируются ограниченному медиа-источнику. | ||||
| Отображаемое имя | Поле Push API V2.0 |
|---|---|
| Выбранная валюта* | selected_currency |
| Выручка в выбранной валюте | revenue_in_selected_ валюта |
| Затраты в выбранной валюте | cost_in_selected_ валюта |
| Время загрузки на устройство согласно выбранному часовому поясу | device_download_time_selected_timezone |
| Время атрибутированного взаимодействия согласно выбранному часовому поясу | attributed_touch_time_selected_timezone |
| Время установки согласно выбранному часовому поясу | install_time_selected_ часовой пояс |
| Время события согласно выбранному часовому поясу | event_time_selected_ часовой_пояс |
|
Выбранный часовой пояс(*) |
selected_timezone |
| *Это настройка уровня приложения, действующая на момент отправки сообщения API. | |
Сообщения атрибуции SKAN
В этом разделе описаны сообщения (типы отчетов), доступные для SKAN, и способы их идентификации. Ознакомившись с содержимым этого раздела, переходите к теме Настройка конечной точки для атрибуции SKAN.
Материал по теме: Поля сырых данных SKAN. Сообщения Push API имеют аналогичную структуру и поля.
| Характеристика | Детали |
|---|---|
| Разделение сообщений на типы |
Пример: Сообщение содержит следующие данные:
По skad_redownload: true можно определить, что это событие повторной загрузки. |
| Актуальность данных |
|
| Примеры сообщений | Файл содержит примеры сообщений. В примерах используется формат JSON. Примеры сообщений SKAN. |
| Тип сообщения |
Поле event_name |
Поле skad_redownload |
|---|---|---|
| Установки | af_skad_install |
|
| Повторные загрузки | af_skad_install | true |
| In-App Events (Внутренние события приложения) |
Имя события, заданное рекламодателем |
Имя события, заданное рекламодателем |
| Постбэки от iOS |
Недоступно в этом сообщении |
Иногда доступно |
Определение типа сообщения атрибуции SKAN
Настройка конечных точек Push API
Внимание
Не используйте Push API для отправки данных третьим сторонам, поскольку:
- Вы можете нарушить законы о конфиденциальности, такие как GDPR, если пользователь сообщил о своем нежелании передавать данные третьим сторонам.
- Некоторые медиа-источники ограничивают использование предоставляемых ими данных уровня пользователя, передачу таких данных третьим сторонам, или и то, и другое. Убедитесь, что вы соблюдаете условия использования медиа-источников,
например, Facebook, Twitter, Snapchat, Pinterest.
Чтобы настроить Push API, выполните следующий список действий.
| Шаг | Атрибуция Appsflyer | Атрибуция SKAdNetwork |
|---|---|---|
| 1 |
Если у вас уже есть активная конечная точка Push API, этот шаг можно пропустить. Заполните требования к серверу. |
|
| 2 |
Для атрибуции AppsFlyer планируйте настройки конечных точек с помощью чек-листа для планирования Push API. |
Не применимо |
| 3 | ||
Требования к серверу (ваш сервер)
Убедитесь, что ваш сервер соответствует следующим требованиям:
| URL-адрес конечной точки |
|
| Ответный код конечной точки | После получения сообщения конечная точка должна вернуть код состояния HTTP 200. |
| Список одобренных серверов AppsFlyer |
Для обеспечения связи с конечной точкой занесите IP-адреса серверов AppsFlyer в разрешенный список ваших межсетевых экранов и систем безопасности. |
| Версии TLS |
|
| Порты |
Порты: 80, 443 |
Чек-лист планирования Push API для атрибуции AppsFlyer
- Используйте этот чек-лист для планирования настроек конечных точек AppsFlyer. Цифры на рисунке соответствуют номерам строк в чек-листе.
- Этот раздел неактуален для атрибуции SKAdNetwork. См. раздел Настройка атрибуции SKAdNetwork.
Конечная точка
|
Нет. |
Настройки |
Детали | Используйте этот столбец для записи планируемых настроек |
|---|---|---|---|
| 1 |
Метод |
POST или GET |
|
|
2 |
URL-адрес конечной точки |
- | |
| 3 | Типы сообщений о событиях |
|
|
|
4 |
|
Выберите нужные поля.
|
|
| 5 |
Типы внутренних событий
|
Фильтруйте по внутренним событиям, чтобы уменьшить трафик, отправляемый на вашу конечную точку.
|
|
| Намереваетесь ли вы отправлять данные пользователей, атрибутированных Facebook? |
|
|
Настройка конечной точки для атрибуции AppsFlyer
- Только администратор может изменять настройки API, члены команды могут их просматривать.
Чтобы добавить конечную точку атрибуции AppsFlyer:
- Перейдите в раздел Интеграция > Доступ к API. Прокрутите вниз до раздела Push API.
- Нажмите Добавить конечную точку.
- Выберите метод HTTP: POST или GET
- Введите URL-адрес конечной точки. Если вы получили сообщение «Этот URL-адрес небезопасен», свяжитесь со службой поддержки AppsFlyer.
- Выберите один или несколько типов событий. Примечание. Если сообщения о внутренних событиях отключены, значит, пока не было записано ни одного внутреннего события.
- Выберите поля, которые нужно включить в сообщение Push API. Внимание:
- Всегда отправляются обязательные поля: идентификатор приложения, имя события, время события, IDFA (iOS) или Advertising ID (Android)
- Чтобы выбрать дополнительные поля, используйте элементы управления, изображенные на рисунке ниже.
- Наиболее часто используемые поля уже выбраны по умолчанию. Вы можете отменить их выбор.
- Выберите нужные вам дополнительные поля.
- Выберите Очистить все , чтобы очистить все дополнительные поля.
- Мы не отправляем пустые поля и связанный с ними ключ. Просим учесть это при планировании ваших процессов импорта/анализа.
- Выберите одно или несколько (до 52) событий или Все события в приложении.
- Список заполняется типами событий, которые уже зарегистрированы. Если какое-то событие отсутствует, отправьте событие такого типа с помощью тестового устройства.
- Нажмите Сохранить.
Push API активен. Данные о конверсиях отправляются на конечную точку. - Проверьте конечную точку в соответствии с описанной ниже процедурой.
- Если вы хотите получать события, атрибутированные Facebook, нужно принять условия использования Facebook. (Требуется для атрибуции AppsFlyer, но не для атрибуции SKAdNetwork).
Чтобы проверить конечную точку:
- Нажмите Send Test (Отправить тест).
Сообщение с результатом теста появится под кнопкой Send Test (Отправить тест) .
Тестовое сообщение отправлено на конечную точку. Если тест пройдет неудачно, проверьте, внесены ли IP-адреса AppsFlyer в список разрешенных.
Внимание! Действует механизм тайм-аута со временем ожидания 3 секунды. Если за это время AppsFlyer не получит сообщение OK, AppsFlyer будет считать это сбоем отправки сообщения. - Проверьте, получено ли тестовое сообщение конечной точкой.
Смотреть копию отправленного сообщения.
Настройка конечной точки для атрибуции SKAdNetwork
Примечание. Только администратор может изменять настройки API. Члены команды могут просматривать настройки Push API.
Чтобы добавить конечную точку SKAdNetwork для Push API:
- Перейдите в раздел Интеграция > Доступ к API. Прокрутите вниз до раздела Push API.
- Выберите SKAdNetwork в качестве субъекта, выполняющего атрибуцию.
- Нажмите Add Endpoint (Добавить конечную точку).
Примечание. Можно задать одну конечную точку SKAdNetwork на приложение. - Выберите метод HTTP: POST или GET
- Введите URL-адрес конечной точки. Если вы получили сообщение «Этот URL-адрес небезопасен», свяжитесь со службой поддержки AppsFlyer.
- Мы не отправляем пустые поля и связанный с ними ключ. Просим учесть это при планировании ваших процессов импорта/анализа.
- Нажмите Сохранить.
Push API активен. Данные отправляются на конечную точку.
Дополнительные процедуры: управление конечными точками
Изменение конечной точки
Примечание. Только администратор может изменять настройки API. Члены команды могут просматривать настройки Push API.
Чтобы изменить настройки конечной точки:
- Выберите в разделе Интеграция пунктДоступ к API.Прокрутите вниз до раздела Push API.
- Найдите конечную точку, которую нужно изменить.
- Внесите изменения.
- Нажмите кнопку Save (Сохранить).
Удаление конечной точки
Примечание. Только администратор может изменять настройки API. Члены команды могут просматривать настройки Push API.
Чтобы удалить конечную точку:
- Выберите в разделе Интеграция пункт Доступ к API. Прокрутите вниз до раздела «Доступ к Push API».
- Нажмите Удалить конечную точку.
- Нажмите кнопку Сохранить.
Конечная точка удалена.
Поиск и устранение неполадок, особенности и ограничения
Ошибка отправки тестового сообщения
Если вы не получили тестовое сообщение, и доступ к вашим серверам органичен по IP-адресу, проверьте, что все IP-адреса AppsFlyer внесены в разрешенный список.
Повторяющиеся события ретаргетинга в приложении
События ретаргетинга в приложении дублируются, когда событие покупки происходит как часть кампании ретаргетинга во время окна повторного вовлечения UA. Это сделано, чтобы атрибутировать доход как медиа-источнику UA, так и медиа-источнику ретаргетинга.
Вы будете получать дублированные события, только если активированы одновременно:
- События внутри приложения при установке
- События ретаргетинга внутри приложений.
Выявление и дедупликация внутренних событий приложения
Выбор сообщений о событиях приложения отключен
- Событие приложения можно выбрать только после того, как было зарегистрировано хотя бы одно такое событие.
- Используйте тестовое устройство, чтобы сгенерировать внутреннее событие, или S2S API, чтобы сделать это вручную.
Отсутствующие данные Facebook
По умолчанию Facebook не передает сырые данные уровня пользователя, пока вы не примете Условия использования Facebook.
Когда вы примете условия, данные уровня пользователя, поступающие от Facebook, будут передаваться через Push API.
Отсутствующие push-сообщения и CloudFront
Вы используете Amazon CloudFront в качестве конечной точки? Если да, проверьте, не отклоняет ли CloudFront сообщение с кодом 421. Если это так, обратитесь к статье Как CloudFront отрабатывает запросы HTTPS.
Сообщения об ошибках конечных точек
Признак: сообщение этот URL-адрес небезопасен отображается при установке URL-адреса конечной точки.
Требуется действие: обратитесь в службу поддержки AppsFlyer; сообщите идентификатор приложения, URL-адрес конечной точки и приложите скриншот с сообщением об ошибке.
Ограничения и особенности
| Специфика | Заметки |
|---|---|
| Рекламным сетям | Недоступно |
| Агентства | Не доступно |
| Часовой пояс приложения | Поддерживается |
| Валюта приложения | Поддерживается |
| Ограничения на размер | Не применимо |
| Органическая | Да |
| Неорганические | Да |
| Актуальность данных | Непрерывно |
| Исторические данные | Не поддерживаются. Чтобы получать исторические данные, используйте Pull API. |
| Доступ члена команды | Члены команды могут просматривать настройки Push API, но не могут их изменять. |