Meta Ads Report

What This Skill Does

The Meta Ads Report skill by kein-s serves as a powerful interface between your OpenClaw AI agent and the Meta Marketing API. It simplifies the complex task of monitoring paid media performance by translating natural language queries into specific data requests. Whether you are an advertiser, agency owner, or marketing analyst, this tool provides real-time access to crucial metrics such as total spend, conversion volumes, and the all-important Cost Per Acquisition (CAC). Beyond basic reporting, the skill offers a technical debugging layer through its Event Discovery tool, which allows you to audit the raw tracking events flowing into your pixel or Conversion API setup.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface. Ensure your OpenClaw agent is initialized and then execute the following command: clawhub install openclaw/skills/skills/kein-s/meta-ads-report

After installation, you must configure your environment variables. Open your .env file and input your META_ACCESS_TOKEN and META_AD_ACCOUNT_ID. Ensure the access token includes the ads_read and read_insights permissions granted via the Meta Graph API Explorer.

Use Cases

This skill is designed for rapid performance analysis without the need to manually login to Facebook Ads Manager. You can use it to perform daily budget pacing, quickly verify if a conversion event is firing correctly after a pixel migration, or generate ad-hoc reports for ad sets that are underperforming. It is particularly effective for teams that need to aggregate ad account metrics across multiple timeframes while keeping communication contained within their chat environment.

Example Prompts

1. "Calculate my CAC and total ad spend for the last 7 days."
2. "What was the performance of my ad sets for yesterday?"
3. "List all available tracking events so I can verify my purchase pixel is set up correctly."

Tips & Limitations

The primary limitation of this tool is its reliance on the accuracy of your environment variable configuration. If conversion data appears as zero, always run the "List all ad events" command to ensure you have mapped the correct event string (e.g., changing the default from offsite_conversion.fb_pixel_custom to your specific event name like purchase). Note that data retrieval is limited by the permissions granted to your access token; ensure your app in the Meta Developers portal is configured with appropriate production-level access.