指派类、投稿和招募非转化/付费分佣类任务的监测服务说明
2024-03-28 18:13:07
此文档为巨量星图平台功能指导,巨量星图平台以下简称平台

更新时间:2024.3.28
更新内容:新增三、监测宏参数IPV4

更新时间:2023.09.15
更新内容:更新三、监测宏参数中的TS格式

一、适用任务类型
  • 适用平台:适用于在通过巨量星图投放平台上投放的任务
  • 适用任务指派任务、投稿任务、招募任务
  • 包括抖音指派任务、直播品牌推广任务、抖音招募任务、抖音投稿短视频/直播任务
  • 适用范围非转化结算、非付费分佣结算目标
  • 暂不适用范围
二、何为监测?
此处监测指客户在巨量星图平台下单时,配置点击监测链接,通过三方监测平台,统计营销效果。监测服务旨在向客户/三方监测平台下发组件点击的用户信息,支持效果归因,不会下发诸如安装、激活等其他用户行为信息。客户/三方监测平台收到点击用户信息后,可完成归因,并将转化结果回传平台,用于优化营销效果,整体过程见下
  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时间戳
  • 直播小手柄,豪秒级,13位数字;
  • 其余场景,秒级,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 地址,正常情况下,全量下发IPv4地址;极少数情况如IPV4无法取数,则下发 IPv6
10.110.90.58 或 240e:398:1c90:9d00:5513:b9c9:650a:d9d2

IPV6
  • 第6版网际协议
样例:240e:498:1c90:9d00:5513:b9c9:650a:d9d2
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生成出来,客户可以直接使用
IPV4
  • 第4版网际协议
四、点击上报请求结构示例
  • 通信协议
    支持通过HTTPS通道进行请求通信
  • 请求方法
    支持HTTPS GET方法发送请求,这种方式下请求参数需要包含在请求的URL中
  • 字符编码
     UTF-8
  • 示例
点击上报的结果会将监测链接中的宏参数替换为具体的用户信息
五、监测链接的任务配置
监测链接填写位置,在客户下单页面,添加组件成功后则有填入监测链接入口。
  • 如只需监测服务,不做数据回传,可直接填写监测链接。
  • 监测链接支持投前联调,即在投放前模拟视频发布过程,测试监测链接功能有效性,联调后的结果可直接导入任务,建议所有监测链接均先联调,使用说明见:联调工具使用说明
  • 也可直接填写监测链接,填写时需注意宏参设定,宏参填写错误无法完成任务提交
  • 如有数据回传,可填写转化ID(来自创建转化ID)或导入联调结果(来自新版联调工具)。转化ID和新版联调结果囊括了投放监测和数据回传,不需再创建单独的监测链接。数据回调可助力平台更精准预测用户转化率,为视频寻找更多优质流量,建议使用转化回调。
不回传转化数据,只使用监测链接
  • 直接填写监测链接,需首先添加组件
  • 从已联调的结果中导入监测链接

回传转化数据
  • 填写转化ID(来自创建转化ID),需首先添加组件
六、常见问题
Q1、为什么我收不到转化数据?
监测服务是平台向客户/三方监测平台下发组件点击的用户信息,支持效果归因,而不是下发转化数据。转化数据可参考平台的营销数据,深度转化目标(如激活、线索留资等)需联系监测服务提供方获取。

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