用途:通过 openai-ads-pp-cli 以程序化方式管理 ChatGPT Ads 广告账户,包括审计账户结构、检查预算消耗节奏、对比变更历史,以及创建和更新广告系列、广告组与广告。资料称其覆盖完整 Advertiser API 面,并将账户镜像到本地 SQLite,可回答 REST API 结构上无法直接回答的问题。
主要能力:pace 判断广告系列是否会超支或消耗不足;drift 显示两次同步之间广告系列、广告组和广告的变化;fatigue 按点击率衰减对广告排名;review-watch 跟踪审批与审核状态变化;bid-check 标记最高出价与母广告系列预算不匹配的广告组;orphans 查找无广告的广告组、无投放的广告系列和未被引用的受众;tree 渲染完整层级结构;geo resolve 将位置 ID 转为可读地名。货币值按账户货币显示。
使用方式:先验证 CLI 已安装:openai-ads-pp-cli --version。安装可用 npx -y @mvanhorn/printing-press-library install openai-ads --cli-only;若失败可回退 Go 安装:go install github.com/mvanhorn/printing-press-library/library/marketing/openai-ads/cmd/openai-ads-pp-cli@latest。任意命令加 --agent 展开为 --json --compact --no-input --no-color --yes。可用 which "能力描述" 查找命令,用 --select 缩小字段,用 --dry-run 预览变更。认证通过 OPENAI_ADS_API_KEY(Ads API 键)或 OPENAI_ADS_CONVERSIONS_API_KEY(转化事件键),用 doctor 检查。路径可用 --home 或 OPENAI_ADS_HOME 等环境变量重定位。
限制:不适用于 OpenAI Platform API(模型、文件、批处理属另一凭证);不用于发送服务端转化事件;不能完成业务验证或品牌审核(仅控制台);本地命令在同步前不会反映 Ads Manager 中的改动。