转化数据有效信息及使用场景

推荐用于
开发商 营销人员
最近更新：

概要：本文介绍了如何利用转化数据识别各种转化场景、打造定制化用户体验等等。

简介

下文说明了各种用户转化场景及其对应的转化数据有效信息（payloads）。

您可以使用以下任一方式获取AppsFlyer平台中的转化数据：

由于数据准确性和延时之间存在此消彼长的关系，因此同一个设备ID的转化数据可能会因API而异。

非自然转化数据的有效信息字段

下表列出了非自然转化中总是会呈现的字段，无论该转化来自哪个媒体渠道（media_source）。

总是呈现的字段
有效信息字段名称 原始数据字段名称 说明
media_source Media source

获得归因的媒体渠道。等同于归因链接中的pid参数。
install_time Install time  
click_time Attributed touch time 点击或展示发生的时间，以UTC时间计算
is_first_launch N/A true、false
af_status

原始数据分别呈现在自然量和非自然量两个报告中。

 "Non-organic"
af_siteid Site ID  
adgroup_id Ad ID  
adset Adset  
adset_id Adset ID  
agency Partner null或者代理商名称（仅限由代理商投放的广告）
campaign Campaign  
campaign_id Campaign ID  
http_referrer HTTP Referrer  
retargeting_conversion_type Retargeting Conversion Type “none”或者retargeting_conversion_type
af_sub[n]（n=1—5） Sub Param [n]（n=1–5）  

下表列出了部分情况下会出现的字段，具体取决于SRN对于相关事件的填充方式。

部分情况下会呈现的字段
有效信息字段名称 原始数据字段名称 说明
af_channel Channel

会填充该字段的SRN包括：

  • Facebook
  • Google 
  • Snapchat
  • Twitter
  • Applovin

示例：Facebook—Instagram，Google—YouTube 
orig_cost  

备注（1）
costs_cents_USD  

备注（1）
af_cpi  

备注（1）

注意事项

（1）成本字段的值由广告平台提供。您必须在合作伙伴配置页面中打开成本对接，才能让广告平台将成本数据分享给AppsFlyer。部分SRN支持成本数据的批量分享，这时事件层级的成本字段返回的值为0。

可选的非默认字段

  • AppsFlyer参数列表
  • 您可以在归因链接中添加参数，添加完毕后，这些参数就会出现在有效信息中

详情请见原始数据字段词典

局限性

自定义参数名称

自定义参数的名称不能设置为name（注意这里是小写“n”。Name仍是有效的参数名）。

名为name的参数会被自动从有效信息中移除。

SRN的UA转化数据

自归因平台（SRN）是指实行其自有归因机制的广告平台，如Facebook和Google。

SRN不使用归因链接。也就是说：

  • 有效信息字段是预先定义好的
  • 在归因链接后拼接参数不能使效信息中呈现其他字段

SRN会向AppsFlyer上报转化数据，然后AppsFlyer将这些转化数据呈现在相关应用的面板中。其中可用的字段因SRN而异，详情请见下文的SRN部分。

有关Facebook的注意事项

如果您在Facebook上投放广告，但未签署Facebook的服务条款，AppsFlyer仍能对相关的激活进行归因，但报告可用性会有以下限制：

  • 可用：汇总及分析面板和报告
  • 不可用：原始数据不可用
Facebook Google ASA Snap Twitter Oath

Facebook转化数据

字段名称 说明 数据来源
is_mobile_data_terms_signed   Facebook
match_type 总是显示为"srn" AppsFlyer
media_source 总是显示为"Facebook Ads" AppsFlyer
agency null或归因链接中的af_prt参数值 Facebook
http_referrer 总是显示为null Facebook
retargeting_conversion_type   AppsFlyer
af_channel   Facebook（publisher_platform）
af_status 总是显示为"Non-organic" AppsFlyer
ad_id 仅限Facebook内部使用 Facebook（ad_id）
click_time
 
 AppsFlyer
install_time   AppsFlyer
is_first_launch true、false 设备
adset_id 在原始数据中可用，对应字段为Adset ID Facebook（campaign_id）
is_fb 总是显示为true AppsFlyer
campaign 在原始数据中可用，对应字段为Campaign Name Facebook（campaign_group_name）
campaign_id 在原始数据中可用，对应字段为Campaign ID Facebook（campaign_group_id）
is_paid 总是显示为true Facebook
adgroup 在原始数据中可用，对应字段为Ad Facebook（adgroup_name）
adgroup_id 在原始数据中可用，对应字段为Ad ID Facebook（adgroup_id）
adset 在原始数据中可用，对应字段为Adset Facebook（campaign_name）
af_siteid 总是显示为null Facebook
af_sub[1-5] 总是显示为null 广告主

请注意：与成本有关的字段不可用，这是因为Facebook不会在转化发生时共享成本数据。如果您开通了成本共享，Facebook会与AppsFlyer共享成本，频次为一天数次。

其他广告平台的UA转化

其他广告平台的payload数据受到归因链接中参数的直接影响。

请检查以下JSON payloads。

请注意！返回的转化数据呈映射结构。开发人员不直接接触原始JSON。

Applovin

归因链接：

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=

有效信息（payload）：

{
      "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值的成本相关字段。

ironSource

归因链接：

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

有效信息（payload）：

{
      "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会通过orig_cost、costs_cents_USD和af_cost_value字段在转化发生时将成本相关数据共享给AppsFlyer。

但成本相关数据不会呈现在归因链接中。ironSource会对成本数据加密，并将其储存在af_enc_data字段中。

再营销转化数据

再营销涵盖再归因和再互动两种转化类型。

 提示

部分情况下，您可能无法根据再营销转化数据明确判断出转化类型。详情请参考转化数据的其他来源部分。

SRN带来的再归因

用户通过SRN完成再归因时，转化数据有效信息无法体现出该流量是否来自再归因广告。由于SRN不使用归因链接，因此无法通过归因链接中的is_retargeting=true参数进行标识。对于支持再营销的SRN，AppsFlyer会判定相关用户是否完成了再归因。

也就是说，在这种情况下，SDK无法判断某个激活是否来自再营销广告。这时，唯一的解决方法是在广告系列名称中标识出再营销广告类型。

 注意

即使您在广告系列名称中标识出再营销也无法确保一定能识别出再营销广告。详情请见示例部分。

常规广告平台带来的再归因

广告平台的归因一般通过归因链接完成。不论您通过常规归因链接还是OneLink投放再营销广告，其链接中总是包含is_retargeting=true参数。

Criteo上的再营销广告

归因链接

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参数——用于说明再营销的类型，可能出现的参数值为re-attribution（再归因）、re-engagement（再互动）或none（无）。
  • is_retargeting: true参数——该参数用于标识相关激活是否为再归因。
  • af_reengagement_window参数：用于说明再互动归因窗口期。用户与再营销广告互动后，仅在该窗口期所限定的天数内发生的事件才能归因到再互动用户。由于上述转化的类型是再归因，因此无需用到这个参数。

延迟深度链接的再归因

您可能经常需要为再归因（即卸载后重新安装应用）的用户实现深度链接。假设您为了召回已卸载的流失用户而投放广告，在广告中推广某个产品或服务，并让用户在重新安装并打开应用后直接进入该产品或服务的页面。

这种功能场景就叫做“延迟深度链接”（Deferred Deep Linking）。延迟深度链接的转化数据有效信息来自onConversionDataSuccess方法。

在SRN中使用延迟深度链接

SRN广告中设定的深度链接参数在SRN之外不可用，其中包括含有应用内scheme路径的af_dp参数。唯一的例外情况是Google的信息流应用广告（App campaigns in Feeds）如需再SRN广告中使用延迟深度链接，您必须在其中添加额外的逻辑。您可以使用onConversionSuccess响应中的数据，如广告系列、广告组（adset、adgroup）等，以程序化的方式实现用户跳转。

Facebook中延迟深度链接的转化数据

Android iOS 
{
     "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":"Facebook Ads",
     "install_time":"2017-07-19 08:06:56.189",
     "af_sub2":null
  }

您可以使用getConversionData响应中的数据，如广告系列、广告组等，以程序化的方式为用户实现跳转，并向其展示相关内容。

 示例

假设您有一个运动服装类电商应用。有一个未安装该应用的用户与某个广告互动后激活了应用。在应用首次启动时，SDK会返回相应的转化数据。开发人员让该应用打开商店的夏季跑鞋系列页面（与广告系列对应），并展示女士跑鞋类别（与广告组对应）。

通过归因链接实现延迟深度链接

深度链接的实现方式共有以下三种：

URI scheme

再归因链接和OneLink中使用URI scheme时，归因链接和有效信息如下：

归因链接

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参数，用于说明相关scheme以及用户通过深度链接跳转的页面

iOS Universal Link和安卓App Link

这两种方式也可以实现深度链接。

使用Universal Link或App Link时，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等字段也具有此用途。

     注意事项！

    使用OneLink长链时，有效信息中不会呈现shortlink字段。

    不管您使用长链还是短链，都建议您添加一个自定义参数来说明相关的跳转内容，如&deep_link_activity=shoes_cateogry。

 注意

只有在OneLink场景中才能使用Universal Link和App Link。

SRN带来的再互动

与再归因相同，当用户通过SRN上的广告再次打开应用（即完成再互动）时，转化数据无法体现该流量是否来自再互动广告。如需解决此问题，您可以在广告系列名称中标识出再互动广告类型。

常规广告平台带来的再互动

在该场景中，转化数据有效信息也无法体现出该流量是否来自再归因广告。如需解决此问题，您可以在广告系列名称中标识出再互动广告类型。

深度链接带来的再互动

大部分的再互动广告会让用户跳转到应用中的某个具体页面。举例来说，假设您投放广告宣传某个商品或优惠活动，并希望点击广告的用户能直接进入应用中与该商品或活动相关的页面。

这时您就要用到深度链接。开发人员需要根据深度链接中的转化数据定制用户体验，并将用户引导到对应的页面。

再互动：在SRN中使用深度链接

来自SRN的再互动用户没有可用的转化数据。开发人员需要使用相关SRN提供的方法在应用打开时获取转化数据。

再互动：再广告平台中使用深度链接

沉睡用户被唤醒并打开应用时，您可以通过onAppOpenAttribution方法获取以下转化数据：

在iOS和安卓平台上使用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短链。详情请见此文档。

建议使用OneLink短链的另一个原因是长链返回的转化数据结构是在名为link的单个字段中填充整条长链并作映射。

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

转化数据的其他来源

  • Push API可提供详细的有效转化信息，其中会标识出再归因和再互动。Push API的有效信息中包含名为re_targeting_conversion_type的字段。该字段可说明转化类型，即再归因或再互动。详情请见Push API指南。
  • 原始数据报告也会标识出转化类型。再营销转化的原始数据报告中包含Event Name（事件名称）字段，该字段中可能出现的值为re-engagement（再互动）或re-attribution （再归因），用于说明转化类型。

用户获取与再归因混合场景

  1. 某个用户激活您的应用后将其卸载。其激活行为触发了再归因窗口期。您在Facebook上投放拉新广告（不是再营销），同时在AppsFlyer后台的Facebook对接中启用再营销衡量。该用户在再归因窗口期内看到并点击该广告，随后重新安装并激活了您的应用。AppsFlyer会将其记录为一次再归因。

    该归因结果基于以下两个因素得出：
    1. Facebook对接中启用了再营销
    2. 用户仍处于再归因窗口期内

    在该场景中，广告系列名称并未标识出再归因。
  2. 沿用以上示例，但这次假设该用户在再归因窗口期之后点击广告并重新激活应用。这时AppsFlyer会将其记录为一次新增非自然激活。
  3. 再以另外一种场景为例，假设您在Facebook上投放了再营销广告，一部分从未安装过应用的用户与该广告互动后激活了应用。AppsFlyer不会将这些用户记录为再归因，而是将其视为来自拉新广告的用户。