Meta Ads API

🚀 Meta廣告管理工具用戶指南

Meta廣告管理工具是一款強大的工具，可幫助用戶高效地管理Meta平臺的廣告業務，涵蓋賬戶、系列、廣告組等多方面管理功能。

🚀 快速開始

安裝包依賴

安裝Meta廣告管理工具所需的Python包：

pip install meta-ads-mcp

設置環境變量

為了方便使用，建議設置以下環境變量：

設置默認App ID

在終端中運行以下命令：

export META_APP_ID=your_app_id

設置默認訪問令牌

如果你已經有有效的訪問令牌，可以跳過OAuth身份驗證流程：

export META_ACCESS_TOKEN=your_access_token

獲取幫助信息

查看工具的使用說明和版本信息：

uvx meta-ads-mcp --help
uvx meta-ads-mcp --version

✨ 主要特性

Meta廣告管理工具提供以下核心功能：

廣告賬戶管理

• 獲取所有可用廣告賬戶：

uvx meta-ads-mcp get-ad-accounts

• 檢查特定廣告賬戶信息：

uvx meta-ads-mcp check-account-info --account-id=your_account_id

廣告系列操作

• 創建新的廣告系列：

uvx meta-ads-mcp create-campaign --name="Your Campaign Name" --objective=CPC

• 獲取所有廣告系列列表：

uvx meta-ads-mcp get-campaigns

廣告組管理

• 創建新的廣告組：

uvx meta-ads-mcp create-ad-set --campaign-id=your_campaign_id --name="Your Ad Set Name"

• 獲取所有廣告組：

uvx meta-ads-mcp get-ad-sets

📦 安裝指南

安裝包依賴

安裝Meta廣告管理工具所需的Python包：

pip install meta-ads-mcp

設置環境變量

為了方便使用，建議設置以下環境變量：

設置默認App ID

在終端中運行以下命令：

export META_APP_ID=your_app_id

設置默認訪問令牌

如果你已經有有效的訪問令牌，可以跳過OAuth身份驗證流程：

export META_ACCESS_TOKEN=your_access_token

獲取幫助信息

查看工具的使用說明和版本信息：

uvx meta-ads-mcp --help
uvx meta-ads-mcp --version

💻 使用示例

基礎用法

以下是一些基礎的命令使用示例：

# 安裝工具
pip install meta-ads-mcp

# 獲取所有可用廣告賬戶
uvx meta-ads-mcp get-ad-accounts

高級用法

創建一個帶有特定開始和結束時間的廣告系列：

uvx meta-ads-mcp create-campaign --name="Your Campaign Name" --objective=CPC --start-time=2024-01-01 --end-time=2024-12-31

📚 詳細文檔

命令參考

賬戶相關命令

uvx meta-ads-mcp get-ad-accounts --help
uvx meta-ads-mcp check-account-info --account-id=ACCOUNT_ID --help

廣告系列操作命令

uvx meta-ads-mcp create-campaign --name=CAMPAIGN_NAME --objective=OBJECTIVE [--start-time=START_TIME] [--end-time-END_TIME] --help
uvx meta-ads-mcp get-campaigns --status STATUS --fields.Fields --limit.LIMIT --help

廣告組操作命令

uvx meta-ads-mcp create-ad-set --campaign-id=CAMPAIGN_ID --name=AD_SET_NAME [--optimization-OPTIMIZATION] [--bid-strategy=BID_STRATEGY] --help
uvx meta-ads-mcp get-ad-sets --status STATUS --fields.Fields --limit.LIMIT --ad setId AD_SET_ID --help

認證問題

常見認證錯誤

如果你遇到類似(#200) Provide valid app ID的錯誤，請檢查以下幾點：

1. 確保你已正確設置Meta開發者應用。
2. 驗證是否正確傳遞了應用ID，可通過以下方式：
   • 設置環境變量：export META_APP_ID=your_app_id
   • 作為命令行參數使用：uvx meta-ads-mcp --app-id your_app_id

訪問令牌管理

• 獲取新的訪問令牌：

uvx meta-ads-mcp get-access-token

• 刷新現有令牌：

uvx meta-ads-mcp refresh-token

工具調試

日誌記錄

工具默認啟用日誌記錄功能，日誌文件位於~/.meta_ads_mcp/logs/目錄下。

錯誤報告

遇到問題時，請提供以下信息：

1. 完整的錯誤日誌。
2. 相關操作步驟。
3. 環境配置詳情（包括Python版本和包版本）。

測試與驗證

運行測試用例

uvx meta-ads-mcp run-tests

查看代碼文檔

uvx meta-ads-mcp view-docs

故障排除

網絡問題

如果遇到網絡連接問題，請檢查：

1. 確保互聯網連接正常。
2. 檢查防火牆設置，允許必要的端口通信。

數據同步延遲

某些操作可能會出現數據同步延遲，建議在執行關鍵操作前等待幾分鐘，並確保使用最新的廣告數據。

聯繫方式

如需幫助或反饋問題，請訪問我們的支持頁面：Meta Ads MCP 支持中心。