🎯 OpenAI Ads 回传接入指南
从后台创建 Pixel、转化事件，到网站安装、验证和广告系列绑定，一步一步完成
第一阶段 · 后台配置
先在投放系统完成关联配置
下面 4 项是一次性的后台准备工作，不是代码生成器的交互步骤。首次接入时依次完成；已经配置好的客户可以直接进入第二阶段。
1创建 Pixel确定数据归属账户
2复制安装代码获得 Pixel ID 和初始化脚本
3创建转化事件把原始事件定义为转化目标
4绑定广告系列让报表和优化真正使用该事件
关键区别：网站发送
后台已配置好，进入第二阶段 ↓
order_created 只是“上报一条原始事件”；在系统中创建转化事件，是告诉平台“这类事件要算转化”；把它绑定到广告系列，才会进入该广告系列的转化统计和优化。首次接入：展开后台配置步骤、截图和检查表
第 1 步：创建 Pixel
- 登录 TecGPT Ads Manager，进入 资产设置 → Pixel。
- 点击右上角 创建 Pixel。
- 选择客户的广告账户，填写便于识别的名称，例如“官网 Pixel”。
- Client Type 当前选择 Web，然后提交。
| 字段 | 怎么填 | 为什么 |
|---|---|---|
| 归属账户 | 选择实际投放的客户广告账户 | Pixel、转化事件和 Campaign 必须属于同一个账户 |
| Pixel 名称 | 建议“站点/业务 + Pixel”，如“美国官网 Pixel” | 后续创建转化事件时更容易选对 |
| Client Type | Web | 表示该 Pixel 用于网页事件 |
截图 1：资产设置 → Pixel → 创建 Pixel（截图中的数据仅作操作示意）
第 2 步：复制 Pixel ID 和网站安装代码
- 回到 Pixel 列表，在刚创建的 Pixel 右侧点击 查看代码。
- 复制“像素 ID”。后面的代码生成器、CAPI 请求和问题排查都会使用它。
- 复制“设置代码”，放到网站所有需要追踪的页面的
<head>中；同一个页面只安装一次初始化代码。 - 初始化代码负责加载 SDK；具体的
oaiq("measure", ...)事件调用，应放在真正完成注册、下单、支付等业务动作之后。
Pixel ID 通常是类似
5iNt4RU8dpgpapjkkEog72 的字符串，不是 cds_xxx 数据源 ID，也不一定带 px_ 前缀。
截图 2：Pixel 列表 → 查看代码 → 复制像素 ID 和设置代码
第 3 步：创建转化事件，并复制事件调用代码
- 进入 资产设置 → 转化事件，点击 创建转化事件。
- 选择刚才创建的 Pixel，填写业务名称，例如“下单成功”。
- 事件类型必须和网站/CAPI 实际发送的事件完全一致。例如代码发送
order_created，后台也必须选择 Order Created。 - 当前归因窗口固定为 30 天。提交后，在列表点击 查看代码，可在“像素”和“转化 API”之间切换查看示例。
截图 3：资产设置 → 转化事件 → 创建转化事件
截图 4：转化事件列表 → 查看代码；这里的事件名称必须与实际发送值一致
第 4 步：使用 CAPI 时创建转化密钥
只有走服务端 Conversions API 时需要。进入 资产设置 → 转化密钥，选择广告账户并填写密钥名称。
截图 5：资产设置 → 转化密钥 → 创建转化密钥
密钥明文只在创建成功后展示一次。请立即保存在服务端密钥管理系统中，不要放进网页 JavaScript、前端环境变量、截图或工单。
CAPI 上报仍需要同时提供 Pixel ID：Pixel ID 表示数据归属，转化密钥负责服务端鉴权。
第 5 步：创建 Campaign 时绑定转化事件
- 进入 广告投放 → 创建广告系列 → 手动创建。
- 先选择用户和广告账户，系统才会加载该账户下可选的转化事件。
- 在“转化事件”中选择希望统计或优化的事件。若出价类型为“转化”，必须且只能选择一个标准转化事件。
- 建议在“落地页参数查询”填写：utm_source=openai&utm_medium=cpc&utm_campaign={campaign_id}&utm_content={ad_id}&oppref={oppref}，便于广告层级分析并把 OpenAI 点击标识带到落地页。
截图 6：广告投放 → 创建广告系列；先选账户，再选择转化事件
创建转化事件不会自动绑定所有 Campaign。未绑定时，即使 OpenAI 已收到事件，该 Campaign 的报表也可能没有转化，转化优化也不会使用该事件。
提交前，用这张表做一次最终核对
| 检查项 | 正确状态 |
|---|---|
| 账户关系 | Pixel、转化事件、Campaign 属于同一个广告账户 |
| 事件名称 | 代码/CAPI 的 type 与后台转化事件类型完全一致 |
| CAPI 参数 | 同时使用正确的 Pixel ID 和该账户的转化密钥 |
| Campaign 绑定 | 创建或编辑 Campaign 时已选择目标转化事件 |
| 落地页归因 | 落地页能够保留 oppref，后端下单/注册链路不会丢失它 |
| 重复上报 | Pixel + CAPI 双发同一事件时使用相同事件 ID 去重 |
“最近事件”中能查到数据，只能证明 OpenAI 已收到；是否归因到 Campaign，还取决于
oppref/obref 等匹配信息、转化事件绑定、归因窗口和报表处理延迟。
第二阶段 · 代码接入
生成并安装 Pixel / CAPI 回传代码
从这里开始是可交互的 6 步代码生成器。点击“下一步”后，页面会停留在当前操作区域。
选择你的回传方式
两种方式都能向 OpenAI 发送转化数据，选择最适合你的一种：
📊
Measurement Pixel（JS 像素）
在网页中嵌入 JavaScript 代码，适合追踪前端交互事件。安装简单，3 分钟搞定。
🔌
Conversions API（CAPI）
从你的服务器直接发送数据，不受广告拦截器影响，数据更准确。需要后端开发能力。
不知道选哪个？如果只有前端，选 Pixel；如果有稳定后端，优先 CAPI。Pixel + CAPI 同时部署时，同一业务事件必须使用相同事件 ID 去重，避免重复计算。
归因前置要求：保留
oppref。用户点击 OpenAI 广告后，落地页 URL 会带上 oppref。Pixel 会捕获它并存入第一方 Cookie；使用 CAPI 时，广告主需要在跳转、登录、结账和下单链路中保留原始值，并在服务端事件的外层字段中回传。oppref 用于点击归因，和用于去重的 Event ID 不是同一个字段。
输入你的 Pixel ID
Pixel ID 是你在 资产设置 → Pixel 中创建 Pixel 后，通过“查看代码”复制的。粘贴到下方：
去哪里找？登录 TecGPT Ads Manager → 资产设置 → Pixel → 找到对应 Pixel → 查看代码 → 复制“像素 ID”。
选择你要发送的事件类型
每个事件代表用户在你的网站上完成的一个动作：
电商场景通常从
order_created（下单）开始；SaaS 场景从 lead_created（留资）开始。验证安装是否成功
按照以下步骤逐一检查：