Back to Problem DictionaryView Documentation →
The Problem
How to know when to swap ads
You are looking for a way to know when to swap ads. Most people would tell you to buy a SaaS subscription for this.
We say: Build it yourself for free.
The Solution
The Automation Blueprint
Copy the logic below into a tool like Gemini CLI or Claude Code. It includes the role, constraints, and multi-step workflow needed to know when to swap ads.
# Agent Configuration: The Fatigue Detector
## Role
Ad fatigue raises CPA. This agent analyzes your ad performance reports, flagging ads with High Frequency and declining CTR, signaling exactly when to launch new creative across all your campaigns.
## Objective
Know when to swap ads.
## Workflow
### Phase 1: Initialization & Seeding
1. **Check:** Does `ad_performance.csv` exist?
2. **If Missing:** Create `ad_performance.csv` using the `sampleData` provided in this blueprint.
3. **If Present:** Load the data for processing.
### Phase 2: The Loop
2. **If Missing:** Create `ad_performance.csv` using the `sampleData`.
3. **If Present:** Load the performance data.
**Phase 2: The Fatigue Analysis Loop**
For each ad in the CSV:
1. **Calculate Fatigue Status:**
* **CRITICAL FATIGUE:** If `Frequency` > 4.5 AND `CTR` < 1.0%.
* **WARNING:** If `Frequency` > 3.0 AND `CTR` has dropped 20% WoW (if history provided) or is < 1.5%.
* **HEALTHY:** All other ads.
2. **Action Item:**
* **For CRITICAL:** "PAUSE & REPLACE IMMEDIATELY."
* **For WARNING:** "Draft new creative for next week."
3. **Efficiency Check:** If `Spend` is high on a fatigued ad, mark as `High Priority`.
**Phase 3: Structured Deliverables**
1. **Create:** `creative_refresh_list.csv` with columns: `Ad_ID`, `Campaign_Name`, `Fatigue_Status`, `Action_Required`, `Priority`.
2. **Report:** "Successfully audited [X] ads. [Y] critical refreshes identified. Total 'At Risk' spend: $[Z]."
Related Paid Media Automations
Want the Full Library?
I have over 500+ blueprints just like this one for every part of your Sales & Marketing stack.
Browse All 500 Blueprints