A 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.
Installs into .claude/skills of the current project.
Sponsors
SSkills DirectorySkills Directory
Know which skills are safe — weekly.
SSkills DirectorySkills Directory
Is that skill safe to install?
Are you the author of Meta Ads Report?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/johnalbertini14-glitch-meta-ads-report)
# Meta Ads Analytics & Event Finder
A 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.
## 🚀 Capabilities
1. **Ad Performance Reporting:**
* Calculates **Spend**, **Conversions**, and **CAC (Cost Per Acquisition)**.
* Breaks down data by **Ad Set**.
* Supports natural language date ranges (e.g., "yesterday", "last month", "last 7 days").
2. **Event Discovery Tool:**
* Lists all raw event names (e.g., `offsite_conversion.custom...`) currently active in your ad account.
* Helps you find the exact event name to configure for conversion tracking.
---
## ⚙️ Configuration (.env)
To use this skill, you must set the following environment variables in your OpenClaw setup:
| Variable | Description | Required | Default |
| :--- | :--- | :--- | :--- |
| `META_ACCESS_TOKEN` | User Access Token from Meta Developers | **Yes** | - |
| `META_AD_ACCOUNT_ID` | Ad Account ID (must start with `act_`) | **Yes** | - |
| `META_EVENT_NAME` | The specific conversion event to track | No | `offsite_conversion.fb_pixel_custom` |
---
## 🔑 How to Get Credentials
### 1. Get Access Token
1. Go to [Meta Graph API Explorer](https://developers.facebook.com/tools/explorer/).
2. Select your App.
3. Add Permissions: `ads_read`, `read_insights`.
4. Click **Generate Access Token** and copy the string.
### 2. Get Ad Account ID
1. Go to [Facebook Ads Manager](https://adsmanager.facebook.com/).
2. Check the URL for `act=12345678`.
3. Your ID is `act_12345678` (Don't forget the `act_` prefix).
---
## 💬 Example Commands
### check Analytics
> "Show me yesterday's ad performance"
> "Calculate CAC for the last 7 days"
> "How were the ads from 2026-02-01 to 2026-02-10?"
> "Report ad spend for this month"
### Find Correct Event Name
> "List all ad events"
> "Show me available meta events"
---
## ⚠️ Troubleshooting
**Q: My conversion count is 0, but I have sales.**
**A:** The default event is `offsite_conversion.fb_pixel_custom`. Your pixel might be using a different name like `purchase`, `lead`, or `start_trial`.
1. Ask the bot: **"List all ad events"**.
2. Copy the exact raw name from the list.
3. Update your `META_EVENT_NAME` variable with that name.
