星图直播小手柄组件监测服务说明
2026-10-22 10:36:04
一、小手柄监测下发流程图
二、监测逻辑
1、监测事件范围
| 场景 | 图片 |
|
|  |
|
|  |
|  | |
|
| |
| ||
|
2、监测链接宏参数
通过约定指定格式的字符串，用以代表将来将要替换的字段位置，这个格式我们统称为“宏”。参数的格式为“__参数__”，详细说明参考下文。
3、游戏事件
- •游戏事件定义：
事件名称 | 事件定义 | event_type值 |
激活事件 | 用户首次打开APP | active |
付费事件 | 用户成功支付/成功退款行为 | active_pay |
- •涉及用户范围：所有归因至小手柄监测链接的转化，都应按照本文档约定回传深度事件，回传不区分是否属于商业化流量或自然流量（换句话说就是归因到通过抖音小手柄组件的转化，全部都需回传，不管是不是通过广告体系买量）
三、监测链接配置规范
1、格式
(1)监测链接的前缀格式为：https://XXX.XXX.com?
(2)“宏”参数的格式为“__参数__”，其中：
- •参数必须全部大写，小手柄支持宏参数请见下方
- •“__参数__”格式中参数两边为双下划线，即参数左右两边均为两个连续的英文字符'_'
- •客户可以根据自己的需要选择具体填写哪些参数，支持参数详见参数列表
- •监测链接支持大小写字母、数字以及下划线字符。
2、请求格式
- •通信协议：支持通过HTTPS通道进行请求通信。
- •请求方法：支持接收HTTPS GET方法请求，这种方式下请求参数需要包含在请求的URL中。
- •字符编码：UTF-8
3、说明
- •宏参数必须全大写，否则无法回传对应参数值。
- •监测链接长度大小不得超过 10K。
- •监测链接不能是下载链接。
- •监测链接必须支持连通。
- •监测链接不能包含非法字符，包括但不限于如下列表：
序号 | 非法字符 | 字符解释 |
1 | % | url path 中出现的单个的 %，后面不跟2位16进制数；转义字符中的 % 没有问题 |
2 | 空格 | url 中出现的空格 |
3 | // | url path 中出现的连续 // |
4、宏参数列表
1）指派类、投稿和招募非转化/付费分佣类任务的监测服务说明
示例：
2）投稿和招募按转化、付费分佣结算任务的监测服务说明
示例：
四、监测链接的任务配置
- •以激活、注册、线索数量（非使用橙子建站）、付费（非抖音小程序）等为考核指标的投稿任务，依赖客户回传转化数据以完成结算。在投放之前，需首先联调成功，保证监测服务、数据回传服务的通路是顺畅的。联调使用联调工具（小手柄监测、联调能力升级说明 ）
- •以安装完成量为考核指标的投稿任务，支持手动填写监测链接、导入联调结果。
考核指标 | 示例图 |
安装完成量、APP唤起量 |
 |
激活、注册、线索数量（非使用橙子建站）、付费（非抖音小程序）等 |
五、常见问题
Q1、为什么我收不到转化数据？
监测服务是平台向客户/三方监测平台下发组件点击的用户信息，支持效果归因，而不是下发转化数据。转化数据可参考平台的营销数据，深度转化目标（如激活、线索留资等）需联系监测服务提供方获取。
Q2、为什么在新版联调工具中已经联调成功了，选择组件之后，还是找不到对应的联调结果？
联调时所选的任务类型必须与投放时的任务类型一致，不同任务类型之间，相同任务类型之间不同的考核目标，联调结果不能复用。
例如联调时选择了投稿/招募任务其他结算方式，但投放时选择了按激活结算，这种场景是无法选择对应的联调结果的