kelpi-ai/meta-ads-skills

fatigue-detector

Diagnose whether an ad is actually fatigued (two-condition rule) or you are just impatient, and decide refresh vs leave alone.

Quelltext ansehen

Verwendung

  1. Installationsbefehl kopieren und das Quellpaket vor der Installation in der eigenen Agentenumgebung prüfen.
  2. Benötigte Werkzeuge, Zugangsdaten und Hosts im Original prüfen.
  3. Eingabe und gewünschtes Ergebnis beschreiben und die Ausgabe mit den Quellen abgleichen.
npx skills add https://github.com/kelpi-ai/meta-ads-skills --skill fatigue-detector

Vor dem Start

  • Die Installation umfasst weder Modellabo noch API-Kontingent oder Dateizugriffsrechte.
  • Sterne und Installationen zeigen Aktivität, keine unabhängige Qualitäts- oder Sicherheitsprüfung.
Originales Skill-Dokument

Aus dem Quell-Repository gerendert; Überschriften, Beispiele, Code, Tabellen, Links und Bilder bleiben erhalten.

Fatigue Detector

Doctrine

"CTR down, CPM up, must be fatigue" is the most common misdiagnosis in ads. Sometimes it is the auction, the season, or a broken pixel. The two-condition rule cuts false alarms: an ad is fatigued only when frequency > 4.0 AND CTR is down 30%+ from its own baseline. Post-Andromeda, ad lifespans compressed and fatigue scales with spend more than with days, so small budgets fatigue slower than the "20 new ads a month" crowd claims. The owner's version of this pain: "the exact same ads that cost $6.85 a lead now cost $30.90."

When to use

  • A previously-working ad got expensive.
  • Before killing anything: impatience kills more winners than fatigue does.
  • Needs a Meta Ads MCP, read access.

Run it

Fatigue check, READ-ONLY, change nothing:

1. Pull frequency and CTR by ad for the last 14 days, plus each ad's CTR baseline from its best prior 14-day window.
2. Apply the two-condition rule: flag ONLY ads with frequency > 4.0 AND CTR down 30%+ from their own baseline.
3. For each flagged ad: which angle is it, how much has it spent since the decline started, and is a sibling angle still healthy?
4. For ads that LOOK tired but fail the rule: tell me the likelier cause (auction/CPM shift, seasonality, tracking change, or not enough recent spend to judge).
5. Recommend per flagged ad: refresh the creative (same angle, new execution) or retire the angle (the message is exhausted, not the image). Do not touch anything.

Guardrails

  • Read-only. Refresh and retire are human decisions.
  • Never judge an ad against another ad's baseline; fatigue is measured against the ad's own history.
  • A new execution of a dead angle is still dead. If three executions of one angle all decayed fast, the angle is done: back to Angle Writer.

Good output looks like

A short list split into "actually fatigued (here is the evidence)" and "leave it alone (here is what is really happening)".

aus demselben Repository

Weitere Skills

Alle Skills