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

更新时间:2022.6.8
更新内容:目录三和目录四中粉色内容有更新,更新了demo参数和新增参数ANDROIDID_MD5
更新时间:2022.6.6
更新内容:三、监测链接生成中黄色部分有更新
一、何为监测?
此处监测指客户在星图平台下单时,配置点击监测链接,通过三方监测平台,统计营销效果。监测服务旨在向客户/三方监测平台下发组件点击的用户信息,支持效果归因,不会下发诸如安装、激活等其他用户行为信息。客户/三方监测平台收到点击用户信息后,可完成归因,并将转化结果回传平台,用于优化营销效果、计费结算,整体过程见下
  1. 1.视频播放/直播开播,向用户展示组件
  1. 2.点击组件:用户产生组件点击行为
  1. 3.点击上报:根据客户配置的监测链接宏参数,平台向客户/三方监测平台上报点击的用户信息
  1. 4.用户转化:用户发生转化行为,如应用激活、线索留资等
  1. 5.客户归因:客户/三方监测平台将转化行为与监测收到的用户信息归因
  1. 6.数据回调:客户/三方监测平台将归因后的结果回传平台,优化营销效果、计费结算
二、监测范围
本标准只适用于在通过巨量星图投放平台上投放的特定投稿类任务,包括以安装完成、激活总数、线索数量为考核指标的抖音短视频投稿任务、直播投稿任务,其余投稿类任务监测模式,参照指派类任务监测服务说明。
  • 以安装完成量为考核指标的投稿任务,支持手动填写监测链接、基于转化事件的数据回调。
  • 如有数据回调,可选择转化回传,填写转化事件。转化事件的创建过程囊括了投放监测和数据回调,不需再创建单独的监测链接,可助力平台更精准预测用户转化率,为视频寻找更多优质流量,建议使用转化回调。
  • 如只需监测服务,不做数据回调,可直接填写监测链接,支持手动填写和导入监测联调后的链接。监测联调即在投放前模拟视频发布过程,测试监测链接功能有效性,联调后的结果可直接导入任务(下图,已有链接入口,支持短视频内容),建议所有监测链接均先联调,使用说明见:联调工具使用说明
  • 以激活总数、线索数量为考核指标的投稿任务,监测的过程依赖转化事件(必填),转化事件的创建过程囊括了投放监测和数据回调,不需再创建单独的监测链接,创建方式见:巨量引擎创建转化ID操作说明
考核指标
监测模式

安装完成量
填写监测链接
数据回调
激活总数、线索数量
必填转化ID
必填转化ID

注:转化事件ID必须从属于巨量引擎广告主ID,转化ID必须填写,如一端无转化ID可填0

三、监测链接生成
监测链接主要由"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
ITEM_ID
视频ID,与星图平台前端video_url中展现的视频id一致。短视频场景一个投稿对应一个视频ID;直播场景每个场次对应一个视频ID
19位数字,如 6976127045222911238
CALLBACK_PARAM
一些跟广告信息相关的回调参数,内容是一个加密字符串,在调用事件回传接口的时候会用到
样例:star-2a9c14893cc26aa006685fd1678c9cb0
CALLBACK_URL
直接把调用事件回传接口的url生成出来,客户可以直接使用
IMEI_MD5
安卓的设备 IMEI 的 MD5 摘要
假设原始的 IMEI 是 868823031739689我们最终发送的是 IMEI 的 MD5 摘要:0c2bd03c39f19845bf54ea0abafae70e。对于无法获取 IMEI 的情况,字段会置空
IDFA_MD5
iOS设备IDFA的 MD5 摘要
假设原始的 IDFA 是 4FCFEFA1-096D-4176-B352-1870ED6DB777 ,最终发送的是 IDFA_MD5 为:09c593c62a6074ae5f859e97a222c0e8 。如果用户关闭里读取idfa的权限,字段会置空
OAID_MD5
Android Q及更高版本的设备号的MD5摘要,32位 
样例:87f8274c36eb73fabcbf143a10eca6a4,对无法获取oaid的情况,字段会置空
MAC_MD5
移动设备 mac 地址MD5摘要后的结果,32位 
假设原始的mac地址是 34:d7:12:9b:3a:89,MD5摘要如下:b66376c79b93107fec01855e72f9869d,对无法获取MAC的情况,字段会置空 
ANDROIDID_MD5
Android 8及更高版本的设备标识符的MD5摘要,32位 
假设原始的ANDROIDID是 606aa265b2ae85d2,MD5摘要如下:ed1282f315ca24803e0b1e3b6213dd82,对无法获取ANDROIDID的情况,字段会置空 
四、点击上报请求结构示例
  • 通信协议
      支持通过HTTPS通道进行请求通信
  • 请求方法
      支持HTTPS GET方法发送请求,这种方式下请求参数需要包含在请求的URL中
  • 字符编码
      UTF-8
  • 示例
     点击上报的结果会将监测链接中的宏参数替换为具体的用户信息
五、常见问题
Q1、为什么我收不到转化数据?
监测服务是平台向客户/三方监测平台下发组件点击的用户信息,支持效果归因,而不是下发转化数据。转化数据可参考平台的营销数据,深度转化目标(如激活、线索留资等)需联系监测服务提供方获取。


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