首页 AI 用 Claude 透過 Facebook Marketing API 建立行銷活動、廣告組合與廣告(2026):從 Brief 到暫停狀態草稿的完整範例

用 Claude 透過 Facebook Marketing API 建立行銷活動、廣告組合與廣告(2026):從 Brief 到暫停狀態草稿的完整範例

用 Claude 依 Brief 產生 Facebook 行銷活動、廣告組合、創意與廣告:Marketing API v27.0 參數、預算以分計、冪等鍵、暫停建立與人工啟用流程,附 Python 與 curl 範例。

最後更新:2026-11-16(Meta、Anthropic、OpenAI 官方文件皆於當天查閱)

這篇只做一件事:讓 Claude 把一份投放 Brief 變成 Facebook 上「暫停狀態」的行銷活動、廣告組合、創意和廣告,最後由投手在廣告管理員檢查後啟用。我們不透過 MCP,而是直接呼叫 Meta Marketing API,這樣每一個參數都看得見、可測試、可版本控管。想用 MCP 對話式操作,請看 如何將 Claude 連結到 Facebook 廣告。

四層物件與分工

物件API 端點必要/關鍵參數Claude 協助的地方
行銷活動 CampaignPOST /act_id/campaignsname、objective、status、special_ad_categories依 Brief 選目標、命名
廣告組合 Ad setPOST /act_id/adsetscampaign_id、預算(以分計)、billing_event、optimization_goal、targeting把受眾描述轉成 targeting JSON
廣告創意 CreativePOST /act_id/adcreativesobject_story_spec(page_id、link、message、image_hash)撰寫文案初稿
廣告 AdPOST /act_id/adsadset_id、creative、status產出待啟用清單
Facebook Marketing API 四層物件與 Claude 協助內容對照表

準備:系統使用者權杖與環境變數

在企業管理平台建立系統使用者,指派需要的廣告帳戶與粉絲專頁,產生具 ads_management 權限的權杖(Marketing API 驗證)。權杖只放在環境變數或密鑰管理服務,不貼進對話,也不寫進 Git:

# .env  (add .env to .gitignore; never commit or paste tokens into a prompt)
META_API_VERSION=v27.0
META_AD_ACCOUNT_ID=act_<AD_ACCOUNT_ID>
META_PAGE_ID=<PAGE_ID>
META_SYSTEM_USER_TOKEN=<SYSTEM_USER_ACCESS_TOKEN>

第 1 步:讓 Claude 把 Brief 轉成參數

在 Claude Code 裡提供 Brief 與規則,要求它只輸出 JSON,不呼叫任何 API:

讀取 brief.md:美國市場、導流到官網、每日預算 50 美元、25–54 歲、廣泛受眾、
2 組文案。依 rules.md 命名規範,輸出 plan.json:
campaign{name,objective}, adsets[{name,daily_budget_cents,targeting}],
ads[{name,primary_text,headline,cta,image_file}]。
預算一律以「分」為單位;不要呼叫任何 API。

人工檢查 plan.json(特別是預算、國家、年齡和文案)後,才進入下一步。

第 2 步:建立行銷活動

special_ad_categories 為必填;若業務屬於信貸、就業、住房或社會議題/選舉政治,必須宣告對應類別(Campaign 參考、Special ad category)。用 curl 測試單一請求:

curl -X POST "https://graph.facebook.com/v27.0/$META_AD_ACCOUNT_ID/campaigns" \
  -H "X-Client-Idempotent-Key: $(uuidgen)" \
  -F 'name=PWM | US | Traffic | Nov' \
  -F 'objective=OUTCOME_TRAFFIC' \
  -F 'status=PAUSED' \
  -F 'special_ad_categories=[]' \
  -F "access_token=$META_SYSTEM_USER_TOKEN"

第 3 步:用腳本建立完整結構(全部暫停)

正式批次建立時,用 Python 用戶端加上冪等鍵與退避。Meta 的冪等鍵適用於行銷活動、廣告組合、廣告和創意的建立,鍵在 7 天內有效,範圍是單一廣告帳戶(冪等請求):

# 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}"))
# create_paused.py - campaign -> ad set -> creative -> ad, everything PAUSED
import json
from meta_api import call, key, ACT
import os
RUN = "2026-11-16-us-traffic"

camp = call("POST", f"{ACT}/campaigns", data={
    "name": "PWM | US | Traffic | Nov",
    "objective": "OUTCOME_TRAFFIC",
    "status": "PAUSED",
    "special_ad_categories": json.dumps([]),      # required; declare a category if it applies
    "is_adset_budget_sharing_enabled": "0",
}, idem_key=key(RUN, "campaign"))

adset = call("POST", f"{ACT}/adsets", data={
    "name": "US | 25-54 | broad",
    "campaign_id": camp["id"],
    "daily_budget": "5000",                         # in cents of the account currency = 50.00
    "billing_event": "IMPRESSIONS",
    "optimization_goal": "LINK_CLICKS",
    "bid_strategy": "LOWEST_COST_WITHOUT_CAP",
    "targeting": json.dumps({"geo_locations": {"countries": ["US"]},
                             "age_min": 25, "age_max": 54}),
    "status": "PAUSED",
}, idem_key=key(RUN, "adset-us-broad"))

creative = call("POST", f"{ACT}/adcreatives", data={
    "name": "US | hook-A",
    "object_story_spec": json.dumps({
        "page_id": os.environ["META_PAGE_ID"],
        "link_data": {"message": "<approved primary text>",
                      "link": "https://www.example.com/landing",
                      "image_hash": "<IMAGE_HASH>",
                      "call_to_action": {"type": "LEARN_MORE"}}}),
}, idem_key=key(RUN, "creative-hook-A"))

ad = call("POST", f"{ACT}/ads", data={
    "name": "US | hook-A",
    "adset_id": adset["id"],
    "creative": json.dumps({"creative_id": creative["id"]}),
    "status": "PAUSED",                             # a human activates after review
}, idem_key=key(RUN, "ad-hook-A"))
print(camp["id"], adset["id"], creative["id"], ad["id"])

Claude 可以依 plan.json 迴圈呼叫上面的流程,或幫你補上 dry-run 與單元測試。v27.0 的變更(例如裝置自動化預設開啟、部分定位欄位被拒)請先看 Marketing API v27.0 更新解讀。

第 4 步:人工檢查並啟用

  • 在廣告管理員檢查預算、受眾、版位、追蹤與落地頁。
  • 確認文案符合 Meta 廣告刊登準則(
  • 廣告刊登準則
  • )。
  • 由投手手動啟用;不要讓 AI 在無人值守時啟用。

常見錯誤

常見錯誤原因處理方式
缺少 special_ad_categories建立行銷活動時為必填無特殊類別時傳空陣列 []
預算金額差 100 倍預算以帳戶貨幣最小單位計50.00 美元填 5000
重試後出現重複物件逾時後重送沒帶冪等鍵使用 X-Client-Idempotent-Key,重試沿用同一鍵
613 錯誤超過寫入頻率限制指數退避;同一物件 30 秒內只改一次
v27 拒絕 location_specv27.0 起相關欄位被拒改用目前文件列出的定位欄位
用 Claude 透過 Marketing API 建立廣告時的常見錯誤與處理方式

寫入頻率限制:同一廣告帳戶每秒最多 100 次寫入請求、同一物件每 30 秒只能修改一次、同一廣告組合預算每小時最多改 4 次(Rate limiting)。

熊貓出海如何用 Claude、Codex 與 Facebook 廣告帳戶提升客戶投放效率

本文主角是 Claude,但在實際服務中,熊貓出海會把 Claude、Codex 與 Facebook 企業廣告帳戶組合使用,協助出海企業更快完成「開戶 → 建立結構 → 上素材 → 看數據 → 調預算」這套重複工作,讓投放團隊把時間留給策略與素材判斷。

  • 廣告帳戶:使用企業自己的 Facebook 廣告帳戶,或透過熊貓出海開戶服務合規開通的企業戶;帳戶歸企業所有,不出租、不共享。
  • Claude:適合閱讀長文件與報表、撰寫投放規劃與文案初稿、透過 Meta 廣告 MCP 以暫停狀態起草廣告結構、依規則排查異常。
  • Codex:適合撰寫與維護自動化腳本(Marketing API、Insights 報表、批次上傳、預算規則),在沙盒中執行並接入排程或 CI。
  • 人工把關:所有會花錢的動作(啟用廣告、提高預算)都由投手審核後執行;Meta 廣告政策與素材合規由人工最終確認。

這是服務能力說明,不涉及任何價格或回饋承諾;我們也不是 Meta、Anthropic 或 OpenAI 的官方合作夥伴。開戶與代操流程請見 Facebook 廣告代操與海外開戶(熊貓出海服務頁)。

常見問題

一定要用系統使用者權杖嗎?

自動化場景建議用系統使用者權杖,不依賴個人帳號登入狀態,也方便控管權限。

Claude 會不會直接把預算設錯?

讓它只產出 plan.json,由腳本建立暫停物件,再由人工檢查,預算錯誤能在上線前攔下。

可以用 v25 或 v26 嗎?

可以使用仍在支援期內的版本,但新專案建議使用目前最新的 v27.0。

建立後為什麼看不到投放?

因為全部以 PAUSED 建立,需要人工啟用。

Claude 在台灣可以用嗎?

依 Anthropic 支援地區清單,台灣在支援範圍內;實際方案與付款方式以官方為準。

合規說明:本文所有自動化都應只用於企業自有或已獲正式授權的廣告帳戶、粉絲專頁與像素,透過 Meta 官方 Marketing API、Ads MCP 伺服器或 Ads CLI 接入,使用企業管理平台中的系統使用者與最小權限,遵守 Meta 速率限制與《廣告刊登準則》,並在任何會產生花費的動作前保留人工審核。熊貓出海不販售、出租、共享或轉讓廣告帳戶、企業管理平台或 API 金鑰,不協助規避廣告審查、地區限制、KYC、企業驗證或付款管控,也不是 Meta、Anthropic 或 OpenAI 的官方合作夥伴。Claude 與 OpenAI 服務僅提供給支援國家/地區的客戶,請由在支援地區合法設立並實際營運的主體開通並負責。

延伸閱讀

聯絡熊貓出海:Facebook 開戶 + AI 自動化投放

請告訴我們公司登記地、產業、目標國家、到達網頁連結與預估月預算,以及想先自動化哪一段(建立結構、素材、報表或預算規則)。我們先做資格與素材預審,再協助開通合規的 Facebook 企業廣告帳戶,並用 Claude、Codex 建立在您自有帳戶上執行的自動化流程。我們不販售、出租或共享任何廣告帳戶。

WhatsApp:+852 5904 8602Telegram:@PANDA0134WeChat/微信:szcwh99

熊貓出海 WeChat QR 微信:szcwh99

官方來源

以上官方頁面皆於 2026-11-16 查閱。API 版本、工具名稱與權限要求會變動,請以官方頁面為準。

本文来自网络,不代表熊猫出海立场。转载请注明出处: https://www.pandawm.com/blog/claude-facebook-marketing-api-campaign-adset-ad-creation-zh-tw.html
上一篇
下一篇

作者: 熊猫出海编辑团队

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

为您推荐

发表回复

联系我们

联系我们

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

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

微信扫一扫关注我们

关注微博
返回顶部