功能介绍
新链路
一.什么是点击转发工具?
当您投放的广告时,广告上会积累不同维度的用户点击行为数据。这些数据可以被应用于不同的业务场景,如提高归因准确度、实现APP冷启动、搭建企业数据报表、实现H5跨屏归因能力等等。点击转发工具就是获取广告点击数据的平台,如果您希望通过用户的点击行为数据在现有广告效果上进一步探索,推荐您使用该工具。目前点击转发功能支持移动应用,网页,小游戏,小程序及原生落地页的数据转发。
二.产品入口
登录腾讯广告投放管理平台 -> 鼠标移入上方工具栏 -> 点击 效果分析-转化归因 进入转化归因列表。
根据投放载体类型选择 应用转化 或 网页转化。应用转化适用于投放 Android 应用(包含广告包)、iOS 应用的场景,网页转化适用于投放网页和小程序广告创建转化。
一、新链路配置流程引导
选择上报方式
以应用归因为例,点击新建转化归因。在弹窗中选择上报方式,可根据需求与技术人员确认。SDK数据实时且稳定、操作简单,适合游戏类APP投放;APP上报只需要一次部署、不需要重新集成,适合自归因上报的客户。
填写新建转化表单
以SDK上报方式为例,进入表单后请填写以下内容:
- 转化名称:客户可根据实际情况命名,且账户内不同转化配置名称不能重复
- 应用类型
- 应用ID:根据不同的应用类型输入;新建SDK应用转化在输入后应用ID后需要获取SDK密钥(见下文)
- 选择优化目标和深层优化目标
- 输入点击监测链接:点击检测链接由技术人员提供,须在联调前提供。详情请参阅点击监测链接使用指南。
获取SDK密钥
在新建SDK应用转化表单填写页面输入应用ID后,可点击右侧的 获取密钥 按钮来获取密钥。一个应用只能使用一个密钥,将密钥嵌入SDK中才能正常上报。只有创建和被授权该密钥的账户可以看到全量数据。获取的密钥会自动复制到剪贴板。之后也可以在 应用转化 – 详情 – 配置信息中可以看到生成的密钥(如下图)。
二、联调流程介绍
小程序不需要联调。
配置成功后,系统会引导您进行联调。联调的目的是测试广告主是否能够接收到正确的数据。为保证检测顺利,请于开始检测前和技术人员确认已完成数据对接。若投放时你需使用到渠道包,则选择渠道包。 如果您的测试设备是Android 7.0及以上的版本,推荐您使用转化联调助手。如果您手机上没有转化联调助手,请扫描右侧二维码下载app。下载完成后进入下一步,
按照页面上的指引完成联调。如果您的测试设备是Android 7.0及以上的版本的手机,请您务必使用转化联调助手扫描二维码,以保证联调顺利进行。
三、点击转发的其他功能介绍
- 修改:目前仅支持修改转化名称和点击监测链接。
- 若您要修改转化名称,点击转化名称右边的按钮即可进行修改。
- 若您要修改点击检测链接,则点击 详情按钮,点击 点击监测链接 旁边的按钮即可修改。一旦配置信息修改提交成功,联调状态默认为未联调;转化状态为未开启。您需要重新进行联调和开启转化状态。
- 删除:您可以通过删除按钮对已有配置进行删除,一旦配置信息删除,系统将停止向您发送对应的点击行为数据。
- 详情:您可以通过详情按钮查看配置信息,并修改点击检测链接、进行转化联调联调,如下图所示。
常见问题
获取点击数据后,广告主如何设置归因逻辑?
建议广告主按照如下优先级设置自己的归因逻辑:
对于Android系统:
(1)优先使用muid归因
(2)若muid归因失败,使用AndroidID归因
(3)若AndroidID归因失败,使用oaid归因
(4)若oaid归因失败,使用IP+UA归因
对于iOS系统:
(1)优先使用muid归因
(2)若muid归因失败,使用qaid_ caa归因
(3)若qaid_ caa归因失败,使用IP+UA归因
在新版转化归因链路中,必须将click_id放在callback中回传。
如何基于获取到的点击下发数据,更高效地进行APP冷启动?
若您希望基于点击数据提高APP冷启动效率,除了配置推荐的字段外,您可以勾选“广告名称”字段,系统将向您下发广告对应的中文名称。您可以基于名称中带有的素材信息针对性地向用户进行推荐。
旧链路
一.为什么要使用点击转发工具?
当您投放的广告时,广告上会积累不同维度的用户点击行为数据。这些数据可以被应用于不同的业务场景,如提高归因准确度、实现APP冷启动、搭建企业数据报表、实现H5跨屏归因能力等等。点击转发工具就是获取广告点击数据的平台,如果您希望通过用户的点击行为数据在现有广告效果上进一步探索,推荐您使用该工具。目前点击转发功能支持移动应用,网页,小游戏,小程序及原生落地页的数据转发。
二.产品入口
老链路路径:“工具”-“效果分析”-“点击监测”即可进入点击数据配置页面,在页面中您可以根据业务需求进行配置、联调和启动,以获取点击数据。
三、老链路配置流程引导
选择类型
移动应用
若您的投放目标是移动应用,您需要填写该移动应用的平台类型和应用ID;
- 安卓应用ID:应用宝APPID
- iOS应用ID:APPSTORE_ID
关于可选字段和FeedBack URL的说明请见下文。
网页
若您的投放目标是通过网页实现应用下载,您需要填写网页名称和域名。
支持的域名格式为http://www.XXXXXX.cn/com,如 www.eqq.com 。注意这里不需要填写http/https的前缀。
关于可选字段和FeedBack URL的说明请见下文。
微信小游戏
若您的投放目标是微信小游戏,您需要填写小游戏的ID,如“wx***”。
关于可选字段和FeedBack URL的说明请见下文。
微信小程序/微信原生页
若您的投放目标是微信小程序/微信原生页,您无需填写落地页地址,系统会将该账户下的原生落地页的点击数据发送出。您需给此次配置的点击转发配置名称。
关于可选字段和FeedBack URL的说明请见下文。
根据业务需求选择接收的字段名称
系统会根据您选择的平台差异提供默认的字段配置方案,所有可选的字段如下表:
名称 | 描述 | 类型 |
---|---|---|
muid
|
string
|
设备id,由IMEI(Android应用)md5生成,或是由IDFA(iOS应用)md5生成; |
click_time | int | 点击发生的时间,由腾讯广告系统生成,取值为标准时间戳,秒级别 |
click_id | string | 腾讯广告后台生成的点击id,腾讯广告系统中标识用户每次点击生成的唯一标识 |
appid | string | Android应用ID为应用宝appid,iOS应用ID为Apple App Store的id |
advertiser_id | int64 | 广告主在腾讯广告(e.qq.com)的账户id |
app_type | string | app类型;取值为 android或ios(联盟Android为unionandroid);注意是小写;根据广告主在腾讯广告(e.qq.com)创建转化时提交的基本信息关联 |
android_id | string | 由android_idmd5生成,当设备id获取不到或匹配不上时,可以作为归因补充 |
ip | string | IPV4地址,当设备号获取不到或者匹配不上时,可以作为归因补充 |
user_agent | string | urlencode,当设备号获取不到或匹配不上时,可以作为归因补充 |
campaign_id | int64 | 推广计划id |
adgroup_id | int64 | 广告id |
creative_id | int64 | 创意id |
agent_id | int64 | 代理商id |
deeplink_url | string | 应用直达链接 |
dest_url | string | 落地页链接 |
device_os_type | string | 设备系统,ios、android |
click_sku_id | string | DPA商品id |
process_time | int | 请求时间 |
product_type | int | 商品类型 |
request_id | string | 请求id |
site_set | int | 广告版位id |
adgroup_name | string | 广告名称 |
oaid | string | 安卓系统移动终端补充设备标识 |
impression_id | string | 腾讯广告后台生成的曝光id,腾讯广告系统中标识用户每次曝光生成的唯一标识 |
site_set_name | int | 版位名称 |
channel_package_id | string | 渠道包id |
其中,oaid: 移动安全联盟(简称MSA)制定的匿名设备标识符,保留原始值,不需要MD5编码。具体OAID介绍以及最新覆盖厂商范围请详见MSA官网,官网链接:http://msalliance.icoc.bz/col.jsp?id=120
填写Feedback URL
Feedback URL 是由您自定义的,用于腾讯广告将点击数据传输给广告主的链接。
Feedback URL 要求:
- 可以有参数,但不能包含符号:#
- 不要占用平台可能下发的参数例如: click_time、click_id、advertiser_id等等。
- 可以用http、https
- 不能直接用ip,必须是正式的域名
示例如下:
正确:http://www.example.com/gdt.cgi
正确:http://www.example.com/gdt.cgi?source=gdt
四、联调流程介绍
配置成功后,系统会引导您进行联调。联调的目的是测试广告主是否能够接收到正确的数据,在联调之前,请根据《旧链路——点击转发API开发指南》进行开发,保证后续数据回传和返回正确值。进行联调时,需要输入对应的设备号。一般来说,系统会默认一个设备号,广告主可根据需要进行修改。如下图所示。
若联调成功,可开启转化状态;若联调失败,请通过提示框了解失败原因。一般来说,如果是feedback url填写错误,系统会提示“服务不可达”;若为字段校验错误,系统会将您返回的错误码展示在提示框中,方便您进行修改。
五、转化状态介绍
转化状态可分为启动、未启动。联调成功后您即可手动开启状态,当转化状态开启时,系统将向您发送点击行为数据。
六、点击转发的其他功能介绍
- 修改:若您需要对已有配置进行修改,可点击修改按钮。目前仅支持修改Feedback URL和配置字段,一旦配置修改提交成功,联调状态默认为未联调;转化状态为未开启。您需要重新进行联调和开启转化状态。
- 删除:您可以通过删除按钮对已有配置进行删除,一旦配置信息删除,系统将停止向您发送对应的点击行为数据。
- 详情:您可以通过详情按钮查看配置信息,并进行修改、联调或删除,如下图所示。
七、FAQ
获取点击数据后,广告主如何设置归因逻辑?
建议广告主按照如下优先级设置自己的归因逻辑:
对于Android系统:
(1)优先使用muid归因
(2)若muid归因失败,使用AndroidID归因
(3)若AndroidID归因失败,使用oaid归因
(4)若oaid归因失败,使用IP+UA归因
对于iOS系统:
(1)优先使用muid归因
(2)若muid归因失败,使用qaid_ caa归因
(3)若qaid_ caa归因失败,使用IP+UA归因
另外,若广告主希望将归因后的数据通过API接口回传给平台,请将归因成功的click_id回传到mkt api的trace_id字段中。
通过点击转发工具完成配置后,数据下发何时生效?
配置完成后,请先进行联调,当联调状态为“联调成功”时,系统会根据您配置的信息下发对应数据。
对于同一个移动应用或网页,是否可以进行多次配置?
原则上,同一个移动应用或网页不能进行多次配置,您可先删除原有配置,再重新配置;若您只需要修改配置字段,可根据上文所述进行修改。
如何基于获取到的点击下发数据,更高效地进行APP冷启动?
若您希望基于点击数据提高APP冷启动效率,除了配置推荐的字段外,您可以勾选“广告名称”字段,系统将向您下发广告对应的中文名称。您可以基于名称中带有的素材信息针对性地向用户进行推荐。