点击与转化
S2S 转化回传配置与验证
理解 Postback URL、映射点击 ID 与合作平台宏,验证转化并排查缺失或重复通知。
Postback URL 是什么?
Postback URL 是一个服务器向另一个服务器报告事件的接口。在 Nevect 的 S2S 转化追踪流程中,联盟网络或 Offer 将转化通知发送到追踪实例的 Postback URL。Nevect 使用返回的点击 ID,把转化匹配到已经记录的访问。
这是传入回传。传出回传则由 Nevect 向流量源报告转化,使用流量源自己的 external click ID。两个方向需要分别配置和验证。
配置前提
你需要一个可用的广告活动、能够接收 sub-ID 的 Offer,以及能够在服务器通知中返回该值的合作平台。先验证一次可控点击,并在隔离测试时关闭向流量源的传出回传。
| 标识 | 由谁生成 | 传递方向 |
|---|---|---|
| External click ID | 流量源 | 进入 Nevect,之后回传给流量源 |
| Tracker click ID | Nevect | 传给 Offer,再作为 cnv_id 返回 Nevect |
| 合作平台交易 ID | Offer 或联盟网络 | 合作平台的交易参考号,不能替代 cnv_id |
合作平台宏与 Nevect Token 由不同系统展开,必须分别从对应编辑器复制准确语法。
1. 将追踪点击 ID 传给 Offer
在 Offers 中编辑目标 URL,把 {clickid} 放入合作平台支持的 sub-ID 参数。例如,对方支持 sub1 时:
保存的 Offer URL:
https://offer.example/landing?sub1={clickid}
访问后目标 URL 的示意:
https://offer.example/landing?sub1=NV_CLICK_001
NV_CLICK_001 只是示意,不是可用的测试点击。测试时使用自己实例产生的真实 ID。原链接已有查询参数时,应使用 & 追加,不能再加一个 ?。检查重定向后的最终目标:合作平台需要收到实际值,而不是字面量 {clickid}。
2. 从 Nevect 复制传入地址
打开 Settings → Tracking links,复制面板生成的 Postback URL。使用当前实例及其可达追踪域名对应的地址,保留生成的路径。不要用广告活动链接、官网账户地址或其他追踪器的接口替代。
设置页同时提供基础转化地址与带状态参数的地址,根据需要上报的数据选择。
3. 映射合作平台的返回宏
在合作平台的 Postback 配置中,将点击 ID 占位符替换为能够返回所保存 sub-ID 的宏。例如,对方文档明确支持 {sub1} 与 {payout} 时,参数映射可写为:
cnv_id={sub1}&payout={payout}
这里的宏只是合作平台语法示例,不能在不同联盟网络之间直接照搬。保存前核对对方当前的参数名、宏语法和支持的通知事件。
| 参数 | 应提供的值 | 核对重点 |
|---|---|---|
cnv_id |
合作平台返回的 Nevect 点击 ID | 必须匹配已有访问,不能使用流量源 external ID |
payout |
数字形式的转化收入,例如 1.50 |
使用正确的小数格式,不带货币符号 |
cnv_currency |
需要时填写收入货币,例如 USD |
必须与所发送收入金额的货币一致 |
cnv_status / cnv_status2 |
合作平台实际发送的状态 | 与回传处理方案匹配 |
disable_postback=1 |
禁止该请求触发向流量源的传出回传 | 用于隔离验证请求 |
disable_upsell=1 |
不将该请求的收入累加到已有总额 | 先检查 Offer 的 Upsell 与重复通知策略 |
配置状态时,要确保处理规则会接受测试值。通知到达服务器,不等于已经计入一次转化。
4. 验证一次可控转化
- 打开测试 Campaign URL 一次,在 Clicklog 中找到这次访问。
- 确认 Offer URL 将同一个 Nevect 点击 ID 传给合作平台。
- 复制面板生成的传入 Postback URL,把其中点击 ID 和收入占位符替换为此次真实点击 ID 与已知测试金额。
- 隔离请求中添加
disable_postback=1。只使用处理方案已经配置接受的测试状态;不需要状态时使用基础地址。 - 打开测试 URL 一次,再在对应活动和时间范围内检查 Clicklog 与 Conversions。
- 核对点击关联、收入、货币和状态,然后单独检查相关报表。
例如,展开后的查询字段可能为:
cnv_id=ACTUAL_TEST_CLICK_ID&payout=1.50&cnv_currency=USD&disable_postback=1
将这些字段用于面板生成的接口,替换原占位符,不能重复添加 cnv_id 或 payout。仅收到 HTTP 200,不能证明归因正确。
重复通知、延迟与状态变化
联盟网络可能对同一个点击先发送待审核线索,再发送通过和后续修正。启用前先确定哪些通知应计为转化、收入应如何变化,并检查 Offer 的 Upsell 设置及所选处理方案。不要假设重复通知一定无影响,也不能把每次状态变化都视为新成交。
与合作平台对账时,比较同一个点击、通知时间、时区与状态策略。转化晚于原始访问到达时,不同报表范围下的结果可能不同。
常见错误
| 现象 | 检查位置 | 修复目标 |
|---|---|---|
| 目标或回调里仍有花括号 | 哪个系统负责展开宏 | 改为该系统支持的准确语法 |
| 找不到点击或点击 ID 为空 | cnv_id 与原始访问 |
完整返回 Nevect 已记录的 ID |
| HTTP 成功但没有接受转化 | 状态方案、重复策略与报表筛选 | 先找到点击级处理结果,再调整汇总 |
| 收入错误 | 展开后的 payout、currency 与 Upsell | 修正输入或规则后,用隔离点击验证 |
| Nevect 有转化,流量源没有 | External ID 与传出地址 | 按单独的流量源回传教程排查 |