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

转化归因——SDK数据接入

SDK技术对接资源

SDK 平台 资源和说明文档下载
Android SDK 点击下载SDK和说明文档
iOS SDK 点击下载SDK和说明文档

SDK方案优势

  1. 数据更稳定更实时:回传不受上报服务器环境影响,80%的数据不一致问题都是因为广告主上报服务器不稳定造成的数据波动。
  2. 数据稳定性和及时性对oCPA的影响:oCPA优化的是转化回流后的转化成本,转化数据回流的及时性和稳定性对oCPA控制转化成本影响很大,如果数据回流不稳定,模型将需要更多的时间稳定;如果数据回流不及时,一些实时控制转化成本的策略就不会生效,控制成本的难度会更大。
  3. 数据追踪更完善:支持自动获取用户标识,如IMEI、IDFA、ANDROIDID、OAID,减少设备号无法收集的case,增加数据追踪准确性。当前Device ID获取的限制问题:1)Apple系统在iOS10之后,如果用户开启了【限制广告追踪】的开关,则无法获取到IDFA;2)Android 6.0以下可以获取到设备的IMEI号,6.0以上需要弹框用户授权电话权限后才可以获取到。
  4. 不影响点击监测链接配置:可在创建转化ID时填写点击监测链接获取点击信息,点击监测配置要求见《点击监测说明文档》。
  5. 同时支持全部流量(涵盖腾讯视频、腾讯新闻、QQ及信息流、微信等)

SDK接入说明

1. SDK 接入方案概览

广告主在创建创建转化规则时,选择SDK的接入方式,并获取接入密钥(由user_action_set_id和AppSecretKey组成)将接入密钥嵌入SDK中即可正常上报。

2. SDK 接入方案说明

流程说明:
创建转化ID并选择SDK上报 —>下载并导入SDK —>添加SDK所需权限 —>SDK初始化 —>上报转化数据

  1. 创建转化ID并选择SDK上报,参见使用文档《转化归因-sdk接入方式说明》。
  2. 开发同学根据场景部署SDK,具体参考SDK对接文档:
    • 下载SDK
    • 添加SDK所需权限
    • SDK初始化
    • 调动SDK内方法上报行为数据
常用转化行为 行为类型(action_type) 说明
激活 ACTIVATE_APP 30天内第一次打开APP
注册 REGISTER 用户点击广告后注册成为APP的新用户
下单 COMPLETE_ORDER 用户点击下单生成订单
付费 PURCHASE 用户完成付费
加入购物车 ADD_TO_CART 用户将商品加入购物车
次日留存 START_APP 用户激活后第二天打开APP的行为

注:广告主开发者需要在APP启动时上报APP启动行为,SDK会自主判断这次行为是激活行为还是启动行为。
上报APP启动需要找到Activity类(这里以GDTActionLauncherActivity类为例)的onResume()方法,调用下面的代码来上报App启动行为。
GDTAction.logAction(ActionType.START_APP);
// 传入的actionType参数必须是ActionType.START_APP
具体对接流程请下载SDK技术对接文档。
微信公众平台广告主:暂不支持

FAQ

1. 如何判断SDK上报数据是否成功

(1) 启动android studio, log会输出“GDTAction初始化成功”字样
(2) SDK会校验包名:安装SDK的包和上传到应用宝的包,如果包名不一致,会返回报错 ‘51000 package name check failed’
(3) 广告主侧技术人员抓包测试,正确部署的情况下会有a.gdt.qq.com请求发出,因为调用了logActin方法
sdk抓包
(4) 监测DMP后台是否有数据传入
DMP系统的“数据接入”模块,对应的行为数据源可以看到上报成功次数统计
dmp上报

2. 上报行为如何去重

对于需要针对上报行为做自定义去重的广告主,可以在调用logAction(actionType, actionParams)上报行为时,在actionParams中传入key为outer_action_id的参数,如去重付费人数。

3. 客户如何判断自己接的SDK是否是旧版

抓包请求时,请求domain为a.gdt.qq.com为新版SDK;请求domain为t.gdt.qq.com为旧版SDK。

4. 安卓接入时,有渠道包的情况下,是否只需要接主包就可以了,渠道包不用接sdk

理论上推荐所有包都接入SDK。实际投放中如果广告推广使用的是渠道包,可以仅在渠道包中部署SDK(注:仅在渠道包中部署SDK会有遗漏转化行为的可能出现。例如用户点击广告后没有第一时间下载app,而是后续30天内自行前往应用商店下载并激活。安装腾讯广告归因逻辑这一激活应该被诡异给此广告点击,但是如果仅在渠道包部署了SDK,会统计不到此次激活)

5. 优化目标上报方式说明

优化目标名称 标准行为(action_type) 行为参数(action_param) 投放端指标 备注
激活 ACTIVATE_APP 激活总量
次日留存 START_APP length_of_stay=1 次日留存量
注册 REGISTER 注册量
付费 PURCHASE 付费行为量 若要上报金额请在param中添加参数“value”:123
首次付费 PURCHASE 首次付费人数 系统会依据设备号进行去重,若要上报金额请在param中添加参数“value”:123
下单 COMPLETE_ORDER 下单量 若要上报金额请在param中添加参数“value”:123
关键页面浏览 VIEW_CONTENT 关键页面浏览量
商品页浏览 VIEW_CONTENT object=PRODUCT 商品页浏览量
发货 DELIVER 订单发货量 若要上报金额请在param中添加参数“value”:123
加入购物车 ADD_TO_CART 加入购物车量
首次会员购买 PURCHASE object=MEMBER_CARD APP/WEB 系统会依据设备号进行去重,若要上报金额请在param中添加参数“value”:123
完件 APPLY 完件量(金融)
预授信 PRE_CREDIT 预授信量(金融) 若要上报金额请在param中添加参数“value”:123
授信 CREDIT 授信量(金融) 若要上报金额请在param中添加参数“value”:123
提现 WITHDRAW_DEPOSITS 提现量(金融) 若要上报金额请在param中添加参数“value”:123

6. 转化上报常用参数列表(action_param)

参数名 类型 描述 是否必填 取值范围 备注
value int 订单价值,单位:分 体现转化带来的价值,在上报COMPLETE_ORDER或PURCHASE行为时可选填
object string 行为对象 ^.{0,200} 在上报VIEW_CONTENT行为时参数填写为object=product,表示上报的是商品页面浏览行为
length_of_stay int 停留天数,单位:天 在上报START_APP作为留存行为时必填length_of_stay=1,表示上报的是次日留存行为。

7. SDK主要方法说明

com.qq.gdt.action.GDTAction

方法名 功能
init(Context context, String userActionSetId, String appSecretKey) 初始化方法,必须在App的入口调用一次
@param context : App的上下文信息,一般是Application/Activity
@param userActionSetId : 您在DMP数据接入获得的行为数据源ID
@param appSecretKey : 您在DMP数据接入获得的行为数据源Secret ID
logAction(String actionType) 行为上报接口
@param actionType : 行为类型,分为两类,一类是在DMP上定义的标准行为类型,具体见com.qq.gdt.action.ActionType类;另一类是您自己自定义的行为类型,可以传入一个字符串类型的参数,要求:这个字符串只能包含字母、数字和下划线,必须以字母开头,长度不能超过255
logAction(String actionType, JSONObject actionParam) 行为上报接口,支持上报行为参数
@param actionType : 行为类型,详细描述同上
@param actionParam : 行为参数,行为参数是”Key-Value”类型,Key只可以为String类型,只能包含字母、数字和下划线,必须以字母开头,长度不能超过255;Value可以是String/Number/Boolean/JSONArray其中一种,当Value为JSONArray时,它的元素只能为String/Number/Boolean中的一种,且所有元素必须是同一个类型

8. 具体场景示例说明

付费行为
用户发生购物行为时,可以用GDTAction.logAction上报用户的这次行为,并将价格等行为参数一起带上
JSONObject actionParam = new JSONObject();
actionParam.put("value", 6800); //转化价值单位为分,整型
GDTAction.logAction(ActionType.PURCHASE, actionParam);
次日留存
用户次日留存,可以用GDTAction.logAction上报用户的这次行为,并将参数一起带上
JSONObject actionParam = new JSONObject();
actionParam.put(ActionParam.Key.LENGTH_OF_STAY, 1); //必填
actionParam.put(ActionParam.Key.CLAIM_TYPE, 4); //选填,次留关联到激活
GDTAction.logAction(ActionType.START_APP, actionParam);