Meta Ads API

🚀 Meta広告管理ツールユーザーガイド

Meta広告管理ツールは、Metaの広告アカウント、キャンペーン、広告セットを管理するための便利なツールです。このツールを使用することで、広告の作成、管理、モニタリングが簡単に行えます。

🚀 クイックスタート

📦 インストール

Meta広告管理ツールを使用するには、まず必要なPythonパッケージをインストールする必要があります。以下のコマンドを実行してください。

pip install meta-ads-mcp

⚙️ 環境変数の設定

使いやすくするために、いくつかの環境変数を設定することをおすすめします。

デフォルトのApp IDの設定

以下のコマンドをターミナルで実行して、デフォルトの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

✨ 主な機能

広告アカウント管理

• すべての利用可能な広告アカウントの取得

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

📚 ドキュメント

アカウント関連コマンド

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 サポートセンター