此文档为巨量星图平台功能指导,巨量星图平台以下简称平台

更新时间:2022.6.8
更新内容:四、点击上报请求结构示例中粉色内容有更新(demo参数更新)
更新时间:2022.6.6
更新内容:三、监测链接生成中黄色部分有更新
一、何为监测?
此处监测指客户在巨量星图平台下单时,配置点击监测链接,通过三方监测平台,统计营销效果。监测服务旨在向客户/三方监测平台下发组件点击的用户信息,支持效果归因,不会下发诸如安装、激活等其他用户行为信息。客户/三方监测平台收到点击用户信息后,可完成归因,并将转化结果回传平台,用于优化营销效果,整体过程见下
  1. 1.视频播放/直播开播,向用户展示组件
  1. 2.点击组件:用户产生组件点击行为
  1. 3.点击上报:根据客户配置的监测链接宏参数,平台向客户/三方监测平台上报点击的用户信息
  1. 4.用户转化:用户发生转化行为,如应用激活、线索留资等
  1. 5.客户归因:客户/三方监测平台将转化行为与监测收到的用户信息归因
  1. 6.数据回调:客户/三方监测平台将归因后的结果回传平台,优化营销效果
二、监测范围
  • 本标准只适用于在通过巨量星图投放平台上投放的传播类任务,包括抖音传播任务、直播品牌推广任务。监测链接填写位置,在客户下单页面,添加组件成功后则有填入监测链接入口。
  • 如有数据回调,可选择转化回传,填写转化事件。转化事件的创建过程囊括了投放监测和数据回调,不需再创建单独的监测链接,创建方式见:指派任务支持转化数据回传数据回调可助力平台更精准预测用户转化率,为视频寻找更多优质流量,建议使用转化回调。
  • 如只需监测服务,不做数据回调,可直接填写监测链接。
  • 监测链接支持投前联调,即在投放前模拟视频发布过程,测试监测链接功能有效性,联调后的结果可直接导入任务(下图,已有链接入口,支持短视频内容),建议所有监测链接均先联调,使用说明见:联调工具使用说明
  • 也可直接填写监测链接,填写时需注意宏参设定,宏参填写错误无法完成任务提交
抖音传播任务
直播品牌推广任务
  • 填写转化事件,支持数据回调。转化事件的创建过程囊括了投放监测和数据回调,不需再创建单独的监测链接
  • 直接填写监测链接,支持导入和手动填写
  • 填写转化事件,支持数据回调。转化事件的创建过程囊括了投放监测和数据回调,不需再创建单独的监测链接
  • 直接填写监测链接
注:直播场景添加组件之后,需添加达人,之后才可看到填写监测链接入口
三、监测链接生成
监测链接主要由"https://XXXX.XXX.com?"+"参数"+其他部分组成,且总大小不得超过10K。其中指定指定格式的字符串,用以代表将要替换的字段位置,统称为“宏”。相关要求如下:
  • 监测链接的前缀格式为: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 段点分) 
例如:10.110.90.58 
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、为什么我收不到转化数据?
监测服务是平台向客户/三方监测平台下发组件点击的用户信息,支持效果归因,而不是下发转化数据。转化数据可参考平台的营销数据,深度转化目标(如激活、线索留资等)需联系监测服务提供方获取。

星图首页星图帮助中心-客户星图帮助中心-达人星图帮助中心-mcn星图帮助中心-服务商