Ad Account（广告账户）

代表在 Facebook 上创建和管理广告的业务/个人/实体。多人可以以不同访问级别管理一个账户。

广告量查询

查询广告账户中正在投放或审核中的广告数量：

curl -G -d "access_token=<access_token>" \
  "https://graph.facebook.com/v25.0/act_<ad_account_ID>/ads_volume"

限制

关键字段

常见错误码

Campaign（广告系列 — Ad Campaign Group）

广告系列是广告账户中最高级别的组织结构，代表单一业务目标（如提升流量、转化）。设置广告系列目标后，其下所有广告都会受到目标验证。

新必填字段：自 v7.0 起，所有广告系列必须指定 special_ad_categories（特殊广告类别）字段。替代已弃用的 special_ad_category（字符串）。

限制

• 每个广告系列最多 200 个广告组
• 如果广告系列有 超过 70 个广告组且使用 CBO（广告系列预算优化），则无法编辑竞价策略或关闭 CBO

关键字段

读取：GET /{campaign_id}

子端点

Ad Set（广告组）

广告组是一组共享相同预算、排期、竞价和定位数据的广告。

限制

关键字段

创建（POST）

curl -X POST \
  -F 'name="My First Adset"' \
  -F 'lifetime_budget=20000' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'bid_amount=100' \
  -F 'billing_event="LINK_CLICKS"' \
  -F 'optimization_goal="LINK_CLICKS"' \
  -F 'targeting={
       "geo_locations": {"countries": ["US"]},
       "publisher_platforms": ["facebook", "audience_network"]
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adsets

创建必填参数

iOS 14.5 变更：手机应用自定义受众不再支持用于 iOS 14.5 SKAdNetwork 广告系列的包含定位。

Ad（广告 — Adgroup）

广告包含要展示的信息，并与广告组关联。同组内的所有广告共享预算、排期和定位。

读取方式

# 按广告 ID
curl -X GET -d 'fields="id,name"' -d 'access_token=<TOKEN>' \
  https://graph.facebook.com/v25.0/<AD_ID>/

# 按广告账户
curl -G -d "fields=name" -d "access_token=<TOKEN>" \
  "https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads"

# 按广告系列
curl -X GET -d 'fields="name"' -d 'access_token=<TOKEN>' \
  https://graph.facebook.com/v25.0/<AD_CAMPAIGN_ID>/ads

# 按广告组
curl -F "fields=name" -F "access_token=<TOKEN>" \
  "https://graph.facebook.com/v25.0/<AD_SET_ID>/ads"

关键字段

创建广告

前提：需要已有的广告组和广告创意。

curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="<AD_SET_ID>"' \
  -F 'creative={"creative_id": "<CREATIVE_ID>"}' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

政治广告需添加 -F 'authorization_category="POLITICAL"'。

Ad Creative（广告创意）

广告创意定义广告的布局和内容。可独立创建或作为广告组的一部分。

创建广告创意

curl -X POST \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={
      "page_id": "<PAGE_ID>",
      "link_data": {
        "message": "Check out our new product!",
        "link": "https://www.example.com/product",
        "caption": "Our New Product",
        "picture": "https://www.example.com/image.jpg",
        "call_to_action": {"type": "SHOP_NOW"}
      }
    }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives

关键参数（POST）

文本限制

Campaigns 子端点

创建和管理广告账户下的广告系列。

读取

GET /v25.0/act_<AD_ACCOUNT_ID>/campaigns?effective_status=["ACTIVE","PAUSED"]&fields=name,objective

参数：date_preset（预定义日期范围）、effective_status（筛选状态）、is_completed（是否已完成）、time_range（自定义日期范围）。

创建

curl -X POST \
  -F 'name="My campaign"' \
  -F 'objective="OUTCOME_TRAFFIC"' \
  -F 'status="PAUSED"' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/campaigns

创建必填参数

返回结构

{
  "data": [],      // Campaign 节点列表
  "paging": {},    // 分页信息
  "summary": {}    // 聚合信息（total_count 等）
}

Ad Sets 子端点

读取

curl -X GET -G \
  -d 'fields="name,id,status"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adsets

查询参数：date_preset、effective_status、is_completed、time_range、updated_since。

创建

curl -X POST \
  -F 'name="My First Adset"' \
  -F 'lifetime_budget=20000' \
  -F 'start_time="2026-05-12T10:45:01-0700"' \
  -F 'end_time="2026-05-22T10:45:01-0700"' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'bid_amount=100' \
  -F 'billing_event="LINK_CLICKS"' \
  -F 'optimization_goal="LINK_CLICKS"' \
  -F 'targeting={
       "facebook_positions": ["feed"],
       "geo_locations": {"countries": ["US"]},
       "publisher_platforms": ["facebook", "audience_network"]
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adsets

Ads 子端点

创建

curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="<AD_SET_ID>"' \
  -F 'creative={"creative_id": "<CREATIVE_ID>"}' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

创建必填参数

SDK 示例

// JavaScript SDK
FB.api("/act_<AD_ACCOUNT_ID>/ads", "POST", {
  "name": "My Ad",
  "adset_id": "<AD_SET_ID>",
  "creative": "{\"creative_id\":\"<CREATIVE_ID>\"}",
  "status": "PAUSED"
}, function (response) { /* handle */ });

Ad Creatives 子端点

读取

GET /v25.0/act_<AD_ACCOUNT_ID>/adcreatives?fields=name

创建

curl -X POST \
  -F 'name=Sample Promoted Post' \
  -F 'object_story_id=<PAGE_ID>_<POST_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives

关键参数

Insights 子端点

提供广告表现的成效指标。部分指标是估算值或开发中。

iOS 14.5 警告：Facebook 无法再跨 iOS 14.5 和非 iOS 14.5 广告系列聚合非内联转化指标值。内联事件指标（展示次数、链接点击、视频观看）仍可聚合。

date_preset=lifetime 已弃用：自 v10.0 起，请使用 date_preset=maximum。

同步查询

curl -X GET -G \
  -d 'fields="impressions"' \
  -d 'breakdown="publisher_platform"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/<AD_SET_ID>/insights

异步报告创建（POST）

POST /act_{ad_account_id}/insights

Custom Audiences 子端点

读取

FB.api("/act_<AD_ACCOUNT_ID>/customaudiences",
  { "fields": "id" }, function (response) { /* handle */ });

参数：business_id（可选过滤器）、pixel_id（按像素代码筛选）、filtering（过滤对象数组）。

限制：每个广告账户最多 500 个自定义受众。

Business（商务管理平台）

代表 Facebook 上的一个业务实体。

读取

GET /v25.0/{business-id}

关键字段

创建业务

POST /{user_id}/businesses
-F 'name=My Business'

可选参数：email、primary_page、timezone_id、vertical、survey_business_type。

子端点

Ads Pixel（广告像素代码）

Facebook 像素是一小段 JavaScript 代码，放置在网站的每个页面上。用于捕获网站意图并创建网站自定义受众。

读取

GET /v25.0/{ads-pixel-id}

关键字段

创建

POST /v25.0/act_<AD_ACCOUNT_ID>/adspixels
-F 'name=My WCA Pixel'

Custom Audience（自定义受众）

2025 年 9 月 2 日起的限制：Meta 将主动限制可能暗示不允许的信息（如健康状况、财务状况）的自定义受众和类似受众。

关键字段

操作状态码

System User（系统用户）

系统用户是用于服务器到服务器交互的账户，管理资产和调用营销 API。

读取

GET /v25.0/{system-user-id}

字段

创建

POST /{business_id}/system_users
-F 'name=My System User'
-F 'role=ADMIN'

可用角色：ADMIN, EMPLOYEE, FINANCE_EDITOR, FINANCE_ANALYST, ADS_RIGHTS_REVIEWER, DEVELOPER 等。

限制：每个商务管理平台有系统用户数量上限（有限访问=1个，完全访问=10个）。

子端点