Nevect

点击与转化

S2S 转化回传配置与验证

理解 Postback URL、映射点击 ID 与合作平台宏,验证转化并排查缺失或重复通知。

适用 Nevect 1.0.6 · 更新于

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. 验证一次可控转化

  1. 打开测试 Campaign URL 一次,在 Clicklog 中找到这次访问。
  2. 确认 Offer URL 将同一个 Nevect 点击 ID 传给合作平台。
  3. 复制面板生成的传入 Postback URL,把其中点击 ID 和收入占位符替换为此次真实点击 ID 与已知测试金额。
  4. 隔离请求中添加 disable_postback=1。只使用处理方案已经配置接受的测试状态;不需要状态时使用基础地址。
  5. 打开测试 URL 一次,再在对应活动和时间范围内检查 Clicklog 与 Conversions。
  6. 核对点击关联、收入、货币和状态,然后单独检查相关报表。

例如,展开后的查询字段可能为:

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 与传出地址 按单独的流量源回传教程排查

浏览器上报方式见转化像素。传入验证正确后,再配置向流量源传出回传。

准备将 Nevect 用于投放?可查看追踪工作流程与当前授权套餐。