Потоковая передача сырых данных через Push API

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

Материал по теме: Поля с сырыми данными SKAdNetwork. Сообщения Push API имеют аналогичную структуру и поля. 

Определение типа сообщения атрибуции SKAdNetwork

Убедитесь, что ваш сервер соответствует следующим требованиям: 

• Используйте этот чек-лист для планирования настроек конечных точек AppsFlyer. Цифры на рисунке соответствуют номерам строк в чек-листе.
• Этот раздел неактуален для атрибуции SKAdNetwork. См. раздел Настройка атрибуции SKAdNetwork. 

Конечная точка

• Только администратор может изменять настройки API, члены команды могут их просматривать.

Чтобы добавить конечную точку атрибуции AppsFlyer:

1. Перейдите в раздел Интеграция > Доступ к API. Прокрутите вниз до раздела Push API.
2. Нажмите Добавить конечную точку. 
   
3. Выберите метод HTTP: POST или GET
4. Введите URL-адрес конечной точки. Если вы получили сообщение «Этот URL-адрес небезопасен», свяжитесь со службой поддержки AppsFlyer.
5. Выберите один или несколько типов событий. Примечание. Если сообщения о внутренних событиях отключены, значит, пока не было записано ни одного внутреннего события.
6. Выберите поля, которые нужно включить в сообщение Push API. Внимание:
   
   • Всегда отправляются обязательные поля: идентификатор приложения, имя события, время события, IDFA (iOS) или Advertising ID (Android)
   • Чтобы выбрать дополнительные поля, используйте элементы управления, изображенные на рисунке ниже.

     

     • Наиболее часто используемые поля уже выбраны по умолчанию. Вы можете отменить их выбор.
     • Выберите нужные вам дополнительные поля.
     • Выберите Очистить все , чтобы очистить все дополнительные поля.
     • Мы не отправляем пустые поля и связанный с ними ключ. Просим учесть это при планировании ваших процессов импорта/анализа.
7. Выберите одно или несколько (до 52) событий или Все события в приложении.
   
   • Список заполняется типами событий, которые уже зарегистрированы. Если какое-то событие отсутствует, отправьте событие такого типа с помощью тестового устройства.
8. Нажмите Сохранить.
   Push API активен. Данные о конверсиях отправляются на конечную точку.
9. Проверьте конечную точку в соответствии с описанной ниже процедурой.
10. Если вы хотите получать события, атрибутированные Facebook, нужно принять  условия использования Facebook.  (Требуется для атрибуции AppsFlyer, но не для атрибуции SKAdNetwork).

Чтобы проверить конечную точку:

1. Нажмите Send Test (Отправить тест). 
   Сообщение с результатом теста появится под кнопкой Send Test (Отправить тест) . 
   Тестовое сообщение отправлено на конечную точку. Если тест пройдет неудачно, проверьте, внесены ли IP-адреса AppsFlyer в список разрешенных. 
   Внимание! Действует механизм тайм-аута со временем ожидания 3 секунды. Если за это время AppsFlyer не получит сообщение OK, AppsFlyer будет считать это сбоем отправки сообщения. 
2. Проверьте, получено ли тестовое сообщение конечной точкой.
   Смотреть копию отправленного сообщения. 

Примечание. Только администратор может изменять настройки API. Члены команды могут просматривать настройки Push API.

Чтобы добавить конечную точку SKAdNetwork для Push API:

1. Перейдите в раздел Интеграция > Доступ к API. Прокрутите вниз до раздела Push API.
2. Выберите SKAdNetwork в качестве субъекта, выполняющего атрибуцию. 
3. Нажмите Add Endpoint (Добавить конечную точку). 
   Примечание. Можно задать одну конечную точку SKAdNetwork на приложение. 
4. Выберите метод HTTP: POST или GET
5. Введите URL-адрес конечной точки. Если вы получили сообщение «Этот URL-адрес небезопасен», свяжитесь со службой поддержки AppsFlyer.
6. Мы не отправляем пустые поля и связанный с ними ключ. Просим учесть это при планировании ваших процессов импорта/анализа.
7. Нажмите Сохранить.
   Push API активен. Данные отправляются на конечную точку. 

Примечание. Только администратор может изменять настройки API. Члены команды могут просматривать настройки Push API.

 Чтобы изменить настройки конечной точки: 

1. Выберите в разделе Интеграция пунктДоступ к API.Прокрутите вниз до раздела Push API.
2. Найдите конечную точку, которую нужно изменить.
3. Внесите изменения.
4. Нажмите кнопку Save (Сохранить).

Примечание. Только администратор может изменять настройки API. Члены команды могут просматривать настройки Push API.

Чтобы удалить конечную точку:

1. Выберите в разделе Интеграция пункт Доступ к API. Прокрутите вниз до раздела «Доступ к Push API».
2. Нажмите Удалить конечную точку.
3. Нажмите кнопку Сохранить.
   Конечная точка удалена. 

Если вы не получили тестовое сообщение, и доступ к вашим серверам органичен по IP-адресу, проверьте, что все IP-адреса AppsFlyer внесены в разрешенный список.

События ретаргетинга в приложении дублируются, когда событие покупки происходит как часть кампании ретаргетинга во время окна повторного вовлечения UA. Это сделано, чтобы атрибутировать доход как медиа-источнику UA, так и медиа-источнику ретаргетинга. 

Вы будете получать дублированные события, только если активированы одновременно:

• События внутри приложения при установке
• События ретаргетинга внутри приложений.

Выявление и дедупликация внутренних событий приложения

• Событие приложения можно выбрать только после того, как было зарегистрировано хотя бы одно такое событие.
• Используйте тестовое устройство, чтобы сгенерировать внутреннее событие, или S2S API, чтобы сделать это вручную. 

По умолчанию Facebook не передает сырые данные уровня пользователя, пока вы не примете Условия использования Facebook. 
Когда вы примете условия, данные уровня пользователя, поступающие от Facebook, будут передаваться через Push API.

Вы используете Amazon CloudFront в качестве конечной точки? Если да, проверьте, не отклоняет ли CloudFront сообщение с кодом 421. Если это так, обратитесь к статье Как CloudFront отрабатывает запросы HTTPS.

Признак: сообщение этот URL-адрес небезопасен отображается при установке URL-адреса конечной точки.

Требуется действие: обратитесь в службу поддержки AppsFlyer; сообщите идентификатор приложения, URL-адрес конечной точки и приложите скриншот с сообщением об ошибке.