OpenAI / ChatGPT 广告连接操作指南：核对管理员权限、连接状态与转化事件配置前提

概览

OpenAI Ads 让工作区直接在 WAthink 内于 OpenAI（ChatGPT）广告平台投放广告系列。每个工作区连接自己的 OpenAI 广告 API 密钥（一个密钥代表一个广告账户），随后即可创建广告系列、广告组与广告，设置转化跟踪（像素、Conversions API 密钥、转化事件），查看投放洞察，甚至用 AI 生成广告文案。

该模块位于 OpenAI Ads（/openai-ads），仅工作区管理员（admin）可用。凭据按工作区存储、静态加密，保存在 provider-config 记录上；该密钥只作为广告主凭据，绝不会被用作消息发送方。

对接真实第三方 API。本模块对接真实的广告 API，需要有效的 OpenAI Ads 账户与 API 密钥才能运行。连接、创建广告系列、上传素材、读取洞察等每一步操作都会调用该真实 API，并取决于你的 OpenAI Ads 账户处于可用且可访问状态。如果没有 OpenAI Ads 账户或 API 密钥，模块只会显示连接页面。

新增内容

• 自带 API 密钥连接 OpenAI Ads，按工作区隔离，保存前先在线校验。
• 广告系列创建向导：一步创建广告系列、广告组与广告 —— 全部以暂停状态创建，供你审核。
• 转化设置中心 —— 创建网页像素、Conversions API 密钥与转化事件设置，用于按转化优化的（oCPC）出价。
• 投放分析 —— 在日期范围内查看分广告系列与每日账户洞察（展示、点击、花费、CTR、CPC、CPM），含 KPI 汇总与图表。
• Build with AI —— 用简短说明生成广告系列 / 广告组 / 广告名称以及标题与正文，可使用平台 AI 密钥或工作区自己的 AI 提供商密钥。
• 本地镜像 —— 每个远端对象都有本地记录，界面保持快速并能在 API 波动时继续可用；金额以 micros 存储（1 个单位 = 1,000,000 micros）。

前提条件

• 工作区中的管理员角色。所有 OpenAI Ads 路由都受管理员工作区角色保护。
• 一个 OpenAI Ads 账户与广告主 API 密钥。一个密钥对应一个广告账户。认证使用静态 Bearer 密钥（无 OAuth / 刷新流程）。
• 你的账户必须已启用 OpenAI Ads API 且网络可达。API 返回的错误（密钥无效、“feature not enabled”、限流）会原样显示在界面上。
• Build with AI 功能：至少一个可用的 AI 提供商 —— 平台配置的 AI 密钥，或工作区自己的 OpenAI / Anthropic / Gemini / Mistral 密钥。
• 受 OpenAI Ads 速率限制约束（每个端点 600 请求/分钟，每个广告账户 1,200/分钟）。

连接 API 密钥

1. 打开 More 菜单并点击 OpenAI Ads，或直接访问 /openai-ads（管理员也可以把它提升到主导航）。若尚未存储密钥，会先进入连接页面。
2. 粘贴你的 OpenAI Ads API 密钥并提交。
3. WAthink 会在保存前用真实广告账户校验该密钥。被拒绝的密钥会返回明确错误，且不会保存任何内容。校验通过后，密钥加密保存，账户快照（货币、时区、审核状态）被缓存，然后返回 OpenAI Ads 仪表盘。
4. 随时可用 Verify 重新检查连接，它会重新读取并刷新账户快照。
5. 使用 Disconnect 移除连接；已存储的密钥与配置会被删除。

设置转化跟踪

转化跟踪是可选的，但按转化优化出价时必须配置。打开 Conversions 页面，可以创建：

• 像素（Pixel） —— 起个名字；WAthink 会创建一个网页像素，并保存其 source id（clidsrc_…）与 pixel_id（用于在你的网站上初始化 JS 像素）。
• Conversions API 密钥 —— 起个名字；WAthink 会创建密钥。密钥只显示一次 —— 请立即复制。WAthink 只保存掩码提示（例如 …a1b2），绝不保存密钥本身。
• 转化事件设置 —— 定义一个用于优化的转化事件：名称、事件类型（类型为 custom 时可填自定义事件名称）、归因窗口（1–90 天）以及上报所用的像素。它会生成一个事件设置 id（ces_…），之后可挂到使用 conversions 出价的广告系列上。

创建广告系列

1. 在 OpenAI Ads 仪表盘点击 Create。若尚未连接密钥，会先跳转到连接页面。
2. （可选）使用 Build with AI：填写企业名称、产品/服务、受众与语气，选择 AI 模型，生成建议的广告系列名称、广告组名称、广告名称、标题与正文。建议内容会填入向导字段（标题上限 50 个字符，正文上限 100）。
3. 填写广告系列链条并提交：
   • 广告系列 —— 名称、预算（以账户货币计，最低 1）与出价类型：impressions、clicks 或 conversions。选择 conversions 时，需要选择之前创建的转化事件设置。
   • 广告组 —— 名称、计费事件类型（impression 或 click）与最高出价。
   • 广告 —— 名称、素材类型（chat_card 或 product_ad_template）、标题（3–50 字符）、正文（最多 100 字符）、可选价格；若为 chat_card，还需目标 URL与图片 URL（图片会被上传，且至少 640×640）。
4. WAthink 会把广告系列、广告组与广告全部以暂停状态创建，并在每个远端对象创建时写入本地记录（因此链条中途 API 失败也仍有可用记录）。完成后进入广告系列详情页。

审核与上线

1. 打开广告系列，查看其广告组、广告及审核状态（in_review / approved / rejected）。
2. 点击 Activate。由于 API 要求子级先启用、广告系列才能上线，WAthink 会自下而上启用 —— 先广告，再广告组，最后广告系列。任一子级失败都会报错，且广告系列不会上线。
3. 随时点击 Pause 暂停已上线的广告系列。

监控投放表现

打开 Analytics。默认显示最近 30 天；可调整开始 / 结束日期。查看 KPI 汇总条（总展示、点击、花费，以及派生指标 CTR、CPC、CPM）、分广告系列明细表与柱状图，以及每日账户趋势折线图。数值以广告账户的货币显示。

注意事项与限制