Руководство по интеграции SKAN для рекламных сетей

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

Рекламная сеть:

• Получает постбэк от устройства iOS.
• [Необязательно] Обогащает постбэк следующими данными:
  • Идентификатор кампании рекламной сети и название кампании.
  • IP-адрес, полученный от устройства, необходимый в основном для целей разрешения гео. 
  • Временная метка постбэка, отправленного с устройства iOS.
• [Необязательно] Обогащает постбэк следующими данными:
  • Идентификатор и название группы объявлений
  • Идентификатор и название объявления
  • Название рекламной сети
  • Код страны
  • ID исходного приложения
  • Креатив
  • Канал
• Отправляет постбэк в AppsFlyer
• Внимание! Перед отправкой постбэка в AppsFlyer проверьте подпись атрибуции Apple с помощью содержимого исходящего постбэка, чтобы убедиться, что вы случайно не повредили данные.

Протокол обогащенных постбэков SKAN

Параметры обогащенных постбэков SKAN в JSON

Пример Curl — обогащенный постбэк SKAN 3

curl --location --request POST 'https://skadpostbacks.appsflyer.com/api/postbacks?app_id=id888707074' \
  --header 'Content-type: application/json' \
  --data-raw '{
      "version":"3.0",
      "app-id": 888707086,
      "ip": "192.0.2.0",
      "ad-network-campaign-name": "skadnetwork_abc_campaign",
      "source-app-id": 888707074,
      "ad-network-id": "abcabcabc.skadnetwork",
      "transaction-id": "68eb3d91-15f5-44ee-9267-25c7655c20b6",
      "redownload": false,
      "attribution-signature": "MDYCGQCsQ4y8d4BlYU9b8Qb9BPWPi+ixk/OiRysCGQDZZ8fpJnuqs9my8iSQVbJO/oU1AXUROYU=",
      "timestamp": "1596525944",
      "ad-network-campaign-id": "222222",
      "conversion-value": 63,
      "campaign-id": 99
  }'

Пример Curl — обогащенный постбэк SKAN 4 с точными значениями конверсии

curl --location --request POST 'https://skadpostbacks.appsflyer.com/api/postbacks?app_id=id888707074' \
  --header 'Content-type: application/json' \
  --data-raw '{
      "version": "4.0"
      "ad-network-id": "example123.skadnetwork",
      "ad-network-campaign-name": "skadnetwork_abc_campaign",
      "ad-network-campaign-id": "222222",
      "source-identifer": "5239",
      "app-id": 525463029,
      "transaction-id": "6aafb7a5-0170-41b5-bbe4-fe71dedf1e30",
      "redownload": false,
      "source-app-id": 1234567891,
      "fidelity-type": 1, 
      "did-win": true,
      "conversion-value": 63
      "postback-sequence-index": 0
      "attribution-signature": "MEUCIGRmSMrqedNu6uaHyhVcifs118R5z/AB6cvRaKrRRHWRAiEAv96ne3dKQ5kJpbsfk4eYiePmrZUU6sQmo+7zfP/1Bxo="
  }'

Пример Curl — обогащенный постбэк SKAN 4 с приблизительными значениями конверсии

curl --location --request POST 'https://skadpostbacks.appsflyer.com/api/postbacks?app_id=id888707074' \
  --header 'Content-type: application/json' \
  --data-raw '{
      "version": "4.0"
      "ad-network-id": "example123.skadnetwork",
      "ad-network-campaign-name": "skadnetwork_abc_campaign",
      "ad-network-campaign-id": "222222",
      "source-identifer": "39",
      "app-id": 525463029,
      "transaction-id": "6aafb7a5-0170-41b5-bbe4-fe71dedf1e31",
      "redownload": false,
      "source-app-id": 1234567891,
      "fidelity-type": 1, 
      "did-win": true,
      "coarse-conversion-value": "high"
      "postback-sequence-index": 0
      "attribution-signature": "MEUCIQD4rX6eh38qEhuUKHdap345UbmlzA7KEZ1bhWZuYM8MJwIgMnyiiZe6heabDkGwOaKBYrUXQhKtF3P/ERHqkR/XpuA="
  }'

При использовании этого метода рекламная сеть отвечает устройству командой HTTP перенаправления (307), передавая устройству запрос об отправке постбэка непосредственно в AppsFlyer. 

Метод перенаправления имеет следующие преимущества:

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

Реализация

1. Настройте сервер на ответ HTTP 307, перенаправляющий постбэк на https://skadredirect.appsflyer.com/api/redirects
2. Добавьте параметры запроса, содержащие сведения о кампании, используя параметры запроса, перечисленные в следующей таблице. Считайте отправку данных о вашей кампании обязательной. Информация о кампании позволяет нам обогатить данные SKAN данными о стоимости и другими данными о кампании и позволяет рекламодателям эффективно оптимизировать кампании.

Пример URL для перенаправления

https://skadredirect.appsflyer.com/api/redirects?
  &ad-network-campaign-id=243232&ad-network-campaign-name=yarg_campaign_name
  &ad-network-adset-name=dsdsa&creative=examplecreative&channel=channelexample

Параметры запроса для получения сведений о кампании (не обязательно)

• Для каждого постбэка, отправленного из рекламной сети в AppsFlyer, AppsFlyer отправляет:
  • Один постбэк об установке. Повторная загрузка обозначается параметром redownload. 
  • От нуля до нескольких постбэков о событиях в приложении. Точное число зависит от перевода значения конверсии. См. имитацию постбэков.
• При получении постбэков одна и та же установка или событие может быть атрибутировано несколькими решениями AppsFlyer для атрибуции. Используйте параметр attribution_source, чтобы различать типы постбэков. 

Пример постбэка SKAN об установке, отправленного AppsFlyer

http://YourCompanyDomain.com/event?site_id=(publisher-id)&install_time=(timestamp)
  &skan_ad_network_time=(timestamp)
  &skan_af_received_time=(timestamp)
  &attribution_source=skadnetwork
  &app_id=(id123456789)&country=(ZA)&campaign=(campaign-name)
  &campaign_id=(campaign-id)&SKAN_ambiguous_event=(boolean)
&redownload=(boolean)
&af_SKAN_nonce=(uuid)

Пример постбэка SKAN о внутреннем событии, отправленного AppsFlyer

http://YourCompanyDomain.com/event?site_id=(publisher-id)&install_time=(timestamp)
  &skan_ad_network_time=(timestamp)
  &skan_af_received_time=(timestamp)&revenue=(value)
  &currency=(code)&event_name=(event-name)&attribution_source=skadnetwork
  &app_id=(id123456789)&country=(ZA)&campaign=(campaign-name)
  &campaign_id=(campaign-id)&SKAN_ambiguous_event=(boolean)
&redownload=(boolean)
&af_SKAN_nonce=(uuid)

Используя этот метод, рекламная сеть отправляет AppsFlyer фактические постбэки SKAN из реальных приложений. 

Тестирование интеграции

Критерии тестирования

• При использовании этого метода рекламная сеть отправляет тестовым приложениям AppsFlyer заранее подготовленные постбэки, как подробно описано в таблице ниже. AppsFlyer отвечает рекламной сети декодированными постбэками.
• Каждое тестовое приложение имеет свое сопоставление значений конверсии, как показано в таблице.

Этапы интеграции

Критерии тестирования