指派类、投稿和招募非转化/付费分佣类任务的监测服务说明
2024-12-12 19:04:35
此文档为巨量星图平台功能指导，巨量星图平台以下简称平台
更新时间：2024.12.12
更新内容：新增三、监测宏参数AWEME_AUTHOR_ID
更新时间：2024.3.28
更新内容：新增三、监测宏参数IPV4
一、适用任务类型
- •适用平台：适用于在通过巨量星图投放平台上投放的任务
- •适用任务：指派任务、投稿任务、招募任务
- ◦包括抖音指派任务、直播品牌推广任务、抖音招募任务、抖音投稿短视频/直播任务
- •适用范围：非转化结算、非付费分佣结算目标
- •暂不适用范围：
- ◦按转化结算、按付费分佣结算类任务，此类任务监测服务说明请参考：https://www.xingtu.cn/help-center/demander/109134
二、何为监测？
此处监测指客户在巨量星图平台下单时，配置点击监测链接，通过三方监测平台，统计营销效果。监测服务旨在向客户/三方监测平台下发组件点击的用户信息，支持效果归因，不会下发诸如安装、激活等其他用户行为信息。客户/三方监测平台收到点击用户信息后，可完成归因，并将转化结果回传平台，用于优化营销效果，整体过程见下
- 1.视频播放/直播开播，向用户展示组件
- 2.组件点击：用户产生组件点击行为
- 3.点击上报：根据客户配置的监测链接宏参数，平台向客户/三方监测平台上报点击的用户信息
- 4.用户转化：用户发生转化行为，如应用激活、线索留资等
- 5.客户归因：客户/三方监测平台将转化行为与监测收到的用户信息归因
- 6.数据回调：客户/三方监测平台将归因后的结果回传平台，优化营销效果
三、监测链接生成
- •监测链接的前缀格式为：https://XXX.XXX.com? ，域名需同时支持 ipv4 & ipv6 解析，必须支持连通（即可正常访问），不能是下载链接
- •监测链接不支持串接代码
- •监测链接不能包含非法字符，非法字符包括但不限于如下列表：
序号 | 非法字符 | 字符解释 |
1 | % | url path 中出现的单个的 %，后面不跟2位16进制数；转义字符中的 % 没有问题 |
2 | 空格 | url 中出现的空格 |
3 | // | url path 中出现的连续 // |
- •“宏”参数的格式为“__参数__”（参数两边为双下划线，即参数左右两边均为两个连续的英文字符'_'），宏参数必须全大写，否则无法回传对应参数值。客户可以根据自己的需要选择具体填写哪些参数，平台支持宏参数请见下宏参数表
四、点击上报请求结构示例
- •通信协议
支持通过HTTPS通道进行请求通信
- •请求方法
支持HTTPS GET方法发送请求，这种方式下请求参数需要包含在请求的URL中
- •字符编码
UTF-8
- •示例
点击上报的结果会将监测链接中的宏参数替换为具体的用户信息
五、监测链接的任务配置
监测链接填写位置，在客户下单页面，添加组件成功后则有填入监测链接入口。
- •如只需监测服务，不做数据回传，可直接填写监测链接。
- ◦监测链接支持投前联调，即在投放前模拟视频发布过程，测试监测链接功能有效性，联调后的结果可直接导入任务，建议所有监测链接均先联调，使用说明见：联调工具使用说明
- ◦也可直接填写监测链接，填写时需注意宏参设定，宏参填写错误无法完成任务提交
六、常见问题
Q1、为什么我收不到转化数据？
监测服务是平台向客户/三方监测平台下发组件点击的用户信息，支持效果归因，而不是下发转化数据。转化数据可参考平台的营销数据，深度转化目标（如激活、线索留资等）需联系监测服务提供方获取。