首页 AI 用 Codex 写 Facebook 广告日报与预算规则脚本(2026):Insights 导出、codex exec 结构化摘要、广告规则引擎与 CI 定时任务

用 Codex 写 Facebook 广告日报与预算规则脚本(2026):Insights 导出、codex exec 结构化摘要、广告规则引擎与 CI 定时任务

用 OpenAI Codex 生成 Facebook 广告日报与预算规则:Insights API 分页导出、codex exec 只读沙盒加 JSON Schema 输出、adrules_library 通知与预算规则、GitHub Actions 定时运行与密钥保护。

最后更新:2026-11-16(Meta、Anthropic、OpenAI 官方文档均于当天查阅)

上一篇 Codex 操作 Facebook 广告投放全流程自动化 讲了 Codex 自动化 Facebook 投放的整体流程。这一篇只做两件最常用、也最容易出错的事:每日报表和预算规则。思路是:Codex 写脚本 → 脚本拉数据 → codex exec 在只读沙盒里写摘要和建议 → 人批准 → Meta 的广告规则引擎执行。

文件与分工

文件作用谁写谁运行
daily_report.py拉取昨日行销数据导出 CSVCodex 编写、人工审定时任务
report_schema.json约束 AI 输出格式Codex 编写codex exec
report.json摘要、异常、建议(不执行)codex exec 生成投手阅读
rules/*.json通知规则、带上限的预算规则Codex 起草人工批准后创建
.github/workflows/report.yml每日定时、保存产物Codex 编写GitHub Actions
Codex 生成的 Facebook 广告日报与规则相关文件分工

第 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大报表用异步任务
Facebook Marketing API 与日报预算规则相关的频率限制

来源: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 自动化投放

告诉我们公司主体所在地、行业、目标国家、落地页链接和预计月预算,以及你想先自动化哪一段(建户结构、素材、日报还是预算规则)。我们先做资质与素材预审,再协助开通合规的 Facebook 企业广告户,并用 Claude、Codex 搭建在你自有帐号上运行的自动化流程。我们不出售、出租或共享任何广告帐号。

WhatsApp:+852 5904 8602Telegram:@PANDA0134微信:szcwh99

熊猫出海微信二维码 szcwh99

官方来源

以上官方页面均于 2026-11-16 查阅。API 版本、工具名称与权限要求会变化,请以官方页面为准。

本文来自网络,不代表熊猫出海立场。转载请注明出处: https://www.pandawm.com/blog/codex-facebook-ads-daily-report-budget-rules-scripts-2026.html
上一篇
下一篇

作者: 熊猫出海编辑团队

熊猫出海(PandaWM)编辑团队,来自香港出海服务商熊猫出海,专注 Facebook、TikTok、Google 等海外广告开户与代投,以及 GEO/AI 搜索优化、多语言独立站建设。有Facebook白名单牌照户、TikTok加白户、Google G2认证户等核心资源 。

为您推荐

发表回复

联系我们

联系我们

工作时间:周一至周五,9:00-17:30,节假日休息

关注微信
微信扫一扫关注我们

微信扫一扫关注我们

关注微博
返回顶部