该技能用于处理 treg 自身的广告转化跟踪,涉及广告点击捕获、AdConversion 发件箱和 Data Manager 上传器。treg 会针对产生转化的广告点击记录三种转化:注册、首次成功调用、首次充值。点击 id 先存入第一方 cookie,再持久化到 Org,随后由三个服务端关键点写入 AdConversion 发件箱,并由后台 worker 上传到 Google Data Manager API。
核心规则:某一层只有在生产环境中观察到该层的真实数据时才算通过验证,mock、dry run、状态码或代理报告都不算。验证阶梯依次为:脚本已被提供、每个广告落地页都加载它、点击到达数据库、关键点触发、上传被接受、Google 已处理、归因到真实点击;前六层可免费验证,第七层需要一次真实广告点击。
免费且最有效的检查包括:用 curl -s https://treg.to/adtrack.js | wc -c 判断捕获是否开启(0 表示功能开关关闭);检查各目标页是否加载 adtrack.js;用带 Cookie 的 POST 请求走完整链路,再查询 org 与 adconversion 表。
已知陷阱:validateOnly 不会应用所有规则,dry run 可能对真实摄取会拒绝的负载返回 200;数字型 transactionId 会被拒绝,需要加前缀;时间列是 TIMESTAMP WITHOUT TIME ZONE,应使用 models._now / api._utcnow_naive;上传器使用平台刷新令牌,不要向 GOOGLE_ADS 添加 auth/datamanager;不要让转化经过 audit.py 或 analytics.py;不要让任何操作触碰请求的事务;首次调用判定基于 HTTP 状态码,且会漏掉 treg cli run / treg with。
修改上传器时应先阅读 docs/context/architecture/ads-conversions.md,只改 src/treg/adsconv.py,金额保持整数微美元,并在 JSON 边界做唯一一次浮点转换,aud_micro = usd_micro * 10 // 7。需添加移除功能后会失败的测试,然后按验证阶梯逐层确认。官方未提供的细节暂未提供。