CredentialWhere to GetUsed ForOAuth ScopeMETA_ACCESS_TOKENMeta Developer Console → Graph API Explorer → Generate TokenFetching ad performance and frequency dataads_read (read-only)META_AD_ACCOUNT_IDAds Manager URL: adsmanager.facebook.com/act_XXXXXXXXXIdentifying which account to query—
When creative has been running for 7+ days and performance is declining — or proactively when managing a portfolio of creatives. Use before scheduling creative refresh.
Get list of all active ads with performance data:
For each ad, compute:
LevelCriteriaActionFresh< 7 days OR CTR drop < 10%MonitorMild7-14 days, CTR drop 10-20%MonitorModerate14-21 days, CTR drop 20-35%Rotate SoonSevere21-28 days, CTR drop 35-50%Refresh NowDead> 28 days OR CTR drop > 50% OR Freq > 5x with CTR < 50% of baselineKill Immediately
StatusCriteriaGrowingROAS within 10% of peak, < 14 daysPeakROAS at maximum, 7-21 daysDecliningROAS decay > 5%/day, > 21 daysExpiredROAS < 50% of peak OR > 35 days
Classify all active creatives into pipeline buckets:
StatusCountActive WinnersActive DecayingRecently KilledIn Pipeline
Calculate:
Fatigue Health Table (top 15-20 creatives):
CreativeDays ActiveCurrent FreqCTR Week 1CTR NowDrop %Fatigue LevelAction
Frequency Impact Table (top 10-12 highest frequency):
CreativeFreq 1-2x CTRFreq 3-4x CTRFreq 5x+ CTRCurrent FreqDecay Rate
ROAS Decay Table (top 12-15):
CreativeLaunch DatePeak ROASCurrent ROASDays to PeakDays Since PeakDecay RateLifespan Status
Creative Inventory Table:
StatusCountActive WinnersActive DecayingRecently KilledIn Pipeline
Refresh Needs: Dying this week, dying next week, new needed, testing velocity.
Action Priority Table (top 10-12):
CreativeCurrent StatusDays Until DeathActionPriorityNew Direction
Priority: Urgent (24h), High (3d), Medium (7d), Low (monitor).
After completing analysis, store the following in session context:
KeyDescriptionExamplerotation_pipelineCreative inventory by status bucket"2 growing, 3 declining, 1 dead, 2 in pipeline"fatigue_levelPer-creative fatigue classification"Blue Banner v2: Severe; CTR drop 52%"days_until_deathEstimated days before each creative expires"Banner v3: 8 days; Banner v4: 22 days"
meta-ads-recommendation reads these keys to produce the creative rotation action plan. For new creative generation, route to meta-ads-builder.