接入CleverTap Web SDK时getCleverTapID返回null且事件未被后台追踪

• 检查SDK初始化时机
  CleverTap Web SDK为异步加载，直接在页面同步代码中调用clevertap.getCleverTapID()会出现SDK未完成初始化就执行调用的情况，必须将相关逻辑放到SDK就绪回调中，示例代码如下：

  clevertap.onReady = function() {
    // 所有CleverTap相关逻辑都要放在该回调内执行
    const ctId = clevertap.getCleverTapID()
    console.log(ctId)
    // 事件上报也需要在此回调内触发
  }
  

• 校验初始化参数是否正确
  核对clevertap.init()传入的Account ID、区域代码两个必填参数，确保和CleverTap后台提供的配置完全一致，参数错误会直接导致SDK初始化失败，无法生成设备ID。
• 检查浏览器存储权限限制
  CleverTap SDK依赖LocalStorage/Cookie持久化设备ID，以下场景会导致存储被拦截：
  • 浏览器开启了第三方Cookie拦截、隐私浏览模式
  • Safari浏览器开启了智能跟踪预防（ITP）功能
    可以打开浏览器开发者工具的Application面板，查看LocalStorage下是否存在CleverTapID相关的存储记录，确认存储未被拦截。
• 排查内容安全策略（CSP）拦截
  如果站点配置了CSP规则，需要确认CleverTap相关的资源域名、上报域名都已加入允许列表，CSP拦截会导致SDK资源加载失败、初始化请求被拒，控制台会输出对应CSP拦截报错，可优先查看控制台报错信息确认。
• 避免在file协议下测试
  直接打开本地HTML文件使用file://协议测试时，SDK无法正常读写本地存储，一定会出现ID返回null的问题，需要搭建本地静态服务，使用http://localhost或http://127.0.0.1域名测试。

内容的提问来源于stack exchange，提问作者shashi_coder