传播任务监测服务
2022-08-22 17:21:24
此文档为巨量星图平台功能指导，巨量星图平台以下简称平台
更新时间：2022.6.8
更新内容：四、点击上报请求结构示例中粉色内容有更新（demo参数更新）
更新时间：2022.6.6
更新内容：三、监测链接生成中黄色部分有更新
一、何为监测？
此处监测指客户在巨量星图平台下单时，配置点击监测链接，通过三方监测平台，统计营销效果。监测服务旨在向客户/三方监测平台下发组件点击的用户信息，支持效果归因，不会下发诸如安装、激活等其他用户行为信息。客户/三方监测平台收到点击用户信息后，可完成归因，并将转化结果回传平台，用于优化营销效果，整体过程见下
二、监测范围
- 本标准只适用于在通过巨量星图投放平台上投放的传播类任务，包括抖音传播任务、直播品牌推广任务。监测链接填写位置，在客户下单页面，添加组件成功后则有填入监测链接入口。
- •如有数据回调，可选择转化回传，填写转化事件。转化事件的创建过程囊括了投放监测和数据回调，不需再创建单独的监测链接，创建方式见：指派任务支持转化数据回传。数据回调可助力平台更精准预测用户转化率，为视频寻找更多优质流量，建议使用转化回调。
- •如只需监测服务，不做数据回调，可直接填写监测链接。
- ◦监测链接支持投前联调，即在投放前模拟视频发布过程，测试监测链接功能有效性，联调后的结果可直接导入任务（下图，已有链接入口，支持短视频内容），建议所有监测链接均先联调，使用说明见：联调工具使用说明
- ◦也可直接填写监测链接，填写时需注意宏参设定，宏参填写错误无法完成任务提交
抖音传播任务 | 直播品牌推广任务 |
  |
 注：直播场景添加组件之后，需添加达人，之后才可看到填写监测链接入口 |
三、监测链接生成
- •监测链接的前缀格式为：https://XXX.XXX.com? ，域名需同时支持 ipv4 & ipv6 解析，必须支持连通（即可正常访问），不能是下载链接
- •监测链接不支持串接代码
- •监测链接不能包含非法字符，非法字符包括但不限于如下列表：
序号 | 非法字符 | 字符解释 |
1 | % | url path 中出现的单个的 %，后面不跟2位16进制数；转义字符中的 % 没有问题 |
2 | 空格 | url 中出现的空格 |
3 | // | url path 中出现的连续 // |
- •“宏”参数的格式为“__参数__”（参数两边为双下划线，即参数左右两边均为两个连续的英文字符'_'），宏参数必须全大写，否则无法回传对应参数值。客户可以根据自己的需要选择具体填写哪些参数，平台支持宏参数请见下宏参数表
参数 | 描述 | 格式 |
TS | unix时间戳 | 10位数字，秒级别； |
OS | 客户端操作系统的类型 | 0–Android 1–iOS 2– WP 3- Others |
UA | User_Agent | 例如：Mozilla/5.0 (Linux; Android 9; SM-G9750 Build/PPR1.180610.011; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/62.0.3202.84 Mobile Safari/537.36 |
IP | 媒体投放系统获取的用户终端的公共 IP 地址 | A.B.C.D（4 段点分） |
MODEL | 手机型号代码 | 样例：iPad11,3 |
DEMAND_ID | 计划ID，一次营销活动生成一个计划ID | 19位数字，如 6966874113549795332 |
ORDER_ID | 任务ID，标识一次达人投稿活动 | 19位数字，如 6966874119816085598 |
ITEM_ID | 视频ID，与星图平台前端video_url中展现的视频id一致。短视频场景一个投稿对应一个视频ID；直播场景每个场次对应一个视频ID | 19位数字，如 6976127045222911238 |
CALLBACK_PARAM | 一些跟广告信息相关的回调参数，内容是一个加密字符串，在调用事件回传接口的时候会用到 | 样例：star-2a9c14893cc26aa006685fd1678c9cb0 |
CALLBACK_URL | 直接把调用事件回传接口的url生成出来，客户可以直接使用 |
四、点击上报请求结构示例
- •通信协议
支持通过HTTPS通道进行请求通信
- •请求方法
支持HTTPS GET方法发送请求，这种方式下请求参数需要包含在请求的URL中
- •字符编码
UTF-8
- •示例
点击上报的结果会将监测链接中的宏参数替换为具体的用户信息
五、常见问题
Q1、为什么我收不到转化数据？