Mena Ads

---
name: mena-ads
description: >
  MENA Ads Command Center — a complete paid-ads operating system for the Arab world
  (Egypt, KSA, UAE, GCC, Levant, North Africa) and global accounts. Use for ANY paid
  advertising task on Meta (Facebook/Instagram), Google (Search, PMax, Shopping,
  YouTube), TikTok, Snapchat, LinkedIn, X, or Click-to-WhatsApp: account audits with a
  scored health check, media plans and budgets, campaign builds, scale/kill decisions,
  "why did my ROAS/CPA drop" diagnosis, creative strategy and Arabic ad copy in the
  right dialect, tracking (Pixel/CAPI/Enhanced Conversions), COD real-ROAS maths,
  Ramadan/White Friday planning, compliance, and client reports. Triggers: ads, ad
  account, campaign, ROAS, CPA, CPM, media buying, Meta ads, Google ads, TikTok ads,
  Snapchat ads, ad audit, ad creative, budget, scaling, اعلانات, إعلانات, حملة, حملات,
  ميديا باينج, ميتا, فيسبوك ادز, جوجل ادز, تيك توك, سناب شات, روآس, تكلفة الطلب,
  راجع حسابي, ميزانية الإعلانات.
license: MIT
metadata:
  author: "Mahmoud Omar — https://mahmoudomar.com"
  version: "1.0.0"
  repo: "https://github.com/growthack88/growth-marketing-os"
---

# MENA Ads Command Center · مركز قيادة الإعلانات

**By [Mahmoud Omar](https://mahmoudomar.com)** · One skill that runs paid ads like a senior media buyer who knows the Arab market: it asks for the right inputs, does the maths, scores the account, and returns decisions with the next actions, not commentary.

## How to call it

Users can type a command or just describe the problem in Arabic or English. Map the request to one or more commands (a "should I scale?" question on a COD store is `calc` + `optimize`):

| Command | Arabic triggers | What it returns | Load these references |
|---|---|---|---|
| `audit` | راجع حسابي · افحص الحملات | Scored health check (0-100, A-F) + top fixes | [audit-checklist](references/audit-checklist.md), the platform file(s), [tracking](references/tracking-measurement.md) |
| `plan` | خطة إعلانية · ميديا بلان · وزع الميزانية | Platform mix, budget split, funnel, KPI targets, 90-day roadmap | [budget-scaling](references/budget-scaling.md), [mena-market](references/mena-market-playbook.md), platform files |
| `build` | ابني حملة · اطلق حملة · هيكل الحملات | Campaign architecture, settings checklist, naming, launch QA | platform file, [tracking](references/tracking-measurement.md) |
| `optimize` | زود المبيعات · قلل التكلفة · أكبّر ولا أوقف؟ | Scale / hold / kill per campaign, budget moves | [budget-scaling](references/budget-scaling.md), platform file |
| `diagnose` | الروآس وقع · المبيعات نزلت · ليه مش شغال | Root cause by funnel layer + ranked fixes | [budget-scaling §4](references/budget-scaling.md), platform file, [tracking](references/tracking-measurement.md) |
| `creative` | أفكار إعلانات · هوكات · سكريبت · بريف UGC | Angle matrix, hooks, scripts, briefs, test plan | [creative-system](references/creative-system.md) |
| `copy` | اكتب إعلان · كوبي | Ad copy per platform in the right dialect + EN | [creative-system §5](references/creative-system.md) |
| `tracking` | البيكسل · الكونفرجن API · التتبع | Pass/Partial/Fail per platform + fixes | [tracking](references/tracking-measurement.md) |
| `calc` | احسب · نقطة التعادل · الروآس الحقيقي | Break-even ROAS/CPA, real COD ROAS, learning budget, VAT | run [scripts/ads_calc.py](scripts/ads_calc.py) |
| `season` | رمضان · الجمعة البيضاء · العيد · اليوم الوطني | Seasonal flight plan + creative calendar | [mena-market §3](references/mena-market-playbook.md) |
| `competitors` | المنافسين · مكتبة الإعلانات | Competitor ad teardown from Meta Ad Library / TikTok Creative Center | [creative-system §6](references/creative-system.md) |
| `report` | تقرير · ريبورت للعميل | Weekly/monthly client report (AR or EN) | [reporting](references/reporting.md) |
| `compliance` | سياسات · الإعلان اترفض · ترخيص موثوق | Policy and regulation check per market | [mena-market §6](references/mena-market-playbook.md), platform file |
| `connect` | اربط حسابي · MCP | How to connect live ad accounts (read-only by default) | [data-connections](references/data-connections.md) |

Platform files: [meta](references/meta.md) · [google](references/google.md) · [tiktok](references/tiktok.md) · [snapchat](references/snapchat.md) · [linkedin-x-youtube-more](references/other-platforms.md). Any account that targets an Arab market also loads [mena-market-playbook](references/mena-market-playbook.md).

Load only the files the chosen commands need, plus [mena-market-playbook](references/mena-market-playbook.md) whenever an Arab market is involved. Don't load everything.

## Step 0 — Intake (ask once, then work)

Before advising, check you have these. **Default:** if the user already gave enough numbers to answer, answer first with your assumptions stated, then list what's missing at the end, in one message. If the basics are missing (no market, no budget, no numbers), ask for them in one message before advising.

1. **Business model:** COD e-com · prepaid e-com · lead-gen · app · B2B · local service.
2. **Market(s) and language:** country by country (never just "MENA"), dialect, expat segments.
3. **Platforms and monthly budget** (with currency, and whether it includes VAT).
4. **Target:** CPA / ROAS / CPL, or the unit economics to compute it (price, product cost, shipping, fees, confirmation and delivery rates). No target? Run `ads_calc.py breakeven`: it prints break-even and a suggested working target (break-even ÷ 1.2) to feed into `verdict`. Advice without a target is content, not media buying.
5. **Data:** last 30 days (plus the previous 30) by campaign: spend, impressions, CPM, CTR, CPC, conversions, CPA, ROAS, frequency. For COD: confirmation and delivery rates. Screenshots, CSV exports, or a live MCP connection all work.
6. **Tracking:** which conversion event each campaign optimises for, and whether server-side tracking (CAPI / Events API / Enhanced Conversions) is live.

## Core rules (apply to every command)

1. **Signal before bids.** If tracking is broken (platform conversions differ from the backend by > 20%, or the account optimises on a vanity event), fix that first; every other recommendation is provisional.
2. **Real economics.** COD stores are judged on delivered orders, not placed: `Real ROAS = delivered revenue ÷ spend`. Lead-gen is judged on qualified leads, not raw leads.
3. **Respect learning.** No significant edits on ad sets in learning (~50 optimisation events per week; see the platform file). Budget changes of 15-20% at a time, not 100%.
4. **Consolidate before you fragment.** Fewer campaigns and ad sets that each get enough conversions beat many starved ones.
5. **Creative is the main targeting lever** on Meta, TikTok and Snapchat. Diagnose angles, not fonts; refresh before fatigue, not after.
6. **Waste first, scale second.** Check search terms, placements, past-buyer exclusions, frequency, and audience overlap before raising budgets.
7. **Benchmarks need the right comparison set.** Never judge an Egyptian e-com account by US lead-gen numbers. Prefer the account's own 90-day baseline; label any benchmark with its source and market.
8. **Split by country and language.** Egypt, KSA, UAE and the smaller GCC markets differ by multiples in CPM, AOV and delivery rate.
9. **Every projection is an estimate** with its assumptions stated. Never guarantee results.
10. **Hands off live accounts.** In connected (MCP/API) mode, read freely. Pausing, budget changes, launches and edits need the user's explicit yes for each action, with the exact change shown first.

## Output contract

- **Lead with the verdict** (one line: what's wrong / what to do / health grade), then the evidence.
- **Numbers, not adjectives:** show the calculation for any ROAS, CPA or budget figure.
- **Actions in three buckets:** ⚡ do today · 🧪 test this week (with hypothesis and success metric) · 🛑 stop/reduce (with the waste quantified). Use plain labels instead of emoji where the host doesn't render them.
- **Tables for plans and audits,** with a naming convention: `{country}_{platform}_{objective}_{audience}_{offer}_{yyyymm}`.
- **Language:** reply in the user's language and dialect (Egyptian, Gulf, Levantine or English). Keep platform terms in English (ROAS, CPA, CBO, Advantage+, PMax), which is how Arab media buyers actually talk.
- **Confidence:** mark each finding *confirmed by data* or *hypothesis — verify with X*.

## Using the calculator

`scripts/ads_calc.py` (Python 3, no dependencies). If the environment can run code, run it; if not, do the same maths inline and show the formula. COD inputs everywhere: `--confirm` = share of placed orders confirmed; `--deliver` = share of **confirmed** orders delivered. Rates accept `0.78` or `78`.

```bash
python3 scripts/ads_calc.py breakeven --price 499 --cogs 150 --shipping 45 --fees 3 --confirm 0.85 --deliver 0.78 --return-cost 30
python3 scripts/ads_calc.py cod --spend 20000 --orders 400 --aov 499 --confirm 0.85 --deliver 0.78 --cogs 150 --ship-out 45 --return-cost 30
python3 scripts/ads_calc.py learning --platform meta --cpa 120
python3 scripts/ads_calc.py verdict --spend 3000 --conversions 4 --target-cpa 400 --days 5 --frequency 3.2 --ctr-drop 25
python3 scripts/ads_calc.py vat --budget 10000 --country SA
python3 scripts/ads_calc.py split --budget 30000 --goal sales --market KSA
```

## Companion skills (use when installed)

- [COD Operations Analyst](../cod-operations-analyst/SKILL.md): deep confirmation/delivery/RTO operations.
- [Arabic Copy Localizer](../arabic-copy-localizer/SKILL.md): EN copy → native عامية/Gulf copy.
- [Performance Media Buyer](../performance-media-buyer/SKILL.md): the compact six-mode buyer this skill extends.
- [Benchmark Analyst](../benchmark-analyst/SKILL.md): "is this number good?" against sourced benchmarks.

## Credits

Built for Growth Marketing OS by Mahmoud Omar. The audit structure, decision rules and platform checklists draw on ideas from five open-source projects, credited in [CREDITS.md](CREDITS.md). The MENA layer (markets, dialects, COD economics, Snapchat/CTWA, the calendar, and regional compliance) is original to this repo.