A conversational toolkit for monitoring Meta advertising performance, calculating key metrics, and identifying conversion events.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install meta-ads-report
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install meta-ads-report using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Meta Ads Analytics & Event Finder?
The Meta Ads Analytics & Event Finder is a specialized integration designed to bring real-time advertising insights directly into your AI-assisted workflow. By leveraging this addition to your Openclaw Skills library, you can bypass the complex Meta Ads Manager interface and query performance data using natural language. It serves as both a reporting engine and a diagnostic tool for developers and marketers.
This skill bridges the gap between raw API data and actionable marketing intelligence. Whether you need to audit spend across various ad sets or troubleshoot pixel tracking, this tool provides a streamlined interface to ensure your Meta advertising efforts are data-driven and accurately monitored.
Meta Ads Analytics & Event Finder Use Cases
- Tracking daily ad spend and performance across Facebook and Instagram accounts.
- Calculating real-time Cost Per Acquisition (CAC) for specific conversion windows.
- Identifying hidden or custom raw event names to fix tracking discrepancies.
- Generating quick performance summaries for ad sets using natural language commands like "yesterday" or "last month."
How Meta Ads Analytics & Event Finder Works
- The skill authenticates with the Meta Graph API using your stored access token and account ID.
- It interprets natural language date ranges into precise time increments for API requests.
- The engine fetches metrics including spend, impressions, and conversions based on your configured event name.
- It processes and calculates ROI-centric data such as CAC and organizes the output by ad set for easy analysis.
Meta Ads Analytics & Event Finder Setup
To integrate this tool into your Openclaw Skills environment, configure the following environment variables:
# Required configuration
META_ACCESS_TOKEN="your_long_lived_token"
META_AD_ACCOUNT_ID="act_12345678"
# Optional: Defaults to offsite_conversion.fb_pixel_custom
META_EVENT_NAME="purchase"
- Visit the Meta Graph API Explorer, select your App, and add permissions for
ads_readandread_insightsto generate a token. - Locate your Ad Account ID in your Ads Manager URL and ensure it includes the
act_prefix.
Meta Ads Analytics & Event Finder Data Schema & Taxonomy
The skill organizes advertising data into a structured format for clear reporting:
| Field | Description |
|---|---|
| Spend | Total advertising budget consumed in the selected currency. |
| Conversions | Total count of occurrences for the defined META_EVENT_NAME. |
| CAC | Calculated Cost Per Acquisition (Total Spend divided by Conversions). |
| Ad Set Breakdown | Performance data segmented by individual ad set names. |
| Raw Events | A list of all active event strings detected in the account for tracking setup. |
Meta Ads Analytics & Event Finder Advanced Features
- Natural language date parsing for flexible time-range reporting without manual date entry.
- Built-in Event Discovery tool to surface raw offsite conversion names used by your pixel.
- Cross-ad-set performance comparison for rapid budget optimization within Openclaw Skills.
- Troubleshooting mode to identify why conversion counts may differ from expected values.
SKILL.md
Loading
Related Openclaw Skills
Zhihu AI Bot
A comprehensive automation tool for managing Zhihu Ring interactions, including content publishing, commenting, and engagement metrics.
paradiz
An automated VK interaction skill that calculates hotel stay costs from Excel price lists and manages the full booking lifecycle.
Breeze x402 Payment API
A payment-gated API skill for interacting with the Breeze Solana yield aggregator using x402 USDC micropayments.
Breeze x402 Payment API
A specialized skill for interacting with Breeze payment-gated endpoints to manage Solana investment positions and execute x402 API calls.
Mac Use
A powerful macOS automation skill that uses Apple Vision OCR to visually interact with any graphical desktop application.
Twitter Web AutoPoster
A specialized automation skill that enables AI agents to scrape trends, draft tweets, and publish posts directly to Twitter/X using browser-based interactions.
Featured*
