Der Stale-Copy-Wächter für dein Konto.

/**
 * STALE-COPY-WAECHTER — Google Ads Script
 * Version 1.0.0 · Stand 2026-08-30
 * https://visnakovs.de/google-ads-scripts/stale-copy-waechter/
 *
 * Findet Anzeigentexte, die die Zeit ueberholt hat: abgelaufene Jahreszahlen,
 * Saison- und Feiertagsaktionen ausserhalb ihrer Saison und Fristen, die
 * vorbei sind. Geprueft werden die Titel und Beschreibungen aller aktiven
 * Responsive Suchanzeigen in aktiven Anzeigengruppen aktiver Kampagnen.
 *
 * ⛔ GARANTIE — Dieses Skript verändert nichts in deinem Konto: Es liest, es
 * protokolliert, es schreibt nicht. Es kommt kein einziger Aufruf darin vor,
 * der eine Anzeige, ein Keyword, ein Gebot, ein Budget oder ein Label
 * anfassen koennte. Die einzigen Ausgaben sind das Protokoll und - wenn du
 * es unten einschaltest - eine E-Mail an dich selbst.
 *
 * Getestet gegen Google Ads Scripts, Stand 08/2026.
 *
 * Umlaute stehen in diesem Code bewusst als ae/oe/ue: der Script-Editor
 * zeigt kopierte Dateien je nach Browser in wechselnder Kodierung an, und
 * ein kaputtes Sonderzeichen in einem Suchmuster faellt still aus. In den
 * Suchtabellen unten stehen die echten Umlaute - dort werden sie gebraucht.
 */

// ---------------------------------------------------------------------------
// CONFIG — alles, was du anfassen solltest, steht hier oben.
// ---------------------------------------------------------------------------
var CONFIG = {
  // E-Mail-Zusammenfassung. Bewusst AUS: ein Skript, das beim ersten Lauf
  // ungefragt Post verschickt, ist ein schlechter Gast. Erst pruefen, was im
  // Protokoll steht, dann einschalten.
  EMAIL_SENDEN: false,
  EMPFAENGER: 'dein.name@beispiel.de',
  BETREFF: 'Google Ads: veraltete Anzeigentexte',

  // Erst ab so vielen Funden ueberhaupt eine Mail. 0 = auch die Entwarnung
  // schicken (sinnvoll, wenn du das Ausbleiben der Mail nicht als Ergebnis
  // lesen willst - ein stiller Lauf sieht aus wie ein gruener Lauf).
  EMAIL_AB_FUNDEN: 1,

  // Die drei Pruefungen lassen sich einzeln abschalten.
  PRUEFE_JAHRESZAHLEN: true,
  PRUEFE_SAISON: true,
  PRUEFE_FRISTEN: true,

  // Leer = heute. 'JJJJ-MM-TT' setzt ein anderes Datum, um eine Regel zu
  // testen, ohne auf den Monat zu warten (z. B. '2026-12-01' fuer Weihnachten).
  STICHTAG: '',

  // Sicherheitsnetz gegen das 30-Minuten-Limit in sehr grossen Konten.
  MAX_ANZEIGEN: 20000,

  // Wie viele Funde maximal ins Protokoll geschrieben werden. Google kuerzt
  // das Protokoll bei 100 KB - danach faellt der Rest ohne Hinweis weg.
  MAX_PROTOKOLL_ZEILEN: 200
};

// ---------------------------------------------------------------------------
// Saisonwoerter: Wort -> Monate, in denen es in Ordnung ist.
// Die Monatszahlen ziehen den Vorlauf mit ein (eine Weihnachtsaktion darf im
// November laufen). Umgekehrt gelesen ist das deine Monat-zu-Saison-Tabelle:
//   Jan  Winter, Silvester, Neujahr, Valentinstag
//   Feb  Winter, Valentinstag, Fruehling, Ostern, Frauentag
//   Mrz  Fruehling, Ostern, Frauentag
//   Apr  Fruehling, Ostern, Muttertag, Vatertag
//   Mai  Fruehling, Sommer, Muttertag, Vatertag
//   Jun  Sommer
//   Jul  Sommer
//   Aug  Sommer, Herbst
//   Sep  Herbst, Oktoberfest, Halloween
//   Okt  Herbst, Oktoberfest, Halloween, Black Friday, Cyber Monday, Singles Day
//   Nov  Herbst, Winter, Black Friday, Cyber Monday, Singles Day, Weihnachten, Advent
//   Dez  Winter, Weihnachten, Advent, Silvester, Neujahr
// ---------------------------------------------------------------------------
var SAISONWOERTER = {
  'frühling': [2, 3, 4, 5],
  'fruehling': [2, 3, 4, 5],
  'frühjahr': [2, 3, 4, 5],
  'spring': [2, 3, 4, 5],
  'sommer': [5, 6, 7, 8],
  'summer': [5, 6, 7, 8],
  'herbst': [8, 9, 10, 11],
  'autumn': [8, 9, 10, 11],
  'winter': [11, 12, 1, 2],
  'black friday': [10, 11],
  'black week': [10, 11],
  'cyber monday': [10, 11],
  'singles day': [10, 11],
  'weihnacht': [11, 12],
  'christmas': [11, 12],
  'advent': [11, 12],
  'silvester': [12, 1],
  'neujahr': [12, 1],
  'new year': [12, 1],
  'valentinstag': [1, 2],
  'valentine': [1, 2],
  'ostern': [2, 3, 4],
  'easter': [2, 3, 4],
  'frauentag': [2, 3],
  'muttertag': [4, 5],
  'vatertag': [4, 5],
  'oktoberfest': [9, 10],
  'halloween': [9, 10]
};

// Ein Saisonwort allein ist kein Fund. "Wintergarten" ist ein Produkt,
// "Winter-Sale" ist eine Aktion. Erst wenn im selben Text ein Aktionswort
// steht, wird ein Saisonwort ausserhalb seiner Monate gemeldet.
var PROMO_KONTEXT = /(sale|angebot|aktion|rabatt|deal|spar|%|gutschein|prozent|reduziert|sichern|sonderpreis|tiefpreis|schnäppchen|schnaeppchen|offer|discount|save)/i;

var MONATSNAMEN = {
  'januar': 1, 'jänner': 1, 'january': 1, 'jan': 1,
  'februar': 2, 'february': 2, 'feb': 2,
  'märz': 3, 'maerz': 3, 'march': 3, 'mrz': 3, 'mar': 3,
  'april': 4, 'apr': 4,
  'mai': 5, 'may': 5,
  'juni': 6, 'june': 6, 'jun': 6,
  'juli': 7, 'july': 7, 'jul': 7,
  'august': 8, 'aug': 8,
  'september': 9, 'sept': 9, 'sep': 9,
  'oktober': 10, 'october': 10, 'okt': 10, 'oct': 10,
  'november': 11, 'nov': 11,
  'dezember': 12, 'december': 12, 'dez': 12, 'dec': 12
};

// "bis 31.08.", "nur noch bis zum 31. August", "gueltig bis 31.08.2026"
var FRIST_PRAEFIX = '(?:bis|endet\\s+am|l(?:ä|ae)uft\\s+bis|g(?:ü|ue)ltig\\s+bis)';
var FRIST_ZAHL_RE = new RegExp(FRIST_PRAEFIX + '\\s+(?:zum\\s+)?(\\d{1,2})\\.\\s*(\\d{1,2})\\.\\s*(\\d{4}|\\d{2})?', 'gi');
var FRIST_WORT_RE = new RegExp(FRIST_PRAEFIX + '\\s+(?:zum\\s+)?(\\d{1,2})\\.?\\s*([a-zA-ZäöüÄÖÜ]+)\\s*(\\d{4})?', 'gi');

var JAHR_RE = /20\d{2}/g;
// "seit 2008", "gegruendet 2014", "© 2019" sind Belege, keine Ablaufdaten.
var JAHR_ALS_BELEG = /(seit|since|ab|©|est\.?|gegründet|gegruendet)\s*$/i;
// "2000+ Kunden", "5000 Paare" sind Mengen, keine Jahreszahlen.
var JAHR_ALS_MENGE = /^(\+|\s*(kunden|kund|customers|paare|mitglieder|projekte|jahre|teilnehmer|sterne|bewertungen|reviews|m²|qm))/i;

var MS_PRO_TAG = 24 * 60 * 60 * 1000;

// ---------------------------------------------------------------------------

function main() {
  var heute = stichtag();
  var jahr = heute.getUTCFullYear();
  var monat = heute.getUTCMonth() + 1;

  Logger.log('Stale-Copy-Waechter 1.0.0 — Konto ' + AdsApp.currentAccount().getCustomerId());
  Logger.log('Stichtag: ' + alsIsoDatum(heute) + ' (Monat ' + monat + ')');
  Logger.log('Dieses Skript liest nur. Es schreibt nichts ins Konto.');
  Logger.log('');

  var funde = [];
  var gelesen = 0;
  var rsaGelesen = 0;

  var anzeigen = AdsApp.ads()
    .withCondition('ad_group_ad.status = ENABLED')
    .withCondition('ad_group.status = ENABLED')
    .withCondition('campaign.status = ENABLED')
    .get();

  while (anzeigen.hasNext() && gelesen < CONFIG.MAX_ANZEIGEN) {
    var anzeige = anzeigen.next();
    gelesen++;
    if (!istResponsiveSuchanzeige(anzeige)) continue;
    rsaGelesen++;

    var texte = textbausteine(anzeige);
    for (var t = 0; t < texte.length; t++) {
      var treffer = pruefeText(texte[t].text, heute, jahr, monat);
      for (var f = 0; f < treffer.length; f++) {
        funde.push({
          kampagne: nameVon(anzeige.getCampaign()),
          anzeigengruppe: nameVon(anzeige.getAdGroup()),
          feld: texte[t].feld,
          text: texte[t].text,
          marker: treffer[f].marker,
          grund: treffer[f].grund,
          art: treffer[f].art
        });
      }
    }
  }

  berichte(funde, gelesen, rsaGelesen, heute);
}

// --- Erkennung -------------------------------------------------------------

/**
 * Alle Funde in einem einzelnen Textbaustein. Gibt eine Liste aus
 * {art, marker, grund} zurueck - leere Liste heisst sauber.
 */
function pruefeText(text, heute, jahr, monat) {
  var funde = [];
  if (!text) return funde;

  if (CONFIG.PRUEFE_SAISON && PROMO_KONTEXT.test(text)) {
    var klein = text.toLowerCase();
    for (var wort in SAISONWOERTER) {
      if (!SAISONWOERTER.hasOwnProperty(wort)) continue;
      var monate = SAISONWOERTER[wort];
      if (enthaelt(monate, monat)) continue;
      if (!saisonwortKommtVor(klein, wort)) continue;
      funde.push({
        art: 'Saison',
        marker: wort,
        grund: 'Saisonwort "' + wort + '" liegt ausserhalb seiner Monate (' +
          monate.join(', ') + ') — heute ist Monat ' + monat
      });
    }
  }

  if (CONFIG.PRUEFE_FRISTEN) {
    var fristen = fristenIn(text, jahr);
    for (var i = 0; i < fristen.length; i++) {
      if (fristen[i].datum.getTime() >= heute.getTime()) continue;
      funde.push({
        art: 'Frist',
        marker: fristen[i].roh,
        grund: 'Frist ' + alsIsoDatum(fristen[i].datum) + ' ist vorbei (heute ' +
          alsIsoDatum(heute) + ')'
      });
    }
  }

  if (CONFIG.PRUEFE_JAHRESZAHLEN) {
    JAHR_RE.lastIndex = 0;
    var m;
    while ((m = JAHR_RE.exec(text)) !== null) {
      var start = m.index;
      var ende = start + m[0].length;
      // Teil einer laengeren Zahl (Artikelnummer, Telefonnummer)? Dann nicht.
      if (/\d/.test(text.charAt(start - 1)) || /\d/.test(text.charAt(ende))) continue;
      var gefunden = parseInt(m[0], 10);
      if (gefunden >= jahr) continue;
      if (JAHR_ALS_BELEG.test(text.substring(0, start))) continue;
      if (JAHR_ALS_MENGE.test(text.substring(ende))) continue;
      funde.push({
        art: 'Jahr',
        marker: m[0],
        grund: 'Jahreszahl ' + gefunden + ' liegt in der Vergangenheit (heute ' + jahr + ')'
      });
    }
  }

  return funde;
}

/**
 * Mehrwortige Marker ("black friday") als schlichte Textsuche, einwortige
 * mit Wortgrenze und kurzer deutscher Beugung. Genau deshalb schlaegt
 * "Winter-Sale" an und "Wintergarten" nicht.
 */
function saisonwortKommtVor(kleinText, wort) {
  if (wort.indexOf(' ') !== -1) return kleinText.indexOf(wort) !== -1;
  var re = new RegExp('\\b' + wort + '(?:s|e|en|er|es|n)?\\b', 'i');
  return re.test(kleinText);
}

/** Alle Fristangaben eines Textes als {roh, datum}. */
function fristenIn(text, jahr) {
  var treffer = [];
  var m;

  FRIST_ZAHL_RE.lastIndex = 0;
  while ((m = FRIST_ZAHL_RE.exec(text)) !== null) {
    var datum = baueFrist(parseInt(m[1], 10), parseInt(m[2], 10), m[3], jahr);
    if (datum) treffer.push({ roh: trimmen(m[0]), datum: datum });
  }

  FRIST_WORT_RE.lastIndex = 0;
  while ((m = FRIST_WORT_RE.exec(text)) !== null) {
    var monat = MONATSNAMEN[m[2].toLowerCase()];
    if (!monat) continue;
    var datum2 = baueFrist(parseInt(m[1], 10), monat, m[3], jahr);
    if (datum2) treffer.push({ roh: trimmen(m[0]), datum: datum2 });
  }

  return treffer;
}

/**
 * Tag/Monat/optionales Jahr zu einem Datum.
 *
 * Fehlt das Jahr, ist das laufende gemeint - ausser die Frist laege dann mehr
 * als ein halbes Jahr in der Vergangenheit. "bis 31. Januar", im Dezember
 * gelesen, meint den kommenden Januar und ist keine abgelaufene Frist.
 */
function baueFrist(tag, monat, jahrRoh, jahr) {
  if (!tag || !monat || monat < 1 || monat > 12 || tag < 1 || tag > 31) return null;
  var zieljahr = jahr;
  if (jahrRoh) {
    zieljahr = parseInt(jahrRoh, 10);
    if (zieljahr < 100) zieljahr += 2000;
  }
  var datum = new Date(Date.UTC(zieljahr, monat - 1, tag));
  if (datum.getUTCMonth() !== monat - 1) return null; // 31. Februar
  if (!jahrRoh) {
    var heute = stichtag();
    if ((heute.getTime() - datum.getTime()) > 183 * MS_PRO_TAG) {
      datum = new Date(Date.UTC(zieljahr + 1, monat - 1, tag));
    }
  }
  return datum;
}

// --- Konto lesen -----------------------------------------------------------

function istResponsiveSuchanzeige(anzeige) {
  try {
    if (anzeige.isType && anzeige.isType().responsiveSearchAd) {
      return anzeige.isType().responsiveSearchAd() === true;
    }
  } catch (fehler) { /* aeltere Laufzeit: unten weiter */ }
  try {
    return anzeige.getType() === 'RESPONSIVE_SEARCH_AD';
  } catch (fehler2) {
    return false;
  }
}

/** Titel und Beschreibungen einer Responsive Suchanzeige, mit Feldnamen. */
function textbausteine(anzeige) {
  var rsa = anzeige.asType().responsiveSearchAd();
  var raus = [];
  var titel = rsa.getHeadlines() || [];
  for (var i = 0; i < titel.length; i++) {
    raus.push({ feld: 'Titel ' + (i + 1), text: textVon(titel[i]) });
  }
  var beschreibungen = rsa.getDescriptions() || [];
  for (var j = 0; j < beschreibungen.length; j++) {
    raus.push({ feld: 'Beschreibung ' + (j + 1), text: textVon(beschreibungen[j]) });
  }
  return raus;
}

function textVon(baustein) {
  if (!baustein) return '';
  if (typeof baustein === 'string') return baustein;
  if (typeof baustein.text === 'string') return baustein.text;
  if (typeof baustein.getText === 'function') return baustein.getText();
  return '';
}

function nameVon(entitaet) {
  if (!entitaet) return '(ohne)';
  try { return entitaet.getName(); } catch (fehler) { return '(ohne)'; }
}

// --- Ausgabe ---------------------------------------------------------------

function berichte(funde, gelesen, rsaGelesen, heute) {
  Logger.log('Gelesen: ' + gelesen + ' aktive Anzeigen, davon ' + rsaGelesen +
    ' Responsive Suchanzeigen.');

  if (funde.length === 0) {
    Logger.log('Ergebnis: keine veralteten Textstellen gefunden.');
    Logger.log('Das heisst: nichts, was diese drei Regeln beweisen koennen. Es heisst');
    Logger.log('nicht, dass jeder Text noch stimmt - ein Preis von gestern und ein');
    Logger.log('eingestelltes Produkt tragen kein Datum im Text.');
  } else {
    Logger.log('Ergebnis: ' + funde.length + ' Textstelle(n) zum Nachsehen.');
    Logger.log('');
    var grenze = Math.min(funde.length, CONFIG.MAX_PROTOKOLL_ZEILEN);
    for (var i = 0; i < grenze; i++) {
      var f = funde[i];
      Logger.log('[' + f.art + '] ' + f.kampagne + ' » ' + f.anzeigengruppe + ' » ' + f.feld);
      Logger.log('    Text:  ' + f.text);
      Logger.log('    Grund: ' + f.grund);
    }
    if (funde.length > grenze) {
      Logger.log('… und ' + (funde.length - grenze) + ' weitere. MAX_PROTOKOLL_ZEILEN erhoehen.');
    }
  }

  Logger.log('');
  Logger.log('Lauf beendet: ' + alsIsoDatum(heute) + ' · ' + funde.length + ' Fund(e).');
  vielleichtMailen(funde, gelesen, rsaGelesen, heute);
}

function vielleichtMailen(funde, gelesen, rsaGelesen, heute) {
  if (!CONFIG.EMAIL_SENDEN) return;
  if (funde.length < CONFIG.EMAIL_AB_FUNDEN) return;
  if (!CONFIG.EMPFAENGER || CONFIG.EMPFAENGER.indexOf('@') === -1) {
    Logger.log('E-Mail uebersprungen: EMPFAENGER ist keine Adresse.');
    return;
  }

  var zeilen = [];
  zeilen.push('Konto: ' + AdsApp.currentAccount().getCustomerId());
  zeilen.push('Stichtag: ' + alsIsoDatum(heute));
  zeilen.push('Gelesen: ' + rsaGelesen + ' Responsive Suchanzeigen von ' + gelesen + ' aktiven Anzeigen.');
  zeilen.push('Funde: ' + funde.length);
  zeilen.push('');
  var grenze = Math.min(funde.length, CONFIG.MAX_PROTOKOLL_ZEILEN);
  for (var i = 0; i < grenze; i++) {
    var f = funde[i];
    zeilen.push('[' + f.art + '] ' + f.kampagne + ' » ' + f.anzeigengruppe + ' » ' + f.feld);
    zeilen.push('  ' + f.text);
    zeilen.push('  ' + f.grund);
    zeilen.push('');
  }
  if (funde.length > grenze) zeilen.push('… und ' + (funde.length - grenze) + ' weitere.');
  zeilen.push('Dieses Skript liest nur. Es hat nichts im Konto veraendert.');

  MailApp.sendEmail(CONFIG.EMPFAENGER, CONFIG.BETREFF + ' (' + funde.length + ')', zeilen.join('\n'));
  Logger.log('E-Mail an ' + CONFIG.EMPFAENGER + ' verschickt.');
}

// --- Kleinkram -------------------------------------------------------------

function stichtag() {
  if (CONFIG.STICHTAG) {
    var teile = CONFIG.STICHTAG.split('-');
    return new Date(Date.UTC(parseInt(teile[0], 10), parseInt(teile[1], 10) - 1, parseInt(teile[2], 10)));
  }
  var jetzt = new Date();
  return new Date(Date.UTC(jetzt.getFullYear(), jetzt.getMonth(), jetzt.getDate()));
}

function alsIsoDatum(datum) {
  var m = datum.getUTCMonth() + 1;
  var t = datum.getUTCDate();
  return datum.getUTCFullYear() + '-' + (m < 10 ? '0' + m : m) + '-' + (t < 10 ? '0' + t : t);
}

function enthaelt(liste, wert) {
  for (var i = 0; i < liste.length; i++) if (liste[i] === wert) return true;
  return false;
}

function trimmen(text) {
  return String(text).replace(/^\s+|\s+$/g, '');
}

In die Zwischenablage kopiert.