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

Meta Platforms, Inc. · 企业办公

Meta Ads Manager 是 Meta Platforms, Inc. 官方推出的手机端广告管理应用，是桌面版 Ads Manager 的移动搭档，用来随时随地运营 Facebook 与 Instagram 广告。首页按所选广告账户列出全部广告系列，展示名称、营销目标、预算与消耗，旁边的每周汇总标签页用图表画出每日消耗、展示次数与成效；点进任一广告系列、广告组或广告，即可按选定日期范围查看覆盖人数、点击量、千次展示成本、频次、转化与广告支出回报率。广告主可以在手机上新建和编辑广告草稿并同步回桌面端，处理账单——未结余额、账户消耗上限、已绑定的银行卡与充值——并在广告账户被限制或停用的第一时间看到警告横幅，还能知道该限制是否可以申诉。应用在美国区上架，服务于在 Meta 社交平台上买量的小商家、企业内部营销团队与广告代理商，也包括同时打理多个客户广告账户、离开办公桌也要盯住消耗节奏与账户健康的运营人员；它与 Google Ads、TikTok Ads Manager 等自助投放工具竞争同一批广告预算，而更轻量的主页管理与帖子推广则由 Meta Business Suite 承担。

消耗、展示、点击与 ROAS 是这个应用读写的一切数据的中心：广告账户下的平面广告系列列表以 campaign_group_id 为键，每行带 campaign_group_name、objective（例如 OUTCOME_SALES）、daily_budget 与累计 spend；任一广告系列、广告组或广告的分对象效果数据返回 spend、impressions、reach、clicks、cpm、frequency、actions、action_values、purchase_roas 与 results，可按 date_preset、time_increment 与 breakdowns 切分；每周 performance_chart 则给出一串带 timestamp 的每日消耗、展示与成效数据点。

与效果指标并列的是资金与账户状态：账单记录给出 current_balance 及其 currency、account_spending_limit，以及以 credential_id 和 credential_type 标识的已存 payment_methods；服务端广告草稿返回 draft_id 与 ad_draft 正文，手机上的编辑正是借此保存并同步回桌面；合规记录则把 account_status 与每条 restriction_type 配在一起，账户被限制或停用时应用内警告横幅背后的就是它。

代理商报表工具按天级 time_increment 拉取每个广告系列的消耗、覆盖与 purchase_roas，与其他渠道合并成一个混合单次成效成本看板；财务自动化把 daily_budget 与累计消耗对比，标记消耗节奏超计划的广告系列；多账户运营方轮询所有客户账户的 account_status 与 restriction_type，账户一受限就呼叫值班人员；记账流水线每月用 current_balance、currency、account_spending_limit 与已存支付方式核对公司信用卡账单。openData Studio 把这套广告账户数据变成可调用的开放数据，让这些看板、节奏告警与对账读到的正是应用里显示的同一组数字。

应用截图

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 条目，广告账户被限制或停用时应用内的警告正是由这些数据驱动。

与 Meta Ads Manager 相似的应用

Google Ads — Google Ads 是 Alphabet 的投放平台，覆盖搜索、购物和 YouTube，面向已经在找购买意向的用户。
TikTok Ads Manager — TikTok Ads Manager 是字节跳动的投放工具，用于在 TikTok 上创建和投放短视频广告。
Meta Business Suite — Meta Business Suite 是 Meta 管理 Facebook 主页和 Instagram 账号的后台，提供发帖、收件箱和简化的帖子推广，而不是完整的广告投放控制。
LinkedIn Ads — LinkedIn Ads 让广告主按职位和公司筛选，触达职场用户。
Amazon Ads — Amazon Ads 在亚马逊店面投放商品广告和零售广告，靠近结账环节。
Pinterest Ads — Pinterest Ads 投放在视觉发现信息流上，覆盖家居、婚礼等生活与购物品类。
Snapchat Ads Manager — Snapchat Ads Manager 用于在 Snapchat 上投放广告，常作为触达更年轻用户的渠道。
Microsoft Advertising — Microsoft Advertising 是搜索网络广告平台，在 Bing 及合作站点上投放搜索广告。

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

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

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

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

应用截图

API 端点一览

列出广告账户的广告系列

获取广告对象的效果指标

每周账户效果图表

读取账单账户信息

创建广告草稿

检查广告账户合规状态

数据类别

数据使用场景与案例

跨平台消耗看板

预算节奏告警

广告账户健康监控

账单对账

常见问题

与 Meta Ads Manager 相似的应用

更多企业办公类应用

ADP Mobile Solutions

Box

CryptoRush: Crypto Simulator

Darwinbox

相关主题

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

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

应用截图

API 端点一览

列出广告账户的广告系列

获取广告对象的效果指标

每周账户效果图表

读取账单账户信息

创建广告草稿

检查广告账户合规状态

数据类别

数据使用场景与案例

跨平台消耗看板

预算节奏告警

广告账户健康监控

账单对账

常见问题

相关应用

与 Meta Ads Manager 相似的应用

更多企业办公类应用

ADP Mobile Solutions

Box

CryptoRush: Crypto Simulator

Darwinbox

相关主题

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