Charges utiles et exemples de données de conversion

Les paramètres personnalisés ne peuvent pas avoir pour nom name (avec un n minuscule), Name avec un N majuscule est valide).

Si un paramètre a pour nom name, il est retiré de la charge utile.

Lien d'attribution :

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=

Charge utile :

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

• Les paramètres du lien d'attribution apparaissent sous forme de champs dans la charge utile.
• Les autres champs de la charge utile qui ne sont pas dans le lien d'attribution portent une valeur nulle.
• AppLovin prend en charge le partage des coûts publicitaires, mais transmet en masse les données de coûts à AppsFlyer. Les champs liés aux coûts indiquent la valeur 0.

Lien d'attribution :

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

Charge utile :

{
      "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 transmet les données de coûts à AppsFlyer lors de la conversion via les champs orig_cost, costs_cents_USD, et af_cost_value.

Cependant, les données de coûts n'apparaissent pas dans le lien d'attribution. ironSource crypte les données de coûts et les enregistre dans le champ af_enc_data.

Lien d'attribution

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

Charge utile de données de conversion

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

• Paramètre retargeting_conversion_type - ce paramètre indique le type de retargeting. Peut être une réattribution, un réengagement, ou aucun des deux.
• Paramètre is_retargeting : true - ce paramètre indique que l'installation est une installation réattribuée
• af_reengagement_window: la fenêtre d'attribution du réengagement correspond au nombre de jours au cours durant lequel un événement peut être attribué à un utilisateur réengagé. Comme il s'agit d'une conversion de réattribution, ce paramètre est redondant.

Les paramètres de Deep Link définis dans les campagnes SRN ne sont pas disponibles en dehors du SRN. Il le paramètre af_dp, qui contient le chemin du schéma dans l'application. La seule exception à cette règle est lorsque vous utilisez les campagnes Google App dans Feeds. Pour installer le deep linking différé, une autre logique s'applique aux campagnes SRN. Vous devez utiliser les données de la réponse onConversionSuccess, comme la campagne, l'adset, l'adgroup, pour rediriger par programme vos utilisateurs.

Données de conversion pour le deep linking différé avec 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
  }
  

Vous pouvez utiliser les données de la réponse getConversionData (comme la campagne, l'adset, etc.) pour rediriger par programme vos utilisateurs et leur proposer un contenu qui suscitera leur intérêt.

Il existe trois façons de créer des deep links pour les utilisateurs :

Schémas d'URI

Avec les schémas URI, tant pour les liens d'attribution que pour OneLink, le lien d'attribution et les données utiles sont les suivants :

Lien d'attribution

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

Le lien profond universel 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
  

Charge utile

{
      "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 - lorsque ce paramètre apparaît et qu'il est défini sur true, recherchez les champs scheme et host
• scheme et host - ces champs découlent du paramètre af_dp du lien d'attribution, ils indiquent le schéma et l'activité vers lesquels l'utilisateur doit être deep linké.

Liens universels iOS et liens vers les apps Android

Ce sont les deux autres moyens pour actionner le deep linking.

Lorsque vous utilisez des liens universels ou des liens d'app, le OneLink et la charge utile sont les suivants :

Le lien profond universel 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
  

Charge utile

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

• champ shortlink - il s'agit du champ qui indique le OneLink d'où provient l'utilisateur. Il permet au développeur de savoir comment procéder pour lancer une activité et proposer du contenu. D'autres champs, comme campaign, peuvent être utilisés dans le même but.

   Important !

  Le champ shortlink n'apparaît pas dans la charge utile avec l'utilisation d'un long OneLink.

  Dans les deux cas (OneLink court ou long), nous recommandons d'ajouter un paramètre personnalisé qui indiquera l'activité. Par exemple &deep_link_activity=shoes_cateogry

Les données de conversion ne sont pas disponibles lorsqu'un utilisateur ré-engagé provient d'un SRN. Le développeur doit utiliser les méthodes du SRN pour les obtenir au moment où l'application est lancée.

Lorsqu'un utilisateur est ré-engagé et que l'app est lancée, les données de conversion suivantes sont disponibles dans la méthode onAppOpenAttribution :

Sous iOS comme Android, en cas d'utilisation de la version courte du OneLink, les données de conversion s'affichent sous la forme d'une carte avec l'ensemble des paramètres du lien :

Exemple :

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

• Le développeur d'app peut utiliser ces paramètres, comme af_dp ou le nom de la campagne, pour envoyer l'utilisateur vers une activité précise, et lui proposer le contenu correspondant.

Une autre des raisons qui fait qu'il vaut mieux utiliser la version courte du OneLink, c'est la structure des données de conversion renvoyée par la version longue. Avec la version longue, les données de conversion s'affichent sous forme de carte avec un champ unique appelé link et qui contient l'intégralité du OneLink long.

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