Findet kaputte Ziel-URLs , bevor der Klick sie findet.

/**
 * KAPUTTE-ZIEL-URL-PRUEFUNG — Google Ads Script
 * Version 1.0.0 · Stand 2026-08-30
 * https://visnakovs.de/google-ads-scripts/ziel-url-pruefung/
 *
 * Ruft die Ziel-URLs aller aktiven Anzeigen und Keywords ab und meldet, welche
 * mit einem Fehlercode antworten. Zusaetzlich - abschaltbar - welche auf die
 * Startseite weiterleiten: technisch eine 200, fuer den Klickenden eine
 * Sackgasse, und in Google Ads eine ganz normale, teure Anzeige.
 *
 * ⛔ GARANTIE — Dieses Skript verändert nichts in deinem Konto: Es liest, es
 * protokolliert, es schreibt nicht. Es pausiert nichts, es beschriftet nichts,
 * es korrigiert keine URL. Die Abrufe gehen an deine eigene Website, nicht an
 * Google Ads.
 *
 * 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 im Protokoll oder in einer Bedingung faellt still aus.
 */

// ---------------------------------------------------------------------------
// CONFIG
// ---------------------------------------------------------------------------
var CONFIG = {
  // E-Mail-Zusammenfassung. Bewusst AUS - erst lesen, dann einschalten.
  EMAIL_SENDEN: false,
  EMPFAENGER: 'dein.name@beispiel.de',
  BETREFF: 'Google Ads: kaputte Ziel-URLs',
  EMAIL_AB_FUNDEN: 1,

  // Obergrenze der geprueften Adressen pro Lauf. Ein Skript hat 30 Minuten,
  // und jeder Abruf kostet Zeit; die Tageskontingente fuer UrlFetchApp kommen
  // ausserdem aus Apps Script. 400 ist konservativ und laeuft in jedem Konto
  // durch. Wird die Grenze erreicht, sagt das Protokoll es - der Rest faellt
  // nicht still weg.
  MAX_URLS: 400,

  // Abbruch, wenn weniger Sekunden Laufzeit uebrig sind. Ein abgewuergter
  // Lauf hinterlaesst ein Protokoll, das nach "nichts gefunden" aussieht.
  MIN_RESTZEIT_SEKUNDEN: 120,

  // Weiterleitungen werden von Hand verfolgt, damit das Ziel sichtbar ist.
  MAX_WEITERLEITUNGEN: 5,

  // Weiterleitung auf die Startseite melden, wenn die Ausgangsadresse einen
  // Pfad hatte. Klassiker nach dem Ausbau eines Produkts.
  PRUEFE_STARTSEITEN_WEITERLEITUNG: true,

  // Pause zwischen zwei Abrufen in Millisekunden. 0 = keine Pause. Hoeher
  // setzen, wenn die eigene Firewall bei schnellen Serien blockt.
  PAUSE_MS: 0,

  // 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
};

var MELDEN_AB_STATUS = 400;

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

function main() {
  Logger.log('Ziel-URL-Pruefung 1.0.0 — Konto ' + AdsApp.currentAccount().getCustomerId());
  if (istVorschau()) Logger.log('Vorschau-Lauf. Das Skript schreibt ohnehin nichts.');
  Logger.log('Dieses Skript liest nur. Es schreibt nichts ins Konto.');
  Logger.log('');

  var gesammelt = sammleUrls();
  var adressen = schluessel(gesammelt);
  Logger.log('Gefunden: ' + adressen.length + ' verschiedene Ziel-URLs aus aktiven Anzeigen und Keywords.');

  var zuPruefen = adressen.slice(0, CONFIG.MAX_URLS);
  if (adressen.length > zuPruefen.length) {
    Logger.log('Geprueft werden davon ' + zuPruefen.length + ' (MAX_URLS). ' +
      (adressen.length - zuPruefen.length) + ' Adressen bleiben in diesem Lauf ungeprueft.');
  }
  Logger.log('');

  var funde = [];
  var geprueft = 0;
  var abgebrochen = false;

  for (var i = 0; i < zuPruefen.length; i++) {
    if (restzeitSekunden() < CONFIG.MIN_RESTZEIT_SEKUNDEN) { abgebrochen = true; break; }
    var adresse = zuPruefen[i];
    var ergebnis = pruefeAdresse(adresse);
    geprueft++;
    if (ergebnis.problem) {
      funde.push({
        url: adresse,
        problem: ergebnis.problem,
        detail: ergebnis.detail,
        orte: gesammelt[adresse]
      });
    }
    if (CONFIG.PAUSE_MS > 0) Utilities.sleep(CONFIG.PAUSE_MS);
  }

  berichte(funde, geprueft, adressen.length, abgebrochen);
}

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

/**
 * Ziel-URLs aller aktiven Anzeigen und Keywords, mit den Orten, an denen sie
 * haengen. Mehrere Anzeigen teilen sich oft eine Adresse - geprueft wird sie
 * einmal, gemeldet werden alle Fundstellen.
 *
 * Was hier NICHT eingesammelt wird, steht im Kopf der Seite: Sitelinks,
 * Snippets, Bilder-Assets und die Endziele von Performance-Max-Assetgruppen
 * haengen an anderen Objekten und brauchen einen eigenen Durchlauf.
 */
function sammleUrls() {
  var karte = {};

  var anzeigen = AdsApp.ads()
    .withCondition('ad_group_ad.status = ENABLED')
    .withCondition('ad_group.status = ENABLED')
    .withCondition('campaign.status = ENABLED')
    .get();
  while (anzeigen.hasNext()) {
    var anzeige = anzeigen.next();
    merke(karte, urlVon(anzeige), 'Anzeige: ' + nameVon(anzeige.getCampaign()) + ' » ' +
      nameVon(anzeige.getAdGroup()));
  }

  var keywords = AdsApp.keywords()
    .withCondition('ad_group_criterion.status = ENABLED')
    .withCondition('ad_group.status = ENABLED')
    .withCondition('campaign.status = ENABLED')
    .get();
  while (keywords.hasNext()) {
    var keyword = keywords.next();
    merke(karte, urlVon(keyword), 'Keyword: ' + textVon(keyword) + ' (' +
      nameVon(keyword.getCampaign()) + ')');
  }

  return karte;
}

function merke(karte, adresse, ort) {
  if (!adresse) return;
  if (adresse.indexOf('http') !== 0) return; // Platzhalter und leere Felder
  if (!karte[adresse]) karte[adresse] = [];
  if (karte[adresse].length < 5) karte[adresse].push(ort);
}

function urlVon(entitaet) {
  try {
    var urls = entitaet.urls();
    return urls ? urls.getFinalUrl() : null;
  } catch (fehler) {
    return null;
  }
}

function textVon(keyword) {
  try { return keyword.getText(); } catch (fehler) { return '(ohne Text)'; }
}

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

// --- Pruefung --------------------------------------------------------------

/**
 * Eine Adresse abrufen und die Weiterleitungen von Hand verfolgen.
 *
 * followRedirects steht auf false, weil die Antwort sonst nicht verraet, WO
 * man gelandet ist - und genau das braucht die Startseiten-Erkennung.
 * muteHttpExceptions verhindert, dass ein 404 den ganzen Lauf abbricht.
 */
function pruefeAdresse(adresse) {
  var aktuell = adresse;
  var sprung = 0;
  var kette = [];

  while (sprung <= CONFIG.MAX_WEITERLEITUNGEN) {
    var antwort;
    try {
      antwort = UrlFetchApp.fetch(aktuell, {
        muteHttpExceptions: true,
        followRedirects: false,
        validateHttpsCertificates: true,
        method: 'get'
      });
    } catch (fehler) {
      return { problem: 'nicht erreichbar', detail: kuerze(String(fehler), 180) };
    }

    var status = antwort.getResponseCode();
    if (status >= 300 && status < 400) {
      var ziel = ausHeader(antwort, 'Location');
      if (!ziel) {
        return { problem: 'Weiterleitung ohne Ziel', detail: 'Status ' + status + ', kein Location-Header' };
      }
      aktuell = absolut(aktuell, ziel);
      kette.push(status + ' → ' + aktuell);
      sprung++;
      continue;
    }

    if (status >= MELDEN_AB_STATUS) {
      return {
        problem: 'Status ' + status,
        detail: (kette.length ? 'nach ' + kette.join(', ') + '; ' : '') + beschreibeStatus(status)
      };
    }

    if (CONFIG.PRUEFE_STARTSEITEN_WEITERLEITUNG && kette.length > 0 &&
      hatPfad(adresse) && !hatPfad(aktuell)) {
      return {
        problem: 'Weiterleitung auf die Startseite',
        detail: 'Status ' + status + ' nach ' + kette.join(', ') +
          ' — die beworbene Unterseite gibt es so nicht mehr'
      };
    }

    return { problem: null, detail: 'Status ' + status };
  }

  return {
    problem: 'zu viele Weiterleitungen',
    detail: 'mehr als ' + CONFIG.MAX_WEITERLEITUNGEN + ' Spruenge: ' + kette.join(', ')
  };
}

function beschreibeStatus(status) {
  if (status === 404) return 'Seite nicht gefunden';
  if (status === 403) return 'Zugriff verweigert (auch eine Firewall gegen Rechenzentren sieht so aus)';
  if (status === 410) return 'Seite dauerhaft entfernt';
  if (status === 429) return 'zu viele Anfragen — PAUSE_MS erhoehen und erneut pruefen';
  if (status >= 500) return 'Serverfehler auf deiner Seite';
  return 'Fehlercode';
}

/** Hat die Adresse einen echten Pfad, oder ist sie die blanke Startseite? */
function hatPfad(adresse) {
  var ohneSchema = String(adresse).replace(/^https?:\/\//i, '');
  var schnitt = ohneSchema.indexOf('/');
  if (schnitt === -1) return false;
  var pfadTeil = ohneSchema.substring(schnitt).replace(/[?#].*$/, '');
  return pfadTeil.replace(/\/+$/, '').length > 0;
}

/** Relative Location-Header zu einer absoluten Adresse machen. */
function absolut(basis, ziel) {
  if (/^https?:\/\//i.test(ziel)) return ziel;
  var ohneSchema = String(basis).replace(/^(https?:\/\/)/i, '');
  var schema = String(basis).substring(0, String(basis).length - ohneSchema.length);
  var schnitt = ohneSchema.indexOf('/');
  var host = schnitt === -1 ? ohneSchema : ohneSchema.substring(0, schnitt);
  if (ziel.indexOf('/') === 0) return schema + host + ziel;
  var pfad = schnitt === -1 ? '/' : ohneSchema.substring(schnitt);
  var bisSlash = pfad.substring(0, pfad.lastIndexOf('/') + 1);
  return schema + host + bisSlash + ziel;
}

function ausHeader(antwort, name) {
  var kopfzeilen = antwort.getAllHeaders();
  for (var schluesselName in kopfzeilen) {
    if (!kopfzeilen.hasOwnProperty(schluesselName)) continue;
    if (schluesselName.toLowerCase() !== name.toLowerCase()) continue;
    var wert = kopfzeilen[schluesselName];
    return (wert && wert.length && typeof wert !== 'string') ? wert[0] : wert;
  }
  return null;
}

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

function berichte(funde, geprueft, gesamt, abgebrochen) {
  Logger.log('Geprueft: ' + geprueft + ' von ' + gesamt + ' Adressen.');
  if (abgebrochen) {
    Logger.log('ABGEBROCHEN vor dem Zeitlimit. Der Rest ist ungeprueft, nicht in Ordnung.');
  }

  if (funde.length === 0) {
    Logger.log('Ergebnis: keine kaputte Ziel-URL unter den geprueften Adressen.');
    Logger.log('Das heisst nicht, dass alle Ziele stimmen: Sitelinks, Snippets und die');
    Logger.log('Assets von Performance Max haengen an anderen Objekten und sind hier');
    Logger.log('nicht dabei. Eine ausgelaufene Produktseite hinterlaesst Reste in');
    Logger.log('mehreren davon gleichzeitig.');
  } else {
    Logger.log('Ergebnis: ' + funde.length + ' Adresse(n) mit Problem.');
    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.problem + '] ' + f.url);
      Logger.log('    ' + f.detail);
      Logger.log('    Fundstellen: ' + f.orte.join(' | '));
    }
    if (funde.length > grenze) {
      Logger.log('… und ' + (funde.length - grenze) + ' weitere.');
    }
  }

  Logger.log('');
  Logger.log('Lauf beendet: ' + geprueft + ' Adressen geprueft · ' + funde.length + ' Fund(e).');
  vielleichtMailen(funde, geprueft, gesamt, abgebrochen);
}

function vielleichtMailen(funde, geprueft, gesamt, abgebrochen) {
  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('Geprueft: ' + geprueft + ' von ' + gesamt + ' Adressen.');
  if (abgebrochen) zeilen.push('Lauf vorzeitig beendet - der Rest ist ungeprueft.');
  zeilen.push('Funde: ' + funde.length);
  zeilen.push('');
  var grenze = Math.min(funde.length, CONFIG.MAX_PROTOKOLL_ZEILEN);
  for (var i = 0; i < grenze; i++) {
    zeilen.push('[' + funde[i].problem + '] ' + funde[i].url);
    zeilen.push('  ' + funde[i].detail);
    zeilen.push('  ' + funde[i].orte.join(' | '));
    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 restzeitSekunden() {
  try {
    return AdsApp.getExecutionInfo().getRemainingTime();
  } catch (fehler) {
    return 9999; // Ohne Auskunft laeuft das Skript bis zum harten Limit weiter.
  }
}

function istVorschau() {
  try { return AdsApp.getExecutionInfo().isPreview() === true; } catch (fehler) { return false; }
}

function schluessel(karte) {
  var raus = [];
  for (var k in karte) if (karte.hasOwnProperty(k)) raus.push(k);
  raus.sort();
  return raus;
}

function kuerze(text, laenge) {
  var t = String(text);
  return t.length > laenge ? t.substring(0, laenge) + '…' : t;
}

In die Zwischenablage kopiert.