1. 开始使用营销 API

更新时间：2026年6月16日

要使用市场营销 API，你必须遵循一些关键步骤来设置你的环境并获得 API 功能的访问权限。本部分概述了开始使用此 API 的必要前提条件。

广告帐户要求

如要通过市场营销 API 管理广告，您必须拥有活跃广告账户，才能投放广告系列和管理账单。广告账户可以让你追踪广告费用，监控表现，优化广告系列。

寻找你的广告账号

在 Meta 广告管理工具中查找您的广告账户编号。

登录 Facebook：先登录与您的公司关联的 Facebook 账户。
访问广告管理工具：在 Facebook 首页或业务公共主页右上角的下拉菜单中找到"广告管理工具"。
找到广告账户：在广告管理工具中，点击屏幕左下方菜单中的广告账户"设置"。
查看广告账户信息：在"设置"屏幕中，您的广告账户编号显示在"账户概览"部分，其他详细信息也会显示，例如账单信息和花费限额。

Meta 开发者账户

详情请参阅注册成为 Meta 开发者。

创建应用

参阅创建应用，详细了解如何在应用面板中设置应用以及应用类型和用例。

授权和认证

请参见授权了解更多关于验证将访问市场营销 API 并授予他们权限的用户和应用程序的信息。

参见身份验证了解更多关于使用营销 API 获取、扩展和更新访问口令的信息。

2. 授权

更新时间：2026年5月5日

⚠️ 此页面的内容已使用 AI 从英语翻译为其他语言。

广告管理标准访问权现已更名为市场营销 API 访问等级 — 无需更改代码。
"标准访问级别"现为受限访问级别，"高级访问级别"现为完全访问级别。
完整访问权限的资格要求已从过去 15 天 1,500 次市场营销 API 调用降至 500 次。

授权流程验证将访问市场营销 API 的用户和应用，并向其授予权限。

应用身份

在应用的面板中，你可以根据需要为自己或团队成员设置角色：管理员、开发者、测试员。

注意：根据预期用例，您可能需要提交应用进行审核，才能获得与广告管理相关的特定权限。

访问级别、权限和功能

业务应用需要进行额外一层图谱 API 授权，称为访问级别。在应用审核期间，您的应用还必须请求特定的权限和功能。

所有开发者都必须遵守全部 Meta 开放平台条款和开发者政策。无论请求哪种级别的访问权限，均是针对生产数据而言。

市场营销 API 访问层级概览

市场营销 API 访问级控制你的流量限制、商务管理平台访问权限和系统用户容量。

	有限访问（默认）	完全访问权限（应用审核后）
如何获取	将营销 API 产品添加到你的应用时自动授予。	在"应用面板"中，点击"市场营销 API 访问级别"功能旁边的 + 升级。您的应用必须满足要求。
流量限制	每个广告账户受到的流量限制程度较重。仅用于开发。	每个广告账户受到的流量限制程度较轻。
账户限制	可管理不限数量的广告账户。	可管理不限数量的广告账户（需获取 `ads_read` 或 `ads_management` 权限）。
商务管理平台	对业务经理和目录 API 的访问有限。	访问所有业务经理和 Catalog API。
系统用户	可以创建 1 个系统用户和 1 个管理员级系统用户。	可以创建 10 个系统用户和 1 个管理员级系统用户。
公共主页创建	无法通过此 API 创建公共主页。	无法通过此 API 创建公共主页。

获得完整访问权限

为了获得市场营销 API 访问级别的完全访问权限，你的应用需要满足这些要求：

过去 15 天内成功至少 500 次营销 API 调用。
在过去的 500 次调用中，错误率低于 15%。

如果您要管理其他用户的广告，请使用 scope 参数提醒用户授予 ads_management 或 ads_read 权限。

https://www.facebook.com/v25.0/dialog/oauth?
  client_id=<YOUR_APP_ID>&redirect_uri=<YOUR_URL>&scope=ads_management

用例示例

用例	请求内容
想要读取并管理归自己广告账户的广告	权限：`ads_management` 功能：市场营销 API 访问级别
想要读取自己广告账户的广告报告	权限：`ads_read` 功能：市场营销 API 访问级别
想要提取一组客户的广告报告并管理另一组客户的广告	权限：`ads_management` 和 `ads_read`

公司验证

我们会通过公司验证流程来验证您的公司实体身份。

3. 身份验证

更新时间：2026年6月24日

每个营销 API 调用都需要一个访问口令作为参数。有关各种类型的访问口令的更多信息，请参见 Meta Technologies 的访问口令。

为你的应用获取访问口令

用户访问口令

图谱 API 探索工具

您可以使用图谱 API 探索工具来获取用户访问口令。

在 Meta 应用 字段中，选择要获取访问口令的应用。
在 用户或公共主页 字段中，选择 用户口令。
在 添加权限 下的权限下拉列表中，选择您需要的权限（例如 ads_read 或 ads_management）。
点击 生成访问口令。存储口令供以后使用。

调试

点击口令前面的信息图标（i）打开 访问口令信息 表格，或跳转到访问口令调试工具。

调试时可以检查：应用编号、到期时间（短期口令有效期为一到两小时）、范围（包含的权限）。

延长访问口令期限

将您的口令粘贴到访问口令调试工具中，然后点击调试。
点击 延长访问口令期限，获取一个长期口令。

系统用户访问口令

系统用户访问口令是一种与系统用户帐户关联的访问口令，在 Meta Business Suite 中创建，用于管理资产和调用营销 API。对于无需对任何用户执行身份验证的服务器到服务器交互非常有用。

系统用户访问口令不会过期，且失效的可能性比长寿的用户访问口令更小。

详情请参阅系统用户。

为你管理的广告帐户获取访问口令

当广告账户所有者点击允许后，会跳转到包含授权码的网址：

http://YOUR_URL?code=<AUTHORIZATION_CODE>

然后换取访问口令：

https://graph.facebook.com/v25.0/oauth/access_token?
  client_id=<YOUR_APP_ID>&redirect_uri=<YOUR_URL>
  &client_secret=<YOUR_APP_SECRET>&code=<AUTHORIZATION_CODE>

储存令牌

访问口令应该安全地存储在您的数据库中，通过 HTTPS 安全传输。定期检查口令有效期，在必要时提示用户更新权限。

永久口令在以下情况也可能失效：密码更改、用户撤销权限。

安全证书管理的最佳实践

使用 HTTPS：始终通过安全连接传输访问口令。
安全存储口令：利用加密数据库存储访问口令。
限制口令范围：仅请求应用正常运行所必需的权限。
实现口令到期：定期刷新口令，设置处理口令过期的机制。

4. 基本广告创建

更新时间：2026年6月24日

如需使用营销 API 创建广告，请设置广告系列、广告组和广告创意。本文档涵盖了每个包含代码示例的组件。

广告创建端点

市场营销 API 提供了几个端点来创建和管理广告活动。主要的创建端点包括 campaigns、adsets 和 ads。

`campaigns` 端点

使用 campaigns 端点创建和管理广告系列。设置总体目标，例如品牌知名度或转化量。

API 请求示例：

curl -X POST \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/campaigns \
  -F 'name=My Campaign' \
  -F 'objective=LINK_CLICKS' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>'

`adsets` 端点

adsets 端点根据特定的定位条件和预算分配在广告系列中组织广告。

API 请求示例：

curl -X POST \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adsets \
  -F 'name=My Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=1000' \
  -F 'targeting={"geo_locations":{"countries":["US"]}}' \
  -F 'access_token=<ACCESS_TOKEN>'

`ads` 端点

使用 ads endpoint 创建广告，定义广告创意，并将其链接到适当的广告组。

API 请求示例：

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

5. 创建广告系列

更新时间：2026年6月24日

发布广告系列的第一步是使用 API 创建广告系列。向 /act_<AD_ACCOUNT_ID>/campaigns 端点发送 POST 请求，加入 name、objective 和 status 参数。

API 请求示例：

curl -X POST \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/campaigns \
  -F 'name=My Campaign' \
  -F 'objective=LINK_CLICKS' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>'

必要参数

名称	描述
`name`	广告系列的名称。
`objective`	广告系列的目标，例如 `LINK_CLICKS`。
`status`	初始状态。设为 `PAUSED` 在完成设置前保持不活跃。

6. 创建广告组

更新时间：2026年6月24日

创建广告系列后，下一步是创建一个广告组来添加到广告系列。该广告组中包含广告系列的竞价、定位和预算信息。

向 /act_<AD_ACCOUNT_ID>/adsets 端点发送 POST 请求，指定 name、campaign_id、targeting 和 daily_budget 参数。

API 请求示例：

curl -X POST \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adsets \
  -F 'name=My Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=1000' \
  -F 'targeting={"geo_locations":{"countries":["US"]}}' \
  -F 'access_token=<ACCESS_TOKEN>'

必要参数

名称	描述
`name`	广告组的名称。
`campaign_id`	广告组所属广告系列的编号。
`daily_budget`	指定的单日预算（以美分为单位）。
`targeting`	基于地理位置的目标受众。

7. 创建广告创意

更新时间：2026年6月24日

广告创意定义广告中显示的视觉和文本元素。指定广告格式，例如图片、视频或轮播。每种格式都有各自的设计要求。

向 /act_<AD_ACCOUNT_ID>/adcreatives 端点发送 POST 请求。参数包括 name、message、图片或视频网址、call_to_action 按钮和目标位置网址。

API 请求示例：

curl -X POST \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives \
  -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>'

在这个有效负载中，object_story_spec 指定广告故事的格式，并包括链接广告的链接详情以及相关的元数据。

必要参数

名称	描述
`name`	广告的名称。
`object_story_spec`	广告创意的参数。

8. 创建广告

更新时间：2026年6月24日

如需创建广告，请将现有广告组和广告创意合并。向 /act_<AD_ACCOUNT_ID>/ads 端点发送 POST 请求，加入 adset_id 和 creative 等参数。

API 请求示例：

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

必要参数

名称	描述
`adset_id`	投放广告的广告组编号。
`creative`	包含用于该广告的创意编号。
`status`	设为 `ACTIVE` 发布广告，`PAUSED` 保持暂停。

9. 广告系列管理

更新时间：2026年6月24日

通过市场营销 API 管理广告系列涉及几个关键操作：修改广告系列设置；暂停、恢复和删除广告系列。

修改广告系列

向 /<CAMPAIGN_ID> 端点发送 POST 请求，可更改目标、预算和定位属性。

API 请求示例：

curl -X POST \
  https://graph.facebook.com/v25.0/<CAMPAIGN_ID> \
  -F 'objective=CONVERSIONS' \
  -F 'daily_budget=2000' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>'

暂停广告系列

将状态更新为 PAUSED 以暂停广告系列。恢复时设为 ACTIVE。

curl -X POST \
  https://graph.facebook.com/v25.0/<CAMPAIGN_ID> \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>'

将广告系列归档

将状态参数设为 ARCHIVED 可归档广告系列。恢复时重新设为 ACTIVE。

curl -X POST \
  https://graph.facebook.com/v25.0/<CAMPAIGN_ID> \
  -F 'status=ARCHIVED' \
  -F 'access_token=<ACCESS_TOKEN>'

删除广告系列

警告：删除操作无法撤销。删除前请仔细检查广告系列编号。

curl -X DELETE \
  https://graph.facebook.com/v25.0/<CAMPAIGN_ID> \
  -F 'access_token=<ACCESS_TOKEN>'

10. 广告优化基础知识

更新时间：2026年6月26日

营销 API 提供端点来管理受众和分析广告成效分析。使用这些端点优化你的广告策略。

广告优化端点

`customaudiences` 端点

使用 customaudiences 端点创建和管理自定义受众和类似受众。

API 请求示例：

curl -X POST \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/customaudiences \
  -F 'name=My Custom Audience' \
  -F 'subtype=CUSTOM' \
  -F 'access_token=<ACCESS_TOKEN>'

`insights` 端点

insights endpoint提供关于广告系列、广告组和广告表现的分析，追踪关键指标如展示次数、点击量和转化量。

API 请求示例：

curl -X GET \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/insights \
  -F 'fields=impressions,clicks,spend' \
  -F 'time_range={"since":"2023-01-01","until":"2023-12-31"}' \
  -F 'access_token=<ACCESS_TOKEN>'

11. 监测和分析

更新时间：2026年6月16日

使用 Insights API 监控广告系列的表现，你可以收集关于广告投放工作的表现数据，从而评估哪些有效，哪些无效。

查询分析数据

向 /act_<AD_ACCOUNT_ID>/insights 端点发送 GET 请求，可加入 fields、time_range 以及 level 等参数来获取定制响应。通过指定 impressions、clicks 和 spend 等字段，深入了解广告表现。

API 请求示例：

curl -X GET \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/insights \
  -F 'fields=impressions,clicks,spend,ctr,cpc' \
  -F 'time_range={"since":"2023-01-01","until":"2023-12-31"}' \
  -F 'level=campaign' \
  -F 'access_token=<ACCESS_TOKEN>'

解读结果

关键的表现指标（KPI），如点击率（CTR）、单次点击费用（CPC）和广告花费回报（ROAS）提供深入了解广告系列如何有效地推动用户参与和转化。低点击率表示广告创意没有吸引目标受众。

使用成效分析进行中的优化

通过持续监控表现数据，您可以发现趋势并做出明智的调整。如果某些广告带来了高互动量但产生转化量较低，可尝试使用不同的行动号召，或改善定位参数。

成效分析还可以帮助指导预算分配。如果特定人口统计数据显示更高的参与率，重新分配预算给这些细分可以改善广告成效。

12. 优化建议

更新时间：2026年6月26日

如要通过市场营销 API 最大限度提升广告效果，需要包括受众定位、预算分配、广告创意和实时优化的战略方法。

受众定位

使用自定义受众：根据用户与您商家的互动（如网站访客或应用用户）创建自定义受众，确保广告覆盖已经熟悉你的服务的个人。
细分你的受众：使用人口筛选器（年龄、性别、位置和兴趣）来细分你的受众，提高互动和转化的几率。
类似受众：创建 lookalike audiences 来触达与你最佳现有客户相似的新潜在客户。

预算分配

设定明确的目标：明确定义每个广告系列的目标并相应分配预算。
监测表现：根据表现出色的广告或广告组来调整预算，将资金转移到表现优异的领域。
日常预算管理：考虑设置每日预算以控制开支和防止超支。

广告创意

高品质的视觉效果：投资优质图片和视频，提高点击率，优化创意以同时适用于桌面和移动设备。
A/B 测试：持续测试不同的广告创意、标题和行动号召，识别表现最佳的变体。
动态创意：使用根据用户行为自动显示表现最佳创意版本的动态广告格式。

用于优化的实时数据

充分利用成效分析 API：使用 Insights API 收集实时数据，分析展示次数、点击量和转化量等指标。
调整广告系列中期定位：如果某些人口统计数据表现更佳，在广告系列投放期间实时调整定位参数。
定期报告：设置定期报告面板以监控广告系列表现，发现趋势和需要改进之处。

转化 API

转化 API 在广告主的服务器、网站平台、移动应用或 CRM 到 Meta 系统的营销数据之间建立了连接，以优化广告定位、降低单次成效费用和衡量成效。

欲了解更多关于转化 API，请参阅转化 API 文档。

← 上一篇 📄 API 参考文档 →

⚠️ 查看完整错误代码参考

1. 开始使用营销 API

广告帐户要求

寻找你的广告账号

Meta 开发者账户

创建应用

授权和认证

继续学习

2. 授权

应用身份

访问级别、权限和功能

市场营销 API 访问层级概览

获得完整访问权限

用例示例

公司验证

3. 身份验证

为你的应用获取访问口令

用户访问口令

图谱 API 探索工具

调试

延长访问口令期限

系统用户访问口令

为你管理的广告帐户获取访问口令

储存令牌

安全证书管理的最佳实践

4. 基本广告创建

广告创建端点

campaigns 端点

adsets 端点

ads 端点

5. 创建广告系列

必要参数

6. 创建广告组

必要参数

7. 创建广告创意

必要参数

8. 创建广告

必要参数

9. 广告系列管理

修改广告系列

暂停广告系列

将广告系列归档

删除广告系列

10. 广告优化基础知识

广告优化端点

customaudiences 端点

insights 端点

11. 监测和分析

查询分析数据

解读结果

使用成效分析进行中的优化

12. 优化建议

受众定位

预算分配

广告创意

用于优化的实时数据

转化 API

`campaigns` 端点

`adsets` 端点

`ads` 端点

`customaudiences` 端点

`insights` 端点