Cargas útiles y escenarios de datos de conversión

Los parámetros personalizados no se pueden llamar name ("n" en minúsculas. Name es válido).

Si un parámetro se llama name, se elimina de la carga útil.

Enlace de atribución:

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=

Carga útil:

{
      "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"
  }
  

• Los parámetros en el enlace de atribución aparecen como campos en la carga útil.
• Los demás campos en la carga útil que no están en el enlace de atribución aparecen con un valor nulo.
• AppLovin admite costos compartidos de anuncios, pero envía los datos de costos a AppsFlyer de forma masiva. Los campos relacionados con el costo se devuelven como 0.

Enlace de atribución:

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*********************************************************************

Carga útil:

{
      "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 comparte los datos relacionados con los costos con AppsFlyer al realizar la conversión usando los campos orig_cost, costs_cents_USD y af_cost_value.

Sin embargo, los datos relacionados con los costos no aparecen en el enlace de atribución. ironSource cifra los datos de costos y los almacena en el campo af_enc_data.

Enlace de atribución

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

Carga útil de los datos de conversión

{
      "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"
  }

• Parámetro retargeting_conversion_type: este parámetro indica el tipo de retargeting. Puede ser reatribución, re-engagement o ninguno.
• Parámetro is_retargeting: true: este parámetro indica que la instalación es una instalación reatribuida.
• af_reengagement_window: la ventana de atribución de re-engagement es el número de días en los que un evento puede atribuirse a un usuario recaptado. Dado que se trata de una conversión de reatribución, este parámetro es redundante.

Los parámetros de enlaces profundos definidos en las campañas de SRN no están disponibles fuera de las SRN. Esto incluye el parámetro af_dp, que contiene la ruta de acceso del esquema en la aplicación. La única excepción a esto es cuando se utilizan campañas de Google App en Feeds. A fin de implementar enlaces profundos diferidos, se debe aplicar una lógica adicional para las campañas de SRN. Usa los datos de la respuesta onConversionSuccess, como la campaña, el conjunto de anuncios, el grupo de anuncios, para redirigir programáticamente a tus usuarios.

Datos de conversión para enlace profundo diferido con Anuncios de Meta

{
     "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
  }
  

Puedes usar los datos en la respuesta de getConversionData, como la campaña, conjunto de anuncios, etc. para redirigir programáticamente a tus usuarios y servirles contenido relevante.

Hay tres formas de enlazar profundamente a los usuarios:

Esquemas URI

Al usar esquemas URI, tanto para los enlaces de atribución como para OneLink, el enlace de atribución y la carga útil son los siguientes:

Enlace de atribución

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
  

Carga útil

{
      "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: cuando este parámetro aparece y se establece en true, busca los campos scheme y host.
• scheme y host: estos campos provienen del parámetro af_dp en el enlace de atribución e indican el esquema y la actividad a la que el usuario debe estar enlazado profundamente.

Enlaces universales de iOS y enlaces de aplicaciones de Android

Estas son las otras dos de las tres formas de realizar enlaces profundos.

Cuando se utilizan enlaces universales o enlaces de aplicaciones, el OneLink y la carga útil son los siguientes:

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
  

Carga útil

{
      "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
  }

• Campo shortlink: este campo indica el OneLink específico del que proviene el usuario. Ayuda al desarrollador a saber cómo proceder para ejecutar una actividad y servir contenido. Otros campos, como campaign, también pueden utilizarse para este propósito.

   ¡Importante!

  El campo shortlink no aparece en la carga útil cuando se usa el OneLink largo.

  En ambos casos (OneLink corto o largo) recomendamos agregar un parámetro personalizado que indique la actividad. Por ejemplo &deep_link_activity=shoes_cateogry

Los datos de conversión no están disponibles cuando un usuario recaptado proviene de una SRN. El desarrollador debe usar los métodos de las SRN para obtenerlo al lanzar la aplicación.

Cuando se recapta a un usuario y se inicia la aplicación, los siguientes datos de conversión están disponibles en el método onAppPenAttribution:

Tanto para iOS como para Android, cuando se usa la versión corta de OneLink, los datos de conversión constituyen un mapa estructurado de todos los parámetros incluidos en el enlace:

Ejemplo:

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

• El desarrollador de la aplicación puede utilizar dichos parámetros, como af_dp y el nombre de la campaña, para enviar al usuario a una actividad específica y servir el contenido relevante.

Otra razón para utilizar la versión corta de OneLink es la estructura de los datos de conversión que devuelve la versión larga. Cuando se usa la versión larga, los datos de conversión son un mapa con un solo campo llamado link que contiene todo el OneLink largo.

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