接口文档SDK业务专题开发者工具

转化归因功能介绍(旧链路)
  

一. 功能概述
  

  如果您使用“旧版转化归因链路”(通过DMP数据管理平台上报数据)进行归因,以下的功能介绍适用于您的业务需求。
 
  目前支持的推广目标有:PROMOTED_OBJECT_TYPE_LINK (网页推广)、PROMOTED_OBJECT_TYPE_ECOMMERCE(电商推广)、PROMOTED_OBJECT_TYPE_APP_ANDROID (Android应用)、PROMOTED_OBJECT_TYPE_APP_IOS (IOS应用)、PROMOTED_OBJECT_TYPE_LINK_WECHAT (微信品牌页推广)、PROMOTED_OBJECT_TYPE_QQ_MESSAGE (QQ消息)、PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP(应用宝推广)、PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION(Android应用联盟推广)。
  注意,对于应用宝KA广告主,当您选择推广目标为应用宝推广时,暂时无法使用该功能。

 
  如您需要使用转化归因功能,您需要在创建广告时为广告绑定数据源,系统将优先使用广告绑定的数据源来为广告进行转化归因。数据源与广告的推广目标(APP应用、网页等)一一对应。您可以为您投放的推广目标创建一个数据源(创建方式见user_action_sets/add接口),也可以从您的数据上报方获得数据源的授权(请联系接口运营或者客服)。您在使用新转化归因能力时,我们将使用用户标识(点击id、设备号等)+数据源id来做归因匹配,将比旧转化归因方式(只通过用户标识进行归因)更加准确。
 
  因此,在API中使用转化归因功能时,需要为广告组绑定数据源,在广告组 (Adgroup)接口中,user_action_sets参数即为“数据源列表”,为adgroup指定数据源列表后,该数据源列表将同步绑定至该adgroup下的所有广告。
 

二. 数据源绑定
  

2.1 user_action_sets参数简介
  
  user_action_sets是一个数据类型参数,它代表了您要绑定至该adgroup上的数据源列表,该列表将对adgroup下每一个ad同步生效。 

  若您在某个adgroup上设置了user_action_sets,则表示您要开启转化归因功能并选择需要匹配的数据源为user_action_sets传入的数据源,如果未填写代表您要选择全网归因(不限制数据回传的数据源id)。请您谨慎选择以免影响您的广告归因结果及使用oCPA。 

  目前adgroup接口即将支持user_action_sets的更新能力,目前尚未支持,后续: 对于老广告,如果您希望归因更加准确,也请在更新广告组 (adgroups/update)接口中填写此字段。另外,也请您注意,您填写的user_action_sets中的数据源,都必须是合法且有权限的,关于此部分的细节,请参考“2.3.2 user_action_sets合法性验证”  

  绑定完成后,您可以随时修改user_action_sets的值,系统会实时生效。 

  例如,您使用新上报方式回传数据,并在adgroupA上设置了一个user_action_sets参数,该user_action_sets中包含数据源1、2,adgroupA中有三个ad a、b、c,均开启了转化归因开关。则我们将通过数据源1、2回传的数据来计算ad a、b、c为您带来的转化。您如果将adgroupA的user_action_sets值更改为空,则ad a、b、c都无法再进行转化追踪。
 
2.2 数据源操作相关接口
 
• 如果您想为adgroup绑定或更新数据源,您可以在adgroups模块接口中实现。
• 如果您需要创建数据源,可以调用user_action_sets/add接口
• 如果您需要查询您有权限使用的数据源信息,可以调用user_action_sets/get接口,在接口参数中不填user_action_set_id,会返回您所有有权限(自建/被授权)的数据源信息。

  

2.3 user_action_sets细节
 
2.3.1 user_action_sets定义


user_action_sets定义如下:

名称 类型 描述
user_action_sets array of user_action_set 转换归因数据来源,限制如下:
• 推广PROMOTED_OBJECT_TYPE_APP_ANDROID、PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP、PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION:只允许填加ANDROID数据源和Web数据源
• 推广PROMOTED_OBJECT_TYPE_APP_IOS:只允许填加IOS数据源和Web数据源


user_action_set类型定义如下:

名称 类型 描述
id integer 转换归因数据源ID,通过DMP创建和获取,数据源id对应的类型要与指定的type一致
type enum 用户行为源类型 枚举列表:{ WEB, ANDROID, IOS }


• id即为数据源id,是数据源的唯一标识,要想将某个数据源用于某adgroup的转化归因,因此此字段必填。如果您填写的id不存在或者您无权限操作(非您本人创建且未获得授权),将会报错。

• type是数据源类型,用于辅助验证数据源id是否填错,因此此字段必填。如果您填写的type与id对应数据源的类型不同,将会报错。
 
2.3.2 user_action_sets合法性验证
  
  user_action_sets需要合法,才能够为adgroup开启转化归因。
  user_action_sets是否合法首先取决于您上传的user_action_sets必须是真实存在且您有权操作的数据源:

  1. 如果您需要创建数据源,请调用user_action_sets/add接口
  2. 如果您是数据源A的创建者,您可以自由地将数据源A绑定到您的adgroup中,也可以将数据源A授权给其他人使用(请寻找运营或客服协助);
  3. 如果您是数据源A的被授权者,您也可以同样自由地将A绑定至您的adgroup中,但是无法对其他人进行授权;
  4. 如果您想获得数据源A的授权,请联系运营或本页右下角客服头像,她将帮助您完成。在您获得数据源A的授权之前,您无法将其绑定至您的adgroup。

 
 

2.3.3 user_action_sets与广告创意的关系
  
  user_action_sets将对adgroup下绑定的所有广告创意都生效。

  如您在已经选择开启精准归因(在adgroup下已经绑定数据源),此过程无需您进行任何设置,使用了落地页工具制作的落地页(page_type为PAGE_TYPE_TSA_NONE_ECOMMERCE)数据源也会绑定到ad上,通过落地页的page_id进行自动转化归因。