OpenAI广告转化埋点
给出仓库和要埋的转化事件,产出浏览器 Pixel 与服务端 CAPI 的转化追踪改动,含 event_id 去重和密钥不落代码。
功能与用途
要统计广告带来的下单、注册、留资这些转化,就得在仓库里同时埋浏览器 Pixel 和服务端 CAPI,还要保证两边事件能去重、密钥不进前端包。这个能力先摸清仓库的框架、包管理器、路由和已有分析埋点,再定好像素 ID、event_id 与 oppref 策略,只埋能确认成功路径的事件,改动尽量小、便于评审。转化上报被包在非阻塞边界里,即使埋点代码抛错也不会拖垮下单或注册流程。
适用场景
- 电商加购与下单转化埋点:在网页端和后端接口中接入加购与支付事件,实现双端 event_id 去重与归因参数传递。
- 纯后端服务转化上报:针对无前端页面的注册或充值系统,仅通过 CAPI 上报转化并严格隔离 API 密钥。
- 现有广告追踪代码审查:排查工程中已有的埋点实现,检查是否泄露密钥、事件触发是否阻塞主业务流程。
适用人群
- 投放广告的电商站点前端工程师
- 负责增长埋点的全栈开发
- 做 PR 评审的技术负责人
使用步骤
- 先交代输入:埋点模式是 pixel、capi 还是 pixel+capi,前后端形态,像素 ID,密钥管理方式,要埋的转化事件和它们在产品流程里的位置。
- 让 AI 扫仓库:识别框架、包管理器、路由、服务端运行时、已有分析集成和密钥获取方式。
- 确认方案:确定唯一初始化点、服务端执行点、event_id 去重策略和 source_url 与 oppref 的取值策略。
- 落地最小改动:只埋高置信度的转化事件,被跳过的事件逐条说明原因,密钥只走服务端环境变量或密钥管理。
- 本地跑类型检查、lint 和单测验证,并确认埋点失败不会阻塞核心业务路径。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 商业运营
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- main
- 最近更新
- 2026-09-18
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Guide Codex through instrumenting or extending repositories with OpenAI Ads Measurement Pixel and optional Conversions API (CAPI). Use when adding Ads conversion tracking, browser pixel events, server-side conversion events, event_id deduplication, CAPI secret placeholders, incremental conversion coverage, or validating Ads conversion setup. Applies to local repositories and PR review contexts; prioritize safe, reviewable diffs and never place API keys or secrets in source code or client bundles.
使用前准备
- 需要一个可编辑的广告主仓库,并了解其框架与密钥管理方式
- 实现细节需对照 OpenAI Ads 官方文档(测量像素、Conversions API、支持事件)确认。
依赖与权限
- 读取用户主动提供的内容