{"skill":{"slug":"meta-ads-report","displayName":"Meta Ads Report Skill","summary":"Monitor Meta ad spend, conversions, and CAC by ad set using natural language dates, plus discover active ad event names for accurate tracking.","description":"# Meta Ads Analytics & Event Finder\n\nA powerful toolkit to monitor your Meta (Facebook/Instagram) advertising performance directly through chat. This bundle includes analytics reporting and an event discovery tool to ensure accurate tracking.\n\n## 🚀 Capabilities\n\n1.  **Ad Performance Reporting:**\n    * Calculates **Spend**, **Conversions**, and **CAC (Cost Per Acquisition)**.\n    * Breaks down data by **Ad Set**.\n    * Supports natural language date ranges (e.g., \"yesterday\", \"last month\", \"last 7 days\").\n\n2.  **Event Discovery Tool:**\n    * Lists all raw event names (e.g., `offsite_conversion.custom...`) currently active in your ad account.\n    * Helps you find the exact event name to configure for conversion tracking.\n\n---\n\n## ⚙️ Configuration (.env)\n\nTo use this skill, you must set the following environment variables in your OpenClaw setup:\n\n| Variable | Description | Required | Default |\n| :--- | :--- | :--- | :--- |\n| `META_ACCESS_TOKEN` | User Access Token from Meta Developers | **Yes** | - |\n| `META_AD_ACCOUNT_ID` | Ad Account ID (must start with `act_`) | **Yes** | - |\n| `META_EVENT_NAME` | The specific conversion event to track | No | `offsite_conversion.fb_pixel_custom` |\n\n---\n\n## 🔑 How to Get Credentials\n\n### 1. Get Access Token\n1.  Go to [Meta Graph API Explorer](https://developers.facebook.com/tools/explorer/).\n2.  Select your App.\n3.  Add Permissions: `ads_read`, `read_insights`.\n4.  Click **Generate Access Token** and copy the string.\n\n### 2. Get Ad Account ID\n1.  Go to [Facebook Ads Manager](https://adsmanager.facebook.com/).\n2.  Check the URL for `act=12345678`.\n3.  Your ID is `act_12345678` (Don't forget the `act_` prefix).\n\n---\n\n## 💬 Example Commands\n\n### check Analytics\n> \"Show me yesterday's ad performance\"\n> \"Calculate CAC for the last 7 days\"\n> \"How were the ads from 2026-02-01 to 2026-02-10?\"\n> \"Report ad spend for this month\"\n\n### Find Correct Event Name\n> \"List all ad events\"\n> \"Show me available meta events\"\n\n---\n\n## ⚠️ Troubleshooting\n\n**Q: My conversion count is 0, but I have sales.**\n**A:** The default event is `offsite_conversion.fb_pixel_custom`. Your pixel might be using a different name like `purchase`, `lead`, or `start_trial`.\n1.  Ask the bot: **\"List all ad events\"**.\n2.  Copy the exact raw name from the list.\n3.  Update your `META_EVENT_NAME` variable with that name.\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":302,"installsAllTime":11,"installsCurrent":1,"stars":0,"versions":1},"createdAt":1771419807664,"updatedAt":1778491574637},"latestVersion":{"version":"1.0.0","createdAt":1771419807664,"changelog":"Meta Ads Analytics & Event Finder 1.0.0 initial release:\n\n- Provides ad performance reporting (spend, conversions, CAC), organized by ad set.\n- Supports natural language date ranges in analytics queries.\n- Includes an event finder tool to list all active event names for accurate conversion tracking.\n- Guides on required configuration and how to obtain Meta Ads credentials.\n- Example commands and troubleshooting tips included for easy onboarding.","license":null},"metadata":null,"owner":{"handle":"kein-s","userId":"s175236av696zc1wd54qbqbkbx885ard","displayName":"kein-S","image":"https://avatars.githubusercontent.com/u/34477359?v=4"},"moderation":null}