treg广告转化追踪adsconv架构捕获、outbox与上传全链路【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/tregtreg是一个面向 AI Agent 的工具代理平台OpenRouter for agent tools而它的广告转化追踪adsconv模块用一条捕获 → 存储 → 触发 → 上传的链路把 Google Ads 的广告点击与用户注册、首次调用、首次充值这三个关键转化事件关联起来。本文用通俗的方式带你走完全链路理解它如何做到一个转化都不丢。为什么需要服务端的广告转化追踪大多数网站用一段 JS 打点就能看到转化但 treg 的用户大量使用CLI 和 MCP 客户端发起调用——没有浏览器打点脚本根本看不到首次调用这个动作。而且转化数据直接喂给 Google 的出价算法丢一条转化 出价被低估的数据训练广告效果会被悄悄拖垮。所以 treg 选择了服务端上传方案事件发生时先写进数据库的 outbox发件箱表再由后台 worker 异步上传给 Google。请求路径永远不等 Google 的响应。第一步捕获广告点击gclid → 本地 Cookie用户点击 Google 广告后URL 上会带一个点击 IDgclidiOS 流量则换成gbraid/wbraid。treg 在首页等营销页面加载了一段仅约 30 行的第一方脚本src/treg/web/adtrack.js从 URL 读取点击 ID 和落地页标识utm_content/ref写进一个90 天有效期的treg_adCookie90 天 Google 的点击归因窗口不加载任何 Google 脚本不发任何第三方请求 细节gclid、gbraid、wbraid三个字段在上传 API 里互不通用所以 Cookie 里连字段名一起存gclid|...避免把 braid 值误当成 GCLID 导致上传失败。第二步注册时把点击信息落到团队Org上用户带着 Cookie 完成注册服务端的 src/treg/application/signup.py 在注册入口register_user和create_org两道门解析 Cookie把点击信息持久化到新团队的四个字段上字段用途ad_gclid点击 ID随团队长期保留ad_click_at点击时间保证上传落在 90 天窗口内ad_landing落地页用于分页面分析first_call_at首次调用时间也是只触发一次的守卫归因规则是首个带来注册的点击——一旦写入就不再覆盖避免被后来的自然流量洗掉广告功劳。第三步三个关键时刻写入 outbox当用户完成以下任一动作对应咽喉点会调用 src/treg/adsconv.py 里的queue()写一行AdConversion记录signup注册→ 注册赠送逻辑中触发作为次要转化不用于出价first_call首次成功调用→/call/返回成功时触发主要出价目标paid首次充值→ src/treg/billing.py 到账时触发主要出价目标带充值金额AdConversion表定义在 src/treg/models.py关键设计有两点持久化写入outbox 行在事件同一个数据库事务里提交事件和转化要么一起成功、要么一起失败paid是已记录在案的例外详见架构文档天然幂等(org_id, action)上的唯一约束让重复的注册重试、Stripe 重复 Webhook 直接撞约束被吸收不会重复计数它刻意不经过audit.py/analytics.py——那两个模块在流量高峰会主动丢弃行对图表无害对转化却是致命的少计。第四步后台 worker 把 outbox 上传给 Googleadsconv.worker每300 秒扫描一次到期的未上传行未上传、未终态、距点击已超6 小时、过了重试时间批量 POST 给 Google Data Manager API6 小时延迟点击 ID 在点击后数小时内才被 Google 接受太早上传会被拒——延迟 指数退避5 分钟起步、24 小时封顶、最多 8 次把被拒即丢变成几小时后再发永久失败不无限重试点击过期、ID 非法的行标记为死信failed_at 错误码保留可查凭证独立上传器使用 treg 自己的平台级 refresh token模块级缓存 access token到期前 60 秒才换新与客户连接自己的 Google Ads 账户是完全隔离的两条凭证路径金额换算充值金额以整型微美元存储上传时按固定汇率1 AUD 0.70 USD换算——汇率写死是为了让 ROAS 波动只反映业务变化而不是汇率波动全链路一图流广告点击 ──► 落地页 ──► treg_ad Cookie ──► 注册 ──► Org.ad_gclid │ 注册 ─┐ │ 首次调用 ──┼──► AdConversion outbox ──► 后台 worker ──► Google 上传 首次充值 ─┘ (uploaded_at NULL) (每300s排空)延伸阅读关键文件路径核心实现汇率、outbox 写入、上传 workersrc/treg/adsconv.py前端捕获脚本src/treg/web/adtrack.js注册归因读取src/treg/application/signup.py数据模型AdConversion表src/treg/models.py架构文档原子性取舍、幂等、鉴权docs/context/architecture/ads-conversions.md设计文档问题、决策、验证步骤docs/superpowers/specs/2026-08-17-ads-conversion-tracking-design.md测试用例FX、去重、上传、死信tests/test_adsconv.py这套捕获 → outbox → 上传的链路本质是把营销数据当成钱一样对待写入必须持久、上传可以异步、失败必须可见。对任何需要把后端事件而不是浏览器打点归因到广告点击的产品都是一个值得抄的完整范式。【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考