最后更新:2026-11-16(Meta、Anthropic、OpenAI 官方文档均于当天查阅)
上一篇 Codex 操作 Facebook 广告投放全流程自动化 讲了 Codex 自动化 Facebook 投放的整体流程。这一篇只做两件最常用、也最容易出错的事:每日报表和预算规则。思路是:Codex 写脚本 → 脚本拉数据 → codex exec 在只读沙盒里写摘要和建议 → 人批准 → Meta 的广告规则引擎执行。
文件与分工
| 文件 | 作用 | 谁写 | 谁运行 |
|---|---|---|---|
| daily_report.py | 拉取昨日行销数据导出 CSV | Codex 编写、人工审 | 定时任务 |
| report_schema.json | 约束 AI 输出格式 | Codex 编写 | codex exec |
| report.json | 摘要、异常、建议(不执行) | codex exec 生成 | 投手阅读 |
| rules/*.json | 通知规则、带上限的预算规则 | Codex 起草 | 人工批准后创建 |
| .github/workflows/report.yml | 每日定时、保存产物 | Codex 编写 | GitHub Actions |

第 1 步:让 Codex 写数据导出脚本
在 Codex CLI 里给出需求:「用 meta_api.py 写 daily_report.py,按广告系列导出昨天的花费、展示、点击、CTR、CPC、转化,处理分页,导出 CSV,附测试」。Insights API 支持按帐户、系列、组、广告层级查询(Insights API):
# meta_api.py - minimal Marketing API client (Python 3.10+, pip install requests)
import os, time, json, uuid, requests
API = "https://graph.facebook.com/" + os.environ.get("META_API_VERSION", "v27.0")
TOKEN = os.environ["META_SYSTEM_USER_TOKEN"] # from env / secret manager only
ACT = os.environ["META_AD_ACCOUNT_ID"] # e.g. act_1234567890
THROTTLE = {4, 17, 613, 80000, 80003, 80004, 80014} # rate-limit codes in Meta's docs
def call(method, path, params=None, data=None, idem_key=None, tries=5):
headers = {"X-Client-Idempotent-Key": idem_key} if idem_key else {}
for attempt in range(tries):
r = requests.request(method, f"{API}/{path}", headers=headers, timeout=60,
params={**(params or {}), "access_token": TOKEN} if method == "GET" else None,
data={**(data or {}), "access_token": TOKEN} if method != "GET" else None)
for h in ("X-Business-Use-Case-Usage", "X-Ad-Account-Usage", "X-FB-Ads-Insights-Throttle"):
if h in r.headers:
print(h, r.headers[h]) # log usage, back off early
body = r.json()
err = body.get("error")
if not err:
return body
if err.get("code") in THROTTLE or r.status_code >= 500:
time.sleep(min(60 * 2 ** attempt, 900)) # exponential backoff
continue # same idem_key -> no duplicates
raise RuntimeError(json.dumps(err))
raise RuntimeError("rate limited: giving up, try later")
def key(run_id, name):
"""Stable idempotency key per object, so a retry never creates a duplicate."""
return str(uuid.uuid5(uuid.NAMESPACE_URL, f"{ACT}/{run_id}/{name}"))# daily_report.py - yesterday by campaign, saved as CSV for the AI summary step
import csv
from meta_api import call, ACT
FIELDS = "campaign_id,campaign_name,spend,impressions,clicks,ctr,cpc,cpm,actions,cost_per_action_type"
rows, after = [], None
while True:
params = {"level": "campaign", "date_preset": "yesterday", "fields": FIELDS, "limit": 200}
if after:
params["after"] = after
page = call("GET", f"{ACT}/insights", params=params)
rows += page.get("data", [])
after = page.get("paging", {}).get("cursors", {}).get("after")
if not page.get("paging", {}).get("next"):
break
with open("report_yesterday.csv", "w", newline="") as f:
w = csv.DictWriter(f, fieldnames=FIELDS.split(","), extrasaction="ignore")
w.writeheader(); w.writerows(rows)
print(len(rows), "campaign rows")数据量大时,Meta 建议用异步报表任务,并留意 X-FB-Ads-Insights-Throttle 响应头(Insights 最佳实践)。
第 2 步:codex exec 生成结构化摘要
codex exec 默认在只读沙盒中运行;用 --output-schema 指定 JSON Schema,-o 把最终消息写进文件,--ephemeral 不保存会话(codex exec):
{
"type": "object",
"properties": {
"summary": { "type": "string" },
"anomalies": { "type": "array", "items": { "type": "string" } },
"proposed_budget_changes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"adset_id": { "type": "string" },
"current_daily_budget_cents": { "type": "integer" },
"proposed_daily_budget_cents": { "type": "integer" },
"reason": { "type": "string" }
},
"required": ["adset_id", "current_daily_budget_cents", "proposed_daily_budget_cents", "reason"],
"additionalProperties": false
}
}
},
"required": ["summary", "anomalies", "proposed_budget_changes"],
"additionalProperties": false
}# nightly report (read-only sandbox is the default for codex exec)
python daily_report.py
codex exec --ephemeral --output-schema report_schema.json -o report.json \
"Read report_yesterday.csv. Summarise spend, CTR, CPC and results per campaign, \
list anomalies vs the 7-day average and propose (do not apply) budget changes."Schema 里的 proposed_budget_changes 只是建议,字段单位明确写成「分」,避免 AI 和人对金额理解不一致。
第 3 步:把批准的建议变成广告规则
Meta 广告规则引擎支持按计划(DAILY、HOURLY、SEMI_HOURLY、CUSTOM)检查条件并执行动作,动作包括通知、暂停、恢复、改预算、改出价等(广告规则引擎、计划型规则)。先从通知规则开始:
curl -X POST "https://graph.facebook.com/v27.0/$META_AD_ACCOUNT_ID/adrules_library" \
-F 'name=Alert: ad set spent > 50 with 0 results (7d)' \
-F 'schedule_spec={"schedule_type": "DAILY"}' \
-F 'evaluation_spec={
"evaluation_type": "SCHEDULE",
"filters": [
{"field": "entity_type", "value": "ADSET", "operator": "EQUAL"},
{"field": "time_preset", "value": "LAST_7_DAYS", "operator": "EQUAL"},
{"field": "effective_status", "value": ["ACTIVE"], "operator": "IN"},
{"field": "spent", "value": 5000, "operator": "GREATER_THAN"},
{"field": "results", "value": 1, "operator": "LESS_THAN"}
]}' \
-F 'execution_spec={"execution_type": "NOTIFICATION"}' \
-F "access_token=$META_SYSTEM_USER_TOKEN"需要自动加预算时,务必加上「单次幅度、最高金额、最多执行次数、最短间隔」:
-F 'execution_spec={
"execution_type": "CHANGE_BUDGET",
"execution_options": [
{"field": "change_spec", "operator": "EQUAL",
"value": {"amount": 10, "unit": "PERCENTAGE", "limit": 20000}},
{"field": "execution_count_limit", "operator": "EQUAL", "value": 3},
{"field": "action_frequency", "operator": "EQUAL", "value": 1440}
]}' 上例表示每次最多加 10%,每天最多一次(1440 分钟),最多 3 次,预算不超过 200.00(20000 分)。
频率限制别忽略
| 限制 | 数值 | 对脚本的影响 |
|---|---|---|
| 广告户写请求 | 每秒 100 次 | 批量建规则要排队 |
| 同一对象修改 | 每 30 秒 1 次 | 同一广告组别连续改 |
| 广告组预算修改 | 每小时 4 次 | 规则频率别设太短 |
| 帐户花费上限修改 | 每天 10 次 | 不要让脚本反复改上限 |
| Insights 请求 | 看 X-FB-Ads-Insights-Throttle | 大报表用异步任务 |

来源:Marketing API Rate limiting。脚本中统一用退避重试,日志里记录用量响应头。
第 4 步:用 GitHub Actions 定时运行
OpenAI 建议在 GitHub Actions 里用官方的 openai/codex-action,把 API 密钥只传给这一步,而不是设为整个 Job 的环境变量(Codex GitHub Action)。示意:
# .github/workflows/report.yml (excerpt)
on:
schedule: [{ cron: "0 1 * * *" }] # 01:00 UTC daily
jobs:
report:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: pip install requests && python daily_report.py
env:
META_SYSTEM_USER_TOKEN: ${{ secrets.META_SYSTEM_USER_TOKEN }} # read-only token
META_AD_ACCOUNT_ID: ${{ vars.META_AD_ACCOUNT_ID }}
- uses: openai/codex-action@v1
with:
openai-api-key: ${{ secrets.OPENAI_API_KEY }}
prompt-file: .github/prompts/daily-report.md
output-file: report.md日报用的令牌建议只给 ads_read,与创建规则所用的令牌分开。Action 输入参数以官方仓库说明为准。
同样的事,Claude 怎么做
如果你更习惯对话式查数,可以看 Claude 版本:Claude reporting and budget rules(英文)。
熊猫出海如何用 Claude、Codex 和 Facebook 广告户提升客户投放效率
这篇讲的是 Codex,但在实际服务中,熊猫出海会把 Claude、Codex 和 Facebook 企业广告户组合起来,帮助出海企业更快完成「建户 → 搭结构 → 上素材 → 看数据 → 调预算」这一整套重复工作,把投放团队的时间留给策略和素材判断。
- 广告户:使用企业自己的 Facebook 广告帐号,或通过熊猫出海的开户服务合规开通的企业户;帐号归企业所有,不出租、不共享。
- Claude:适合读长文档与报表、写投放方案和文案初稿、通过 Meta 广告 MCP 在暂停状态下起草广告结构、按规则做异常排查。
- Codex:适合写和维护自动化脚本(Marketing API、Insights 日报、批量上传、预算规则),在沙盒里运行并接入定时任务或 CI。
- 人工把关:所有会花钱的动作(激活广告、提高预算)都由投手审核后执行;Meta 广告政策与素材合规由人工最终确认。
这是一项服务能力说明,不涉及任何价格或返点承诺;我们也不是 Meta、Anthropic 或 OpenAI 的官方合作伙伴。想了解开户与代投放流程,请看 Facebook 海外企业户开户与投放(熊猫出海服务页)。
常见问题
codex exec 能直接改预算吗?
默认只读沙盒不能写文件,也不会帮你调用写接口;我们的设计是它只出建议。
规则会不会把预算加爆?
给规则设置金额上限、执行次数和间隔,并先用通知规则观察一段时间。
日报数据和后台对不上?
检查时区、归因设置和统计窗口;Insights 数据在之后一段时间内可能更新。
能用 Codex 订阅额度跑 CI 吗?
自动化场景官方建议用 API 密钥(CODEX_API_KEY 或 action 的密钥输入)。
触发型规则可以在后台建吗?
触发型规则目前只能通过 API 创建。
合规说明:本文所有自动化都应只用于企业自有或已获正式授权的广告帐号、主页与像素,通过 Meta 官方 Marketing API、Ads MCP 服务器或 Ads CLI 接入,使用业务管理平台(Business Manager)中的系统用户与最小权限,遵守 Meta 速率限制与《广告发布标准》,并在任何会产生花费的操作前保留人工审核。熊猫出海不出售、出租、共享或转让广告帐号、BM 或 API 密钥,不协助规避广告审核、地区限制、KYC、企业验证或支付管控,也不是 Meta、Anthropic 或 OpenAI 的官方合作伙伴。Claude 与 OpenAI 服务仅向其支持国家/地区的客户提供,中国大陆与香港不在列表中,请由在支持地区合法设立并真实经营的主体开通并负责。
相关阅读
- Facebook 海外企业户开户与投放(熊猫出海服务页)
- 海外 AI Token 服务:帐号开通 + API 接入(熊猫出海)
- Codex 操作 Facebook 广告投放全流程自动化
- Codex campaign creation pipeline(英文)
- Claude reporting(英文)
- Meta 开发了 MCP:让 AI 直接操作你的广告投放
- Meta Marketing API v27.0 更新解读
- Meta 广告管理工具后台使用教程
联系熊猫出海:Facebook 开户 + AI 自动化投放
告诉我们公司主体所在地、行业、目标国家、落地页链接和预计月预算,以及你想先自动化哪一段(建户结构、素材、日报还是预算规则)。我们先做资质与素材预审,再协助开通合规的 Facebook 企业广告户,并用 Claude、Codex 搭建在你自有帐号上运行的自动化流程。我们不出售、出租或共享任何广告帐号。
WhatsApp:+852 5904 8602Telegram:@PANDA0134微信:szcwh99

官方来源
- Meta: Ads Insights API
- Meta: Insights API limits and best practices
- OpenAI: Codex non-interactive mode (codex exec)
- OpenAI: Codex GitHub Action
- Meta: Ad rules engine
- Meta: Schedule-based ad rules
- Meta: Trigger-based ad rules
- Meta: Marketing API rate limiting
以上官方页面均于 2026-11-16 查阅。API 版本、工具名称与权限要求会变化,请以官方页面为准。

微信扫一扫打赏
支付宝扫一扫打赏
