Meta Ads

What This Skill Does

The Meta Ads skill provides an end-to-end interface for the Meta Marketing API, enabling users to interact with their Facebook and Instagram advertising infrastructure directly through OpenClaw. This skill abstracts the complexity of Graph API calls, allowing for the granular management of campaigns, ad sets, and individual ad creatives. It supports both read and write operations, meaning you can pull performance metrics for data analysis or push updates to campaign budgets, status, and bidding strategies in real-time. By leveraging either User Access Tokens or production-grade System User Tokens, this skill serves as a programmatic bridge between your AI agent and the Meta ecosystem, facilitating automated ad ops workflows.

Installation

To integrate this skill, use the OpenClaw command-line interface. Ensure you have your Meta credentials ready before executing the installation:

clawhub install openclaw/skills/skills/zachgodsell93/meta-ads

Post-installation, you must configure your environment variables within the skill settings: META_ACCESS_TOKEN and META_AD_ACCOUNT_ID. Please ensure the token possesses both ads_read and ads_management scopes, as these are critical for write operations.

Use Cases

• Automated Budget Adjustment: Dynamically increase or decrease ad spend based on real-time ROAS or CPA thresholds.
• Performance Reporting: Automatically synthesize campaign performance data into a formatted summary for stakeholder review.
• Campaign Scaling: Clone high-performing campaigns or create new ad sets across multiple accounts simultaneously.
• Status Management: Pause underperforming ads instantly to prevent budget wastage outside of manual monitoring hours.

Example Prompts

1. "Check the current spend and performance metrics for all active campaigns in my account over the last 7 days and summarize which campaign has the lowest CPA."
2. "Pause the campaign with ID 123456789 immediately because its frequency has exceeded 3.0."
3. "Create a new draft campaign named 'Summer Sale 2024' with an objective of 'OUTCOME_TRAFFIC' and set the status to paused for manual review."

Tips & Limitations

• Rate Limiting: Always be mindful of Meta's Graph API rate limits. High-frequency automated calls may trigger throttling, so implement backoff logic if processing large volumes of data.
• Prefixing: Remember that the Meta API expects ad account IDs to be prefixed with act_. Ensure your META_AD_ACCOUNT_ID variable follows this format if required by your implementation.
• Token Expiry: If using short-lived User Access Tokens, ensure your workflow accounts for token refreshing. We strongly recommend using System User Tokens for production to maintain uninterrupted access.