meta-ad-creatives

What This Skill Does

The meta-ad-creatives skill is a comprehensive analytics engine designed for performance marketers and growth teams to track Meta (Facebook/Instagram) ad creative performance. By integrating directly with the Meta Ads API, the skill calculates essential metrics such as CPT (Cost Per Trial), CPI (Cost Per Install), IPM (Installs Per Mille), and ROAS across multiple accounts. The core value proposition is the automated calculation of 'hit rates'—the percentage of your creative inventory that performs within your defined benchmarks. By identifying which creatives are successfully scaling and which are draining budget, teams can optimize spend allocation, shorten the feedback loop for creative testing, and maintain a historical audit trail of creative health across different months and campaigns.

Installation

To integrate this skill into your environment, follow these steps:

1. Execute the installation command: clawhub install openclaw/skills/skills/fortytwode/meta-ad-creatives.
2. Configure your environment variables in your local shell or secret manager: ensure FACEBOOK_ACCESS_TOKEN, FACEBOOK_APP_ID, and FACEBOOK_APP_SECRET are properly set to grant the agent read access to your ads data.
3. Create an accounts_config.json file in your root directory. Define your client accounts, specifying the unique account_id, relevant filter patterns, and specific benchmark_value targets for each account. This ensures the agent understands your success criteria for different clients or products.

Use Cases

This skill is ideal for:

• Agency Dashboarding: Simultaneously monitoring performance for dozens of clients with varying benchmarks.
• Creative Strategy: Determining which ad hooks or visual formats are consistently hitting CPT targets.
• Trend Analysis: Comparing creative win rates month-over-month to see if your creative production is improving or stagnating.
• Budget Optimization: Quickly identifying underperforming ads that should be paused based on real-time data.

Example Prompts

1. "What is the overall hit rate for our current month campaigns across all client accounts?"
2. "Compare the creative hit rates for the last three months for the 'Fitness App' account and list the winning ads by CPT."
3. "Which creatives are underperforming for the Q1 launch and have a CPT higher than $150?"

Tips & Limitations

• Benchmark Precision: Always ensure the benchmark_value in your config reflects your current LTV/CAC goals, as this is the primary filter for identifying 'winning' creatives.
• Data Granularity: This tool provides a high-level overview of creative success; use it as a starting point to identify specific ads for deeper inspection in the Meta Ads Manager.
• Account Setup: If you manage many accounts, organize your accounts_config.json carefully to avoid API rate limits by grouping calls appropriately.
• Currency: When dealing with international accounts, ensure your currency conversion logic is updated in your script config to avoid skewed performance data.