星广联投任务监测服务说明
2024-06-27 12:20:59
巨量星图平台以下简称平台
更新时间 | 更新内容 |
2024.6.27 | 更新次留回传信息，详见四、转化回传地址，次留场景 |
2024.6.5 | 新增五、转化回传地址；六、联调问题排查 |
2024.4.23 | 六、新增常见问题Q2 |
2023.12.27 | 三、更新监测宏参数CAID_MD5格式 |
2023.12.11 | 三、增加了监测宏参数CAID_MD5 |
一、适用任务类型
- •适用平台：适用于在通过巨量星图投放平台上投放的任务
- •适用任务：星广联投任务，与常规的指派任务、投稿任务、招募任务不通用
- •其余任务类型监测服务可参考如下文档：
- ◦投稿和招募按转化、付费分佣结算任务的监测服务说明：https://www.xingtu.cn/help-center/demander/109134
- ◦指派类、投稿和招募非转化/付费分佣类任务的监测服务说明：https://www.xingtu.cn/help-center/demander/109173
二、何为监测？
此处监测指客户在星图平台下单星广联投项目时，配置监测链接，通过三方监测平台，统计营销效果。监测服务旨在向客户/三方监测平台下发有效触点的用户信息，支持效果归因，不会下发诸如安装、激活等其他用户行为信息。星广联投项目中，自然流量支持点击监测，广告流量支持有效触点监测（有效触点：点击+3s播放）。客户/三方监测平台收到下发的用户信息后，可完成归因，并将转化结果回传平台，用于优化营销效果。
三、监测链接生成
- •监测链接的前缀格式为：https://XXX.XXX.com? ，域名需同时支持 ipv4 & ipv6 解析，必须支持连通（即可正常访问），不是下载链接
- •目前星图暂不支持onelink模式，采用onelink可能造成跳转失败
- •监测链接不支持串接代码
- •监测链接不能包含非法字符，非法字符包括但不限于如下列表：
序号 | 非法字符 | 字符解释 |
1 | % |
|
2 | 空格 |
|
3 | // |
|
- •“宏”参数的格式为“__参数__”（参数两边为双下划线，即参数左右两边均为两个连续的英文字符'_'），宏参数必须全大写，否则无法回传对应参数值。客户可以根据自己的需要选择具体填写哪些参数，平台支持宏参数请见下宏参数表
四、上报请求结构示例
- •通信协议
支持通过HTTPS通道进行请求通信
- •请求方法
支持HTTPS GET方法发送请求，这种方式下请求参数需要包含在请求的URL中
- •字符编码
UTF-8
- •示例
上报的结果会将监测链接中的宏参数替换为具体的用户信息
五、转化回传地址（API模式）
API模式下，广告主在收到下发的点击事件后，需要进行用户的归因。在完成归因后，广告主需要将相应的转化事件信息传递给字节，并以此计算一次转化。回传地址：
- •需将通过点击监测获取的callback_param+转化行为，回调数据回传接口，回传数据
- •callback_param 来自点击监测配置的宏参数__CALLBACK_PARAM__，callback_param 获取的结果放在以下demo中callback=xxxx的红色部分，完成回传
- •event_type=0表示激活，event_type=1表示注册，event_type=2表示付费，event_type=6表示次日留存，如需回传付费金额，需在props中增加pay_amount参数，单位为分，需通过unicode编码，如下demo为props={"pay_amount": "1000"}
# 激活场景
# 注册场景
# 付费场景
https://ad.oceanengine.com/track/activate/?callback=xxxx&event_type=2&props=%7B%22pay_amount%22:%20%221000%22%7D
# 次留场景
特别说明：为了更好的支持模型学习和支持投放效果问题排查及优化，无论您具体投放的优化目标是什么，建议您都尽可能回传包括激活、注册、付费次数、首次付费数、7日付费次数、付费金额等各漏斗转化数据。
六、联调操作步骤
1、界面操作
步骤 | 示意图 |
选择星广联投任务类型与对应要联调的组件 |  |
如任务优化目标=激活、注册、首次付费、每次付费，需勾选“数据回传联调”并选择对应转化事件 |  |
创建成功后，启动联调。若同时投放安卓和IOS，请准备2种设备类型的手机同时扫码。(投放微信小游戏/小程序仅需一台手机) |   |
扫码完成后，在抖音APP点击左下角组件后，界面上会显示点击下发次数。 点击“下载详情”可查看具体下发的点击监测信息，如：https://www.xingtu.cn/star_tools/api/monitor/debug_callback/?item_id=XXX&callback_param=XXX |   |
技术回传：
回传事件举例: 激活事件： 注册事件： 付费事件： | 完成回传后，界面上会展示回传数：  |
当安卓和IOS都联调通过后，结束联调即可 对应事件和联调id变绿表示联调通过 | 事件变绿表示该事件联调通过：  联调ID变绿，表示该联调可用于任务下单：  |
2、联调问题排查
- 1.前提：确保联调在进行中，没有被关闭
- 2.确定有点击监测下发：
- a.界面上会显示点击数、点下载详情可导出下发的具体信息
- b.需要找广告主技术排查，日志里是否有收到“下发详情”的信息。
https://xxx?&callback_param=B.Pru9oTwZ26YZc9nXYH0wAmDPL2p8QjTDlXGop4fOe10I5wBXzhuNuUJTDCS4nf1CaWKlZvPWUXmlIjv18fBcrIGpragsmHKnVshBB87KdHpvUfzfe1NZ1fHSVqtGtfG4vH
- 3.若未触发回传，需排查自归因环节，包含但不限于：
- a.IDFA、CAID、IMEI、OAID等设备号是否能正常获取
- b.使用md5加密后的设备号与星广下发的匹配，不能用原值
- 4.若已触发回传，检查回传的callback和事件类型是否正确
如上图只下发一个点击监测、联调激活时，只有用GET方法回传该callback与event_type=0才可被识别，如：
https://ad.oceanengine.com/track/activate/?callback_param=B.Pru9oTwZ26YZc9nXYH0wAmDPL2p8QjTDlXGop4fOe10I5wBXzhuNuUJTDCS4nf1CaWKlZvPWUXmlIjv18fBcrIGpragsmHKnVshBB87KdHpvUfzfe1NZ1fHSVqtGtfG4vH&event_type=0
七、监测链接的任务配置
- •以激活、注册、付费（非抖音小程序）等为考核指标的投稿任务，依赖客户回传转化数据以完成营销效果分析。在投放之前，需首先联调成功，保证监测服务、数据回传服务的通路是顺畅的，可使用新版联调工具，须注意选择星广联投项目（查看如何使用新版联调工具）。新版联调结果囊括了投放监测和数据回传，不需再创建单独的监测链接。
- •以安装完成量、APP唤起量为考核指标的投稿任务，支持手动填写监测链接、导入联调结果。
考核指标 | 监测模式 | |
安装完成量 |
 |
 |
激活、注册、付费（非抖音小程序）等 |
 | |
八、常见问题
Q1、为什么我收不到转化数据？
监测服务是平台向客户/三方监测平台下发有效触点的用户信息，支持效果归因，而不是下发转化数据。转化数据可参考平台的营销数据，深度转化目标（如激活、线索留资等）需联系监测服务提供方获取。
Q2、我应该回传哪些类型的转化数据？
为了更好的支持模型学习和支持投放效果问题排查及优化，无论您具体投放的优化目标是什么，建议您都尽可能回传包括激活、注册、付费次数、首次付费数、7日付费次数、付费金额等各漏斗转化数据。
Q3、为什么在新版联调工具中已经联调成功了，选择组件之后，还是找不到对应的联调结果？
联调时所选的任务类型必须与投放时的任务类型一致，不同任务类型之间，相同任务类型之间不同的考核目标，联调结果不能复用。
例如联调时选择了投稿/招募任务其他结算方式，但投放时选择了按激活结算，这种场景是无法选择对应的联调结果的