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

转化归因功能

转化归因功能介绍

什么是转化归因

转化归因是腾讯广告平台将广告点击数据与广告主回传的转化数据进行匹配,从而为广告主确定哪些转化是由哪条广告带来的。是流量方与广告主进行结算的依据,也是广告主查看报表、投放oCPA广告、优化广告效果所依赖的重要功能。

API中使用转化归因功能的条件

如果您使用DMP的(Marketing API、新SDK、新JS,对接文档见:Web转化行为数据接入APP转化行为数据接入)方式上报,则可以使用此功能。

API中使用转化归因功能概述

为了提升广告主回传数据的归因准确性并支持更多特殊场景的归因,腾讯广告对转化归因能力进行了全方位的升级(以下简称“新转化归因能力”)。

目前支持的推广目标有: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下的所有广告。

数据源绑定

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都无法再进行转化追踪。

数据源操作相关接口

如果您想为adgroup绑定或更新数据源,您可以在adgroups模块接口中实现。

如果您需要创建数据源,可以调用user_action_sets/add接口

如果您需要查询您有权限使用的数据源信息,可以调用user_action_sets/get接口,在接口参数中不填user_action_set_id,会返回您所有有权限(自建/被授权)的数据源信息。

user_action_sets细节

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对应数据源的类型不同,将会报错。

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。

user_action_sets与广告创意的关系

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

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