Meta Ads Weekly Performance

Required Credentials#

CredentialWhere to GetUsed ForOAuth ScopeMETA_ACCESS_TOKENMeta Developer Console → Graph API Explorer → Generate TokenFetching account and campaign insightsads_read (read-only)META_AD_ACCOUNT_IDAds Manager URL: adsmanager.facebook.com/act_XXXXXXXXXIdentifying which account to query—

When to Use#

At the end of each week (every Monday) for ongoing campaigns. Also use after a significant change (new campaign launch, major budget shift, creative swap) to document the impact.

---

Requirements#

• account_id (required)
• date_range: last_7d (default)

---

Step 1: Pull KPI Snapshot#

Fetch account and campaign level metrics for this week and prior week:

• Spend, results, cost per result
• ROAS, conversion values
• CTR, CPM, CPC
• Frequency

Calculate week-over-week (WoW) change for each metric: WoW = (This Week − Prior Week) / Prior Week × 100

---

Step 2: Identify What Changed#

Write 3-5 bullets explaining the biggest moves this week.

Format: "[What changed] — [Spend/ROAS/Revenue impact]"

Examples:

• "Increased budget on Pizza Campaign by 30% — spend up $1,200, ROAS held at 3.2x"
• "Creative rotation on Runner Audience — CTR up 0.8pp, CPL down $2.40"

---

Step 3: Identify Performance Drivers#

Identify the top 3 things driving results this week.

For each driver write one sentence with specific metrics: Format: "[What drove results] – [Spend], [ROAS], [Revenue impact vs last week]"

---

Step 4: Detect Issues#

Run issue detection:

• Campaigns with ROAS drop > 30% vs prior week
• Campaigns with spend > budget but low conversion rate
• New campaigns still in Learning Phase
• Frequency > 4 on any campaign

---

Step 5: Format Output#

Key Metrics Snapshot#

MetricThis WeekPrior WeekWoW ChangeSpendROASConversionsCPA

What Changed This Week#

• [3-5 bullets]

Performance Drivers#

• [3 bullets]

Issues and Actions Required#

• [3 urgent issues, each with problem/solution format]

---

Rules#

• No executive summary
• Specific numbers on every line
• Separate problem from solution clearly in each issue
• This is a reporting tool — recommendations route to meta-ads-recommendation