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

更新时间
更新内容
2023.09.07
更新三、监测宏参数中的IP地址
2023.09.15
更新三、监测宏参数中的TS格式
2023.12.11
三、增加了监测宏参数CAID_MD5
2023.12.27
三、更新监测宏参数CAID_MD5格式
2024.1.3
三、增加了监测宏参数AWEME_AUTHOR_ID
2024.3.28
三、增加了监测宏参数 IPV4
一、适用任务类型
  • 适用平台:适用于在通过巨量星图投放平台上投放的任务
  • 适用任务投稿任务、招募任务
  • 包括短视频、直播
  • 适用范围按转化结算、按付费分佣结算目标
  • 暂不适用范围
二、何为监测?
此处监测指客户在星图平台下单时,配置点击监测链接,通过三方监测平台,统计营销效果。监测服务旨在向客户/三方监测平台下发组件点击的用户信息,支持效果归因,不会下发诸如安装、激活等其他用户行为信息客户/三方监测平台收到点击用户信息后,可完成归因,并将转化结果回传平台,用于优化营销效果、计费结算,整体过程见下

  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生成出来,客户可以直接使用
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的情况,字段会置空 
CAID_MD5

  • 中国广告协会互联网广告标识,json格式,包含CAID的版本和MD5摘要
[{"caid_md5":"912ec803b2ce49e4a541068d495ab570","version":"20230330"},{"caid_md5":"e332a76c29654fcb7f6e6b31ced090c7","version":"20220111"}]
AWEME_AUTHOR_ID
  • 达人信息,用抖音uid代替,明文;可在达人广场手动查昵称
样例:3109034613271234
IPV4
  • 第4版网际协议
四、点击上报请求结构示例
  • 通信协议
    支持通过HTTPS通道进行请求通信
  • 请求方法
    支持HTTPS GET方法发送请求,这种方式下请求参数需要包含在请求的URL中
  • 字符编码
     UTF-8
  • 示例
点击上报的结果会将监测链接中的宏参数替换为具体的用户信息
五、监测链接的任务配置
  • 以激活、注册、线索数量(非使用橙子建站)、付费(非抖音小程序)等为考核指标的投稿任务,依赖客户回传转化数据以完成结算。在投放之前,需首先联调成功,保证监测服务、数据回传服务的通路是顺畅的。联调可采用转化ID(查看如何创建转化ID)、新版联调工具(查看如何使用新版联调工具)。转化ID和新版联调结果囊括了投放监测和数据回传,不需再创建单独的监测链接。
  • 以安装完成量、APP唤起量为考核指标的投稿任务,支持手动填写监测链接、导入联调结果。
考核指标
监测模式

安装完成量、APP唤起量
  • 填写监测链接
  • 导入联调结果
激活、注册、线索数量(非使用橙子建站)、付费(非抖音小程序)等

  • 填写转化ID(来自创建转化ID),需首先添加组件

注:必须为投稿和招募按转化、付费分佣结算的联调结果,且结果中必须包括结算目标
六、常见问题
Q1、为什么我收不到转化数据?
监测服务是平台向客户/三方监测平台下发组件点击的用户信息,支持效果归因,而不是下发转化数据。转化数据可参考平台的营销数据,深度转化目标(如激活、线索留资等)需联系监测服务提供方获取。
Q2、为什么在新版联调工具中已经联调成功了,选择组件之后,还是找不到对应的联调结果?
联调时所选的任务类型必须与投放时的任务类型一致,不同任务类型之间,相同任务类型之间不同的考核目标,联调结果不能复用。
例如联调时选择了投稿/招募任务其他结算方式,但投放时选择了按激活结算,这种场景是无法选择对应的联调结果的

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