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:

VariableDescriptionRequiredDefaultMETA_ACCESS_TOKENUser Access Token from Meta DevelopersYes-META_AD_ACCOUNT_IDAd Account ID (must start with act_)Yes-META_EVENT_NAMEThe specific conversion event to trackNooffsite_conversion.fb_pixel_custom

---

🔑 How to Get Credentials#

1. Get Access Token#

1. Go to Meta Graph API 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.
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.