Краткий обзор. Отправляйте сырые данные о событиях атрибуции на серверные конечные точки.
Материал по теме: Сравнение инструментов доставки сырых данных | Настройка Push API с помощью API
Push API
Push API передает сырые данные, создаваемые средствами атрибуции AppsFlyer и SKAdNetwork, в виде сообщений на ваши серверы. Вы можете выбрать типы и контент сообщений и задать конечные точки.
Доступные типы сообщений, частота обновления данных и поля зависят от выполняющей атрибуцию инфраструктуры (AppsFlyer или SKAN), как описано в следующих разделах.
Сообщения атрибуции AppsFlyer
Характеристика | Детали |
---|---|
Разделение сообщений на типы |
Пример: Сообщение содержит следующие данные:
Используя таблицу, определяем, что оно является событием установки, выполненной органическим пользователем. |
Актуальность данных |
Сообщения отправляются вскоре после регистрации события на платформе AppsFlyer. Обычно в течение нескольких минут. |
Содержание сообщения (поля) |
|
Формат полей меток времени |
|
Атрибуция контекст |
Тип сообщения |
Поле conversion_type |
Поле campaign_type |
Поле event_name |
---|---|---|---|---|
Привлечение пользователей | Установка* | установка |
Неорганический: UA Органические: organic |
установка |
Привлечение пользователей | События внутри приложения при установке | установка |
Неорганический: UA Органические: organic |
Имена событий, определяемые рекламодателем |
Ретаргетинг |
повторное вовлечение | повторное вовлечение | retargeting | повторное вовлечение |
Ретаргетинг | События повторного вовлечения внутри приложения | повторное вовлечение | retargeting | Имена событий, определяемые рекламодателем |
Ретаргетинг | Реатрибуция | Повторные установки | retargeting | Реатрибуция |
Привлечение пользователей | Повторные установки | Повторные установки |
Неорганический: UA Органические: organic |
Повторные установки |
Ретаргетинг | События реатрибуции внутри приложения | Повторные установки | retargeting | Имена событий, определяемые рекламодателем |
* Некоторые установки, связанные с атрибуцией по просмотрам, атрибутируются ограниченному медиа-источнику. |
Отображаемое имя | Название Push API |
---|---|
Выбранная валюта* | 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
Примечание. Это не относится к сообщениям постбэков, которые поступают непосредственно из iOS.
Настройка конечных точек Push API
Внимание
Не используйте Push API для отправки данных атрибуции AppsFlyer третьим сторонам, поскольку:
- Вы можете нарушить законы о конфиденциальности, такие как GDPR, если пользователь сообщил о своем нежелании передавать данные третьим сторонам.
- Некоторые медиа-источники ограничивают использование предоставляемых ими данных уровня пользователя, передачу таких данных третьим сторонам, или и то, и другое. Убедитесь, что вы соблюдаете условия использования медиа-источников,
например, Twitter, Snapchat, Pinterest.
Примечание. Это предупреждение не распространяется на данные SKAN. Для отправки данных SKAN на сторонние конечные точки используйте Push API.
Чтобы настроить 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 |
Типы внутренних событий
|
Фильтруйте по внутренним событиям, чтобы уменьшить трафик, отправляемый на вашу конечную точку.
|
Настройка конечной точки для атрибуции AppsFlyer
- Изменять настройки API может только администратор. Пользователи аккаунта могут просматривать настройки Push API.

- Перейдите в раздел Интеграция > Доступ к API. Прокрутите вниз до раздела Push API.
- Нажмите Добавить конечную точку.
- Выберите метод HTTP: POST или GET
- Введите URL-адрес конечной точки. Если вы получили сообщение «Этот URL-адрес небезопасен», свяжитесь со службой поддержки AppsFlyer.
- Выберите один или несколько типов событий. Примечание. Если сообщения о внутренних событиях отключены, значит, пока не было записано ни одного внутреннего события.
- Выберите поля, которые нужно включить в сообщение Push API. Внимание:
- Всегда отправляются обязательные поля: идентификатор приложения, имя события, время события, IDFA (iOS) или Advertising ID (Android)
- Чтобы выбрать дополнительные поля, используйте элементы управления, изображенные на рисунке ниже.
- Наиболее часто используемые поля уже выбраны по умолчанию. Вы можете отменить их выбор.
- Выберите нужные вам дополнительные поля.
- Выберите Очистить все , чтобы очистить все дополнительные поля.
- Мы не отправляем пустые поля и связанный с ними ключ. Просим учесть это при планировании ваших процессов импорта/анализа.
- Выберите одно или несколько (до 52) событий или Все события в приложении.
- Список заполняется типами событий, которые уже зарегистрированы. Если какое-то событие отсутствует, отправьте событие такого типа с помощью тестового устройства.
- Нажмите Сохранить.
Push API активен. Данные о конверсиях отправляются на конечную точку. - Проверьте конечную точку в соответствии с описанной ниже процедурой.
Чтобы проверить конечную точку:
- Нажмите Send Test (Отправить тест).
Сообщение с результатом теста появится под кнопкой Send Test (Отправить тест) .
Тестовое сообщение отправлено на конечную точку. Если тест пройдет неудачно, проверьте, внесены ли IP-адреса AppsFlyer в список разрешенных.
Внимание! Действует механизм тайм-аута со временем ожидания 3 секунды. Если за это время AppsFlyer не получит сообщение OK, AppsFlyer будет считать это сбоем отправки сообщения. - Проверьте, получено ли тестовое сообщение конечной точкой.
Смотреть копию отправленного сообщения.
Настройка конечной точки для атрибуции SKAdNetwork
Примечание. Изменять настройки API может только администратор. Пользователи аккаунта могут просматривать настройки Push API.

- Перейдите в раздел Интеграция > Доступ к API. Прокрутите вниз до раздела Push API.
- Выберите SKAdNetwork в качестве субъекта, выполняющего атрибуцию.
- Нажмите Добавить конечную точку.
Примечание. Можно задать 1–3 конечные точки 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, чтобы сделать это вручную.
Отсутствующие push-сообщения и CloudFront
Вы используете Amazon CloudFront в качестве конечной точки? Если да, проверьте, не отклоняет ли CloudFront сообщение с кодом 421. Если это так, обратитесь к статье Как CloudFront отрабатывает запросы HTTPS.
Сообщения об ошибках конечных точек
Признак: сообщение этот URL-адрес небезопасен отображается при установке URL-адреса конечной точки.
Требуется действие: обратитесь в службу поддержки AppsFlyer; сообщите идентификатор приложения, URL-адрес конечной точки и приложите скриншот с сообщением об ошибке.
Ограничения и особенности
Специфика | Заметки |
---|---|
Рекламным сетям | Недоступно |
Агентства | Не доступно |
Часовой пояс приложения | Поддерживается |
Валюта приложения | Поддерживается |
Ограничения на размер | Не применимо |
Органическая | Да |
Неорганические | Да |
Актуальность данных | Непрерывно |
Исторические данные | Не поддерживаются. Если вам не хватает данных, используйте Pull API, чтобы получить нужные данные. В случае SKAN некоторые исторические данные можно получить через Data Locker (ограничено окном доступности Data Locker). |
Доступ пользователей аккаунта | Пользователи аккаунта могут просматривать настройки Push API, но не могут их изменять. |