# 广告 CLI

*更新时间: 2026年4月29日*

**Ads CLI 是一个命令行工具** 用于从你的终端管理 Meta 广告。它为 Meta 营销 API 提供了一个开发者友好的界面，让你可以从头到尾创建广告，管理商品目录和 Meta Pixel 像素代码，并查询成效分析。广告 CLI 帮助你建立集成和扩大现有应用运营。

广告 CLI 是为开发者编程式管理广告：

- **正在构建广告管理集成** 且希望在编写应用程序代码之前从终端对市场营销 API 工作流程进行原型设计和测试的开发者
- **运营团队**：需要通过脚本和 CI/CD 管线自动执行广告系列的创建、监控和清理工作
- **AI 代理和工具** 通过结构化命令行界面与 Meta 广告功能互动

## 主要功能

### 完整的广告生命周期管理

创建、读取、更新和删除整个 Meta 广告层级的资源 - 广告系列、广告组、广告和广告创意。每个资源都支持端到端管理它所需的操作。

| 资源 | 操作 |
| --- | --- |
| 广告系列 | `list`, `create`, `get`, `update`, `delete` |
| 广告组 | `list`、`create`（包含定位、Pixel 像素代码、转化追踪）、`get`、`update`、`delete` |
| 广告 | `list`、`create`（含追踪参数）、`get`、`update`、`delete` |
| 广告创意 | `list`, `create`, `get`, `update`, `delete` |
| 成效分析 | `get`（包含日期范围、细分条件和自定义字段） |
| 商品目录 | `list`, `create`, `get`, `update`, `delete` |
| 产品项目 | `list`, `create`, `get`, `update`, `delete` |
| 商品系列 | `list`, `create`, `get`, `update`, `delete` |
| 数据集(像素) | `list`, `create`, `get`, `connect`, `disconnect`, `assign-user` |
| 广告账户 | `list`, `get`, `current` |
| Facebook 业务主页 | `list`, `get` |

### 性能分析

- 使用灵活日期范围、细分数据和自定义指标查询广告表现数据
- 按广告系列、广告组或个人广告筛选
- 为你需要的数据排序和限制结果

### 产品目录和转化追踪

- 管理进阶赋能型目录广告的商品目录
- 创建数据集(Pixel 像素)用于转化追踪
- 把数据集绑定到广告帐户和目录
- 分配数据集的用户权限

### 自动化准备就绪

广告 CLI 专为脚本和自动化设计：

- `--no-input` 和 `--force` 标记会在无人值守操作时抑制互动提示
- 三种输出格式：`table` 供交互式使用，`json` 供管道传输至 `jq` 及其他工具，`plain`（制表符分隔）供 Unix 管道使用
- 脚本中可靠的错误处理的一致退出代码(0-5)
- `.env` 文件支持跨环境管理凭证

## 运作方式

广告 CLI 用 Meta 系统用户访问口令验证并代表你调用营销 API。命令结构遵循名词-动词模式：

```
meta ads <resource> <action> [options]
```

例如，`meta ads campaign list` 会列出您的广告系列，而 `meta ads creative create --name "My Ad" --page-id <PAGE_ID> --image ./banner.jpg` 会创建一个广告创意。

所有命令都需要一个广告帐户编号，你可以将它设置为环境变量或通过每个命令。广告 CLI 尽可能通过你的广告帐户解决目录和数据集操作的业务编号。

## 后续步骤

- [入门指南](https://developers.facebook.com/documentation/ads-commerce/ads-ai-connectors/ads-cli/setup/get-started) -- 安装和身份验证
- [配置](https://developers.facebook.com/documentation/ads-commerce/ads-ai-connectors/ads-cli/setup/configuration) -- 环境变量和配置优先级
- [命令参考文档](https://developers.facebook.com/documentation/ads-commerce/ads-ai-connectors/ads-cli/command-reference) — 各个命令、选项和参数
- [教程和技巧](https://developers.facebook.com/documentation/ads-commerce/ads-ai-connectors/ads-cli/tutorials-and-recipes) — 常见任务的分步工作流程
- [广告创意](https://developers.facebook.com/documentation/ads-commerce/ads-ai-connectors/ads-cli/ad-creatives) -- 图片、视频和广告创意管理
- [数据集和目录](https://developers.facebook.com/documentation/ads-commerce/ads-ai-connectors/ads-cli/datasets-and-catalogs) — 转化追踪和商品目录管理
- [成效分析](https://developers.facebook.com/documentation/ads-commerce/ads-ai-connectors/ads-cli/insights) — 查询广告表现成效分析