Полезная нагрузка в данных о конверсиях и сценарии использования

Пользовательские параметры не могут быть вызваны name (строчная "n". Name допустимо).

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

Ссылка атрибуции:

https://app.appsflyer.com/com.company.app?af_ad=ad_name&af_ad_type=INTER
  &af_channel=video&af_siteid=123_site_id&af_c_id=b8******************************&
  af_adset=_DEFAULT&pid=applovin_int&c=campaign_name
  &af_click_lookback=7d&clickid=10****************
  &advertising_id=50********************************&af_ip=

Полезная нагрузка:

{
      "adgroup": null,
      "campaign": "campaign_name",
      "media_source": "applovin_int",
      "retargeting_conversion_type": "none",
      "adset_id": null,
      "campaign_id": null,
      "install_time": "2018-12-30 23:49:54.186",
      "adgroup_id": null,
      "orig_cost": "0.0",
      "click_time": "2018-12-24 14:29:33.738",
      "agency": null,
      "cost_cents_USD": "0",
      "af_ad_type": "INTER",
      "af_c_id": "b8******************************",
      "adset": null,
      "advertising_id": "50********************************",
      "af_sub1": null,
      "clickid": "10****************",
      "af_click_lookback": "7d",
      "af_siteid": "123_site_id",
      "af_ad": "ad_name",
      "http_referrer": null,
      "af_channel": "video",
      "af_adset": "_DEFAULT",
      "af_sub5": null,
      "af_sub4": null,
      "af_cpi": null,
      "af_sub3": null,
      "af_sub2": null,
      "af_status": "Non-organic"
  }
  

• Параметры в ссылке атрибуции появляются как поля в полезной нагрузке
• Другие поля в полезной нагрузке, которые не входят в ссылку атрибуции, отображаются со значением null.
• AppLovin поддерживает предоставление данных о затратах на рекламу, но отправляет данные о затратах в AppsFlyer в массовом порядке. Поля, связанные с затратами, возвращаются как 0.

Ссылка атрибуции:

https://app.appsflyer.com/id123456789?
  af_ua=Mozilla/5.0+(iPhone;+CPU+iPhone+OS+12_1_2+like+Mac+OS+X)+AppleWebKit/605.1.15+(KHTML,+like+Gecko)+Mobile/16C101
  &clickid=ab*******************&redirect=false
  &ua=Mozilla/5.0+(iPhone;+CPU+iPhone+OS+12_1_2+like+Mac+OS+X)+AppleWebKit/605.1.15+(KHTML,+like+Gecko)+Mobile/16C101
  &af_lang=pt&imei=&af_sub1=&advertising_id=&af_ip=192.168.0.1&pid=ironsource_int
  &device_ip=192.168.0.1&c=campaign_name
  &idfa=01**********************************&af_siteid=123_site_id&
  af_enc_data=cN*********************************************************************

Полезная нагрузка:

{
      "adgroup": null,
      "af_enc_data": "cN**************************************************************************************",
      "campaign": "campaign_name",
      "media_source": "ironsource_int",
      "retargeting_conversion_type": "none",
      "adset_id": null,
      "campaign_id": null,
      "install_time": "2018-12-30 23:59:32.194",
      "adgroup_id": null,
      "redirect": "false",
      "orig_cost": "0.75",
      "click_time": "2018-12-30 23:58:54.517",
     "agency": null,
      "cost_cents_USD": "75",
      "adset": null,
      "advertising_id": "35**********************************",
      "af_sub1": null,
      "af_ip": "192.168.0.1",
      "clickid": "ab*******************",
      "af_sub3": null,
      "af_cost_value": "0.75",
      "af_ref": "ironsource_5f******************************************",
      "af_siteid": "123_site_id",
      "http_referrer": null,
      "af_cost_model": "cpi",
      "af_ua": "Mozilla/5.0 (Linux; Android 8.0.0; SM-N950F Build/R16NW; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/71.0.3578.99 Mobile Safari/537.36",
      "af_cost_currency": "USD",
      "af_sub5": null,
      "af_sub4": null,
      "af_lang": "en",
      "af_cpi": null,
      "af_click_lookback": "7d",
      "af_sub2": null,
      "af_status": "Non-organic"
  }
  

ironSource делится данными о затратах с AppsFlyer при конверсии, используя поля orig_cost, cost_cents_USD и af_cost_value.

Однако данные, связанные с затратами, не появляются в ссылке атрибуции. ironSource шифрует данные о затратах и сохраняет их в поле af_enc_data.

Ссылка атрибуции

https://app.appsflyer.com/id1234567895?pid=criteo_int&af_click_lookback=30d&
  c=campaign_name&is_retargeting=true&redirect=false&idfa=68**********************************
  &af_reengagement_window=30d

Полезная нагрузка данных о конверсиях

{
      "adgroup": null,
      "campaign": "campaign_name",
      "media_source": "criteo_int",
      "retargeting_conversion_type": "re-attribution",
      "adset_id": null,
      "campaign_id": null,
      "af_reengagement_window": "30d",
      "install_time": "2018-12-01 23:13:03.126",
      "adgroup_id": null,
      "redirect": "false",
      "af_sub5": null,
      "click_time": "2018-11-18 20:02:31.559",
      "agency": null,
      "cost_cents_USD": "0",
      "is_retargeting": "true",
      "af_cpi": null,
      "af_click_lookback": "30d",
      "af_siteid": null,
      "idfa": "68**********************************",
      "http_referrer": null,
      "orig_cost": "0.0",
      "af_sub4": null,
      "adset": null,
      "af_sub1": null,
      "af_sub3": null,
      "af_sub2": null,
      "af_status": "Non-organic"
  }

• Параметр retargeting_conversion_type указывает на тип ретаргетинга. Это может быть либо реатрибуция, либо повторное вовлечение, либо ни то, ни другое.
• Параметр is_retargeting: true указывает, что установка является повторной атрибутированной установкой.
• af_reengagement_window: Окно атрибуции после повторного вовлечения — это количество дней, в течение которых событие можно атрибутировать повторно вовлеченному пользователю. Поскольку речь идет о конверсии реатрибуции, этот параметр является избыточным.

Параметры диплинкинга, заданные в рекламных кампаниях SRN, за пределами этой SRN недоступны. К этим параметрам относится и параметр af_dp, в котором содержится схема пути в приложении. Единственным исключением является использование кампаний Google для приложений в ленте. Для использования отложенного диплинкинга для рекламных кампаний в SRN необходимы дополнительные алгоритмы. Используйте данные в ответе onConversionSuccess, такие как кампания, группа объявлений, рекламный блок, чтобы запрограммированно перенаправлять пользователей.

Данные о конверсиях для отложенного диплинкинга с Meta Ads

{
     "adset":"Adidas Running Shoes Women",
       "adgroup": null,
     "campaign_id":"6**********",
     "af_status":"Non-organic",
     "retargeting_conversion_type": "none",
     "agency":null,
     "af_sub3":null,
     "af_siteid":null,
     "adset_id":"6**********",
     "is_fb":true,
     "is_first_launch":true,
     "click_time":"2017-07-18 12:55:05",
     "iscache":false,
     "ad_id":"6**********",
     "af_sub1":null,
     "campaign":"running shoes summer collection",
     "is_paid":true,
     "af_sub4":null,
     "adgroup_id":"6**********",
     "is_mobile_data_terms_signed":true,
     "af_channel":"Facebook",
     "af_sub5":null,
     "media_source":"Meta ads",
     "install_time":"2017-07-19 08:06:56.189",
     "af_sub2":null
  }

  {
     "media_source":"Meta ads",
     "campaign":"running shoes summer collection",
     "adset":"Running Shoes Women",
     "adgroup":null,
     "campaign_id":"6**********",
     "retargeting_conversion_type": "none",
     "af_status":"Non-organic",
     "agency":null,
     "af_sub3":null,
     "af_siteid":null,
     "adset_id":"6**********",
     "is_fb":true,
   "is_first_launch":true,
     "click_time":"2017-07-17 16:23:18",
     "iscache":false,
     "ad_id":"6**********",
     "af_sub1":null,
     "is_paid":true,
     "af_sub4":null,
     "adgroup_id":"6**********",
     "is_mobile_data_terms_signed":true,
     "af_channel":"Facebook",
     "af_sub5":null,
     "install_time":"2017-07-18 15:10:50.190",
     "af_sub2":null
  }
  

Вы можете использовать данные в ответе getConversionData, такие как кампания, группа объявлений и т.д., для программного перенаправления пользователей и показа им соответствующего контента.

Есть три способа диплинкинга пользователей:

Схема URI

При использовании схем URI, как для ссылок атрибуции, так и для OneLink, ссылка атрибуции и полезная нагрузка выглядят следующим образом:

Ссылка атрибуции

http://app.appsflyer.com/com.appsflyer.nivisampleapp?pid=media_source_name
  &c=campaign_name&af_dp=superapp%3A%2F%2deeplink-activity

Универсальные ссылки OneLink

// short OneLink
  https://dhba.onelink.me/2rAD/71ba577e
  
  //long OneLink
  https://dhba.onelink.me/2rAD?pid=media_source_name&c=campaign_name
  &is_retargeting=true&af_dp=superapp%3A%2F%2deeplink-activity
  

Полезная нагрузка

{
      "af_deeplink": true,
      "campaign": "campaign_name",
      "media_source": "media_source_name",
      "retargeting_conversion_type": "none",
      "adset_id": null,
      "campaign_id": null,
      "orig_cost": "0.0",
      "click_time": "2018-12-30 23:59:09",
      "install_time": "2018-12-30 23:59:39.330",
      "agency": null,
      "cost_cents_USD": "0",
      "adset": "AD_SET_NAME",
      "ad_id": "AD_ID",
      "af_siteid": null,
      "http_referrer": null,
      "af_cpi": null,
      "af_sub5": null,
      "af_sub4": null,
      "af_sub1": null,
      "af_sub3": null,
      "af_sub2": null,
      "af_status": "Non-organic",
      "scheme": "superapp",
      "host": "deeplink_activity"
  }

• af_deeplink: true — при появлении этого параметра со значением true найдите поля scheme и host.
• scheme и host — эти поля берутся из параметра af_dp в ссылке атрибуции и указывают схему и активность, на которую пользователь должен быть перенаправлен по диплинку.

Универсальные ссылки iOS и Android App Links

Это два других из трех способов осуществления диплинкинга.

При использовании универсальных ссылок iOS и Android App Links, ссылка OneLink и полезная нагрузка выглядят следующим образом:

Универсальные ссылки OneLink

// short OneLink
  https://dhba.onelink.me/2rAD/71ba577e
  
  //long OneLink
  https://dhba.onelink.me/2rAD?pid=media_source_name&c=campaign_name
  &is_retargeting=true
  

Полезная нагрузка

{
      "install_time": "2019-01-08 16:24:49.853",
      "cost_cents_USD": "0",
      "campaign": "campaign_name",
      "retargeting_conversion_type": "none",
      "is_first_launch": true,
      "click_time": "2019-01-08 16:24:14.322",
      "af_click_lookback": "7d",
      "orig_cost": "0.0",
      "af_status": "Non-organic",
      "iscache": "true",
      "shortlink": "71ba577e",
      "media_source": "media_source_name",
      "is_retargeting": true
  }

• Поле shortlink указывает на конкретную ссылку OneLink, по которой пришел пользователь. Оно помогает разработчику понять, как действовать дальше в плане запуска активности и показа контента. Для этой цели можно использовать и другие поля, такие как campaign.

    Важно!

  Поле shortlink не появляется в полезной нагрузке при использовании длинной ссылки OneLink.

  В обоих случаях (короткая или длинная ссылка OneLink) мы рекомендуем добавить настраиваемый параметр, указывающий на активность. Например: &deep_link_activity=shoes_cateogry

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

Когда пользователь повторно вовлечен и запускает приложение, в методе onAppOpenAttribution доступны следующие данные о конверсии:

Как в iOS, так и в Android, при использовании короткой версии OneLink данные о конверсиях представляют собой структурированное сопоставление всех параметров в ссылке:

Пример:

{
     af_dp: "superapp://Deeplink",
     pid: "media_source_name"
     c: "campaign_name",
     link: "https://abcd.onelink.me/12ab/12ab34c"
     is_retargeting: true
  }

• Разработчик приложения может использовать такие параметры, как af_dp и название кампании, чтобы направить пользователя на определенную активность и показать соответствующий контент.

Еще одна причина использовать короткую версию OneLink — это структура данных о конверсиях, которую возвращает длинная версия ссылки. При использовании длинной версии данные о конверсиях представляют собой сопоставление с единственным полем link, в котором содержится вся длинная ссылка OneLink.

{
     "link": "https://abcd.onelink.me/12ab?pid=media_source&c=campaign_name&is_retargeting=true&af_dp=superapp%3A%2F%2FDeepLink"
  }