Meta Ads Manager 数据 API：广告系列、效果与账单

Meta Platforms, Inc. · 电商

Meta Ads Manager（包名 com.facebook.adsmanager）是 Meta 官方推出的手机端应用，用于在移动端运营 Facebook 与 Instagram 广告。底层走的是 Meta 的 GraphQL API：每个界面都通过一个需要登录的网关发起具名的持久化查询文档，携带操作名与持久化文档 id，并用登录会话中广告主的 OAuth access token 鉴权。

下面这份示意性接口面把这些私有调用泛化为路径形式：首页的广告系列列表对应 POST /v1/ads/campaigns，分对象指标对应 POST /v1/ads/insights（spend、impressions、reach、clicks、cpm、purchase_roas），每周账户图表对应 POST /v1/ads/performance-chart，账单读取（current_balance、credential_id）对应 POST /v1/billing/account，草稿创建对应 POST /v1/ads/drafts，账户状态检查（account_status、restriction_type）对应 POST /v1/ads/account-standing。

Meta Ads Manager 是 Meta 官方推出的安卓应用，用于在手机上运营 Facebook 与 Instagram 广告：创建和编辑草稿、盯守消耗与成效、管理账单，并在账户需要处理时收到提醒。其数据 API 是一套需要登录的一方 GraphQL 接口：每个界面都通过同一网关发起具名的持久化查询文档——首页加载平面广告系列列表，效果页读取分对象 insights 与每周账户图表，账单页读取余额与已存支付方式，草稿编辑经创建草稿的变更落地。请求携带已登录广告主的 OAuth access token、持久化文档 id 与操作名，报文保留 campaign_group_id、adset_name、spend、impressions、reach、cpm、actions、purchase_roas、credential_id、restriction_type 等字段名。本页端点是该接口面的示意性泛化映射。

应用截图

API 端点一览

列出广告账户的广告系列
POST /v1/ads/campaigns opendata
加载所选广告账户的平面广告系列列表，填充应用首页。
认证方式：已登录广告主会话的 OAuth access token + 持久化文档 id（doc_id）与通用操作名。
- account_id
- account_status
- campaign_group_id
- campaign_group_name
- objective
- daily_budget
- spend
依据应用界面重构的示意示例，并非实时抓包。
```
POST /v1/ads/campaigns HTTP/1.1
Content-Type: application/x-www-form-urlencoded

access_token=<advertiser_session_token>&doc_id=<persisted_doc_id>&operation_name=CampaignList&variables={"account_id":"act_1234567890","first":50,"filter":"ALL"}
```
```
{
  "data": {
    "ad_account": {
      "account_id": "1234567890",
      "account_status": "ACTIVE",
      "campaign_groups": {
        "edges": [
          {"node": {"campaign_group_id": "23850123456789", "campaign_group_name": "Spring Sale — Conversions", "objective": "OUTCOME_SALES", "daily_budget": "5000", "spend": "123.45"}}
        ]
      }
    }
  }
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的广告系列列表首页重构。
- 与账户总览中展示的广告系列行（名称、目标、预算、消耗）一致。

获取广告对象的效果指标

POST /v1/ads/insights opendata

按选定的日期预设读取单个广告系列、广告组或广告的效果指标（spend、impressions、clicks、转化、ROAS）。

认证方式：已登录广告主会话的 OAuth access token + 持久化文档 id（doc_id）与通用操作名。

spend
impressions
reach
clicks
cpm
frequency
actions
action_values
purchase_roas
results
date_preset
time_increment
breakdowns

依据应用界面重构的示意示例，并非实时抓包。

POST /v1/ads/insights HTTP/1.1
Content-Type: application/x-www-form-urlencoded

access_token=<advertiser_session_token>&doc_id=<persisted_doc_id>&operation_name=AdObjectInsights&variables={"ad_object_id":"23850123456789","date_preset":"last_7d","time_increment":1}

{
  "data": {
    "ad_object": {
      "insights": {
        "spend": "412.10",
        "impressions": "58230",
        "reach": "41102",
        "clicks": "1987",
        "cpm": "7.08",
        "frequency": "1.42",
        "actions": [{"action_type": "offsite_conversion", "value": "63"}],
        "action_values": [{"action_type": "offsite_conversion", "value": "2415.30"}],
        "purchase_roas": [{"action_type": "omni_purchase", "value": "5.86"}],
        "results": [{"indicator": "actions:offsite_conversion", "value": "63"}]
      }
    }
  }
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

依据广告系列 / 广告组 / 广告效果页重构。
与选定日期预设下展示的指标表一致。

每周账户效果图表

POST /v1/ads/performance-chart opendata

以每日 spend/impressions/results 序列驱动账户首页的每周汇总图表。

认证方式：已登录广告主会话的 OAuth access token + 持久化文档 id（doc_id）与通用操作名。

account_id
performance_chart
timestamp
spend
impressions
results

依据应用界面重构的示意示例，并非实时抓包。

POST /v1/ads/performance-chart HTTP/1.1
Content-Type: application/x-www-form-urlencoded

access_token=<advertiser_session_token>&doc_id=<persisted_doc_id>&operation_name=WeeklyAccountPerformanceChart&variables={"account_id":"act_1234567890"}

{
  "data": {
    "ad_account": {
      "account_id": "1234567890",
      "performance_chart": {
        "series": [
          {"metric": "spend", "points": [{"timestamp": 1758153600, "value": "58.20"}]},
          {"metric": "impressions", "points": [{"timestamp": 1758153600, "value": "9102"}]},
          {"metric": "results", "points": [{"timestamp": 1758153600, "value": "11"}]}
        ]
      }
    }
  }
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

依据账户首页的每周汇总图表重构。

读取账单账户信息
POST /v1/billing/account openfinance
加载广告账户的账单页：未结余额、消耗上限与已存支付方式。
认证方式：已登录广告主会话的 OAuth access token + 持久化文档 id（doc_id）与通用操作名。
- current_balance
- currency
- account_spending_limit
- payment_methods
- credential_id
- credential_type
依据应用界面重构的示意示例，并非实时抓包。
```
POST /v1/billing/account HTTP/1.1
Content-Type: application/x-www-form-urlencoded

access_token=<advertiser_session_token>&doc_id=<persisted_doc_id>&operation_name=BillingAccountInfo&variables={"account_id":"act_1234567890"}
```
```
{
  "data": {
    "billing": {
      "current_balance": {"amount": "87.42", "currency": "USD"},
      "account_spending_limit": "1000.00",
      "payment_methods": [
        {"credential_id": "pm_9001", "credential_type": "CREDIT_CARD", "display": "Visa •••• 4242", "is_primary": true}
      ]
    }
  }
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的账单设置页（余额、消耗上限、支付方式）重构。

创建广告草稿

POST /v1/ads/drafts opendata

创建服务端广告草稿，让手机上的编辑得以保存并同步到桌面端 Ads Manager。

认证方式：已登录广告主会话的 OAuth access token + 持久化文档 id（doc_id）与通用操作名。

draft_id
ad_draft
account_id
objective

依据应用界面重构的示意示例，并非实时抓包。

POST /v1/ads/drafts HTTP/1.1
Content-Type: application/x-www-form-urlencoded

access_token=<advertiser_session_token>&doc_id=<persisted_doc_id>&operation_name=CreateAdDraft&variables={"input":{"account_id":"act_1234567890","ad_draft":{"name":"Weekend push — lookalike 1%","objective":"OUTCOME_TRAFFIC"}}}

{
  "data": {
    "create_ad_draft": {
      "draft_id": "99001234567890",
      "ad_draft": {"name": "Weekend push — lookalike 1%", "objective": "OUTCOME_TRAFFIC", "status": "DRAFT"}
    }
  }
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

依据广告草稿的创建与编辑流程重构。

检查广告账户合规状态
POST /v1/ads/account-standing osint
读取广告账户的状态——活跃、受限或停用——即应用警告横幅背后的数据。
认证方式：已登录广告主会话的 OAuth access token + 持久化文档 id（doc_id）与通用操作名。
- account_id
- account_status
- restriction_type
依据应用界面重构的示意示例，并非实时抓包。
```
POST /v1/ads/account-standing HTTP/1.1
Content-Type: application/x-www-form-urlencoded

access_token=<advertiser_session_token>&doc_id=<persisted_doc_id>&operation_name=AccountComplianceStatus&variables={"account_id":"act_1234567890"}
```
```
{
  "data": {
    "ad_account": {
      "account_id": "1234567890",
      "account_status": "ACTIVE",
      "restrictions": [
        {"restriction_type": "AD_ACCOUNT_SPEND_LIMIT", "appeal_eligible": true}
      ]
    }
  }
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据广告账户受限时展示的账户状态警告重构。

数据类别

广告系列
广告效果
效果图表
账单
支付方式
广告草稿
账户状态

数据使用场景与案例

跨平台消耗看板
代理商报表工具按天级 time_increment 拉取每个广告系列的 spend、impressions、reach、clicks、cpm 与 purchase_roas，把 Meta 的成效与其他渠道合并，让客户看到一个混合后的单次成效成本，而不是三个割裂的看板。
预算节奏告警
财务自动化读取广告系列列表中的 daily_budget 与累计 spend，标记消耗节奏超计划的广告系列——与应用内每周汇总效果图表背后是同一批数据。
广告账户健康监控
多账户运营方轮询每个客户账户的 account_status 与 restriction_type，账户一旦被限制立即通知值班人员，而不是等广告主自己发现应用内的封禁横幅。
账单对账
记账流水线读取 current_balance、currency、account_spending_limit 与已存的 payment_methods（credential_id、credential_type），每月将 Meta 广告发票与公司信用卡账单对齐。

常见问题

Meta Ads Manager 应用使用什么数据 API？

应用通过一个需要登录的网关调用 Meta 的 GraphQL API：每个界面发起一份具名的持久化查询文档——首页用广告系列列表查询，分对象指标用 insights 查询，余额与支付方式用账单查询。本页展示的端点是该接口面的示意性泛化映射，而非实时流量的记录。

Meta Ads Manager API 如何鉴权？

调用使用广告主的 OAuth access token 鉴权，该 token 在应用内用 Facebook 账户登录时签发。token 作为表单参数与持久化文档 id、variables 载荷一同提交；没有公开的开发者密钥——这些是一方调用，范围仅限登录用户所管理的广告账户。

应用暴露哪些效果指标？

insights 接口返回 spend、impressions、reach、clicks、cpm、frequency、actions、action_values、purchase_roas 与 results，可按日期预设（例如 last_7d）、时间范围、time_increment 与 breakdowns 过滤——与广告系列、广告组与广告详情页展示的指标行一致。

可以从应用读取账单与账户状态数据吗？

可以——账单页加载 current_balance、currency、account_spending_limit 与已存的 payment_methods（credential_id、credential_type）；账户状态接口返回 account_status 及 restriction_type 条目，广告账户被限制或停用时应用内的警告正是由这些数据驱动。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

获取报价

Meta Ads Manager 数据 API：广告系列、效果与账单

应用截图

API 端点一览

列出广告账户的广告系列

获取广告对象的效果指标

每周账户效果图表

读取账单账户信息

创建广告草稿

检查广告账户合规状态

数据类别

数据使用场景与案例

跨平台消耗看板

预算节奏告警

广告账户健康监控

账单对账

常见问题

更多电商类应用

IndiaMART - B2B Marketplace

Meta Business Suite

相关主题

需要集成这个 App 的数据 API？

Meta Ads Manager 数据 API：广告系列、效果与账单

应用截图

API 端点一览

列出广告账户的广告系列

获取广告对象的效果指标

每周账户效果图表

读取账单账户信息

创建广告草稿

检查广告账户合规状态

数据类别

数据使用场景与案例

跨平台消耗看板

预算节奏告警

广告账户健康监控

账单对账

常见问题

相关应用

更多电商类应用

IndiaMART - B2B Marketplace

Meta Business Suite

相关主题

需要集成这个 App 的数据 API？