使用JS实现First Promoter追踪：正式环境tid获取异常求助

云原生阿岚

2026-8-11

问题：First Promoter非测试模式下无法获取tid追踪ID

我正在开发一个基于First Promoter的页面追踪项目，需要通过链接传递访客追踪ID，并获取网站Cookie用于API请求。测试模式（带test_mode=1参数）下流程正常，但使用不带该参数的链接（如https://######.com?fpr=dee）时，无法获取API所需的tid。

现有实现代码

<!-- 测试模式链接 -->
https://######.com?fpr=testvstihyao&test_mode=1

<!-- First Promoter初始化脚本 -->
<script>(function(w){w.fpr=w.fpr||function(){w.fpr.q = w.fpr.q||[];w.fpr.q[arguments[0]=='set'?'unshift':'push'](arguments);};})(window);
fpr("init", {cid:"######"}); 
fpr("click");
</script>
<script src="https://cdn.firstpromoter.com/fpr.js" async></script>

<!-- 获取Cookie的脚本 -->
<script>
var x = document.cookie; 
window.alert(x);    
</script>

排查方向

检查Cookie的域与路径限制：First Promoter在非测试模式下写入的tid Cookie可能有严格的域名/路径规则，确认当前页面域名是否匹配Cookie的设置域，路径是否为/或当前页面路径（可通过浏览器开发者工具的Application面板查看Cookie详情）。
调整脚本执行时机：由于fpr.js是async加载，可能在你执行document.cookie时，脚本还未完成tid的写入。建议将获取Cookie的逻辑放到First Promoter的就绪回调中：
```
fpr("ready", function() {
  var x = document.cookie;
  window.alert(x);
});
```
验证初始化配置：确认init方法中的cid（客户ID）在生产环境下有效，非测试模式是否需要额外配置项，对照官方文档的生产环境初始化要求核对。
查看控制台错误：打开浏览器开发者工具的Console面板，检查是否存在First Promoter脚本加载失败、初始化报错（如CID无效、跨域限制）等问题。
确认追踪ID有效性：测试模式下的fpr参数值仅在测试环境生效，非测试模式需使用First Promoter后台生成的正式访客追踪ID，确保fpr=dee是有效的生产环境追踪ID。