调试与验证

端到端验证#

1. 用广告系列的 URL 打开落地页

   请使用 Moclick 提供的跟踪链接，或带有标记参数的落地 URL，这样这次测试才会被当作已跟踪流量。参见 给落地 URL 打标记。

2. 确认代码已加载

   DevTools → Network，过滤 moclick。代码的请求应返回 200 或 304。

3. 确认广告系列配置

   配置请求应返回 200，并且广告系列已被识别。广告系列不存在或已取消发布时会返回中性响应， 代码随即结束、不做任何动作。

4. 检查 cookie

   DevTools → Application → Cookies。核对名称、域名和有效期。参见 写入的 cookie。

5. 走完整流程直到确认页

   下一笔真实的测试订单。不要用模拟的确认页——目的正是验证平台是否正确填入了金额和标识符。

6. 检查转化记录

   Network 中应出现转化请求。在 POST 中参数位于请求体而不是 URL 里——请打开 Payload 标签页。

7. 在后台面板中确认

   在广告系列 → 结果中，测试转化应出现在「最近转化」里。 这是唯一的最终判定标准——Network 中的成功响应并不保证已写入。

转化请求中需要核对的参数#

在控制台中检查#

// 配置加载成功了吗？
window.MoclickConfig

// 转化对象是否存在且格式正确？
window.MoclickConversion

// 存在哪些 Moclick 的 cookie？
document.cookie.split("; ").filter(c => c.indexOf("moclick") === 0)

// 清除本地标记以便重复测试
Object.keys(localStorage)
  .filter(k => k.indexOf("moclick_") === 0)
  .forEach(k => localStorage.removeItem(k));
sessionStorage.clear();

问题诊断#

完全看不到转化请求#

• 全局代码在本页上加载了——而不只是在之前的页面上
• window.MoclickConversion 存在且是一个对象
• 该对象是在代码加载后的 120 秒内定义的
• 配置请求中广告系列已被识别
• 点击识别 cookie 存在
• 不存在已用同一个 transaction_id 记录过的转化

请求发出去了，但后台面板不显示#

• 该广告系列使用平台自有测量——请与 Moclick 团队确认
• 请求中 click_id 不为空
• 测试所用的 UA 未被判定为机器人——命令行工具会被过滤掉
• 筛选的时间范围包含测试发生的时刻
• 广告系列或来源筛选没有把该事件排除掉
• 它不是已记录事件的重复项

转化金额不对#

转化重复#

• 检查 transaction_id 是否真的按订单唯一
• 用时间戳或随机数作标识符，每刷新一次就会产生一条重复
• 确认转化代码没有在代码管理器的多个触发器上触发
• 如果同时使用 S2S 回传和转化对象，请保证两边的 txid 一致——这样去重才会把它们识别为同一个事件

上线检查清单#

• 全局代码已安装在所有页面上，包括确认页
• 广告系列标识符已核对，且与代码中的一致
• 确认页上已放置转化对象
• transaction_id 按订单唯一且稳定
• 金额使用点号小数点、不带货币符号、量级正确
• 已在真实环境中完成一次测试转化
• 测试转化已在结果后台面板中得到确认
• 已在正确的域名和子域名下核对 cookie
• 控制台中没有 JavaScript 报错
• 若使用 S2S 回传：token 保存在服务器上，且已实现重发队列
• 广告主的隐私政策已更新，列出所使用的 cookie