Tools

Google-Ads-Skripte

Zwei fertige Skripte zum Einfügen in Google Ads. Beide lesen nur, keins verändert etwas im Konto. Wie man ein Skript überhaupt einrichtet, steht in der Anleitung dazu.

Täglicher Report in Google Sheets

Schreibt einmal pro Tag eine Zeile mit Impressionen, Klicks, Kosten, Conversions und Umsatz aus Anzeigen in eine Google-Tabelle. So entsteht von allein ein Verlauf, den du zum Beispiel für den Zeitraum-Vergleich aus dem KPI-Rechner weiterverwenden kannst.

Was du vorher brauchst

Eine leere Google-Tabelle, die URL daraus in Zeile 11 des Skripts eintragen.

Wie oft laufen lassen

Einmal täglich, am besten früh morgens, per Zeitplan in Google Ads.

/**
 * Täglicher Report in Google Sheets
 * Schreibt einmal pro Tag eine Zeile mit den Zahlen des Vortags (Impressionen, Klicks, Kosten,
 * Conversions, Umsatz aus Anzeigen) in eine Google-Tabelle. Verändert nichts im Konto, liest nur.
 * Funktioniert für alle Kampagnentypen, auch Performance Max, weil über GAQL statt über die ältere
 * Kampagnen-Auswahl gelesen wird.
 */

// ---------- Einstellungen ----------
const TABELLEN_URL = 'HIER-DEINE-TABELLEN-URL-EINFÜGEN';
const TABELLENBLATT = 'Tagesreport';
// ------------------------------------

function main() {
  const query = `
    SELECT metrics.impressions, metrics.clicks, metrics.cost_micros,
           metrics.conversions, metrics.conversions_value
    FROM customer
    WHERE segments.date DURING YESTERDAY
  `;
  const zeilen = AdsApp.search(query);

  let impressionen = 0;
  let klicks = 0;
  let kostenMicros = 0;
  let conversions = 0;
  let umsatz = 0;

  while (zeilen.hasNext()) {
    const zeile = zeilen.next();
    impressionen += zeile.metrics.impressions;
    klicks += zeile.metrics.clicks;
    kostenMicros += zeile.metrics.costMicros;
    conversions += zeile.metrics.conversions;
    umsatz += zeile.metrics.conversionsValue;
  }

  const tabelle = SpreadsheetApp.openByUrl(TABELLEN_URL);
  let blatt = tabelle.getSheetByName(TABELLENBLATT);
  if (!blatt) {
    blatt = tabelle.insertSheet(TABELLENBLATT);
    blatt.appendRow(['Datum', 'Impressionen', 'Klicks', 'Kosten in €', 'Conversions', 'Umsatz aus Anzeigen in €']);
  }

  const gestern = new Date();
  gestern.setDate(gestern.getDate() - 1);
  const datum = Utilities.formatDate(gestern, AdsApp.currentAccount().getTimeZone(), 'dd.MM.yyyy');

  blatt.appendRow([datum, impressionen, klicks, kostenMicros / 1000000, conversions, umsatz]);
}

Budget-Warnung per E-Mail

Prüft jede aktive Kampagne, ob die heutigen Kosten schon einen einstellbaren Anteil des Tagesbudgets erreicht haben, und schickt bei Überschreitung eine E-Mail. Funktioniert auch für Performance Max, weil die Abfrage über GAQL läuft, nicht über die ältere Kampagnen-Auswahl, die bei neueren Kampagnentypen keine Kosten liefert.

Was du vorher brauchst

Deine E-Mail-Adresse in Zeile 12 eintragen, die Schwelle in Zeile 13 bei Bedarf anpassen (0,9 = 90 %).

Wie oft laufen lassen

Mehrmals am Tag, zum Beispiel stündlich, sonst kommt die Warnung erst am nächsten Tag an.

/**
 * Budget-Warnung per E-Mail
 * Prüft jede aktive Kampagne: Haben die heutigen Kosten schon einen einstellbaren Anteil des
 * Tagesbudgets erreicht? Wenn ja, kommt eine E-Mail mit der Liste der betroffenen Kampagnen.
 * Verändert nichts im Konto, liest nur und verschickt bei Bedarf eine E-Mail.
 * Am besten mehrmals am Tag laufen lassen (Zeitplan in Google Ads), sonst kommt die Warnung erst,
 * wenn der Tag schon vorbei ist.
 */

// ---------- Einstellungen ----------
const EMPFAENGER = 'deine@adresse.de';
const SCHWELLE = 0.9; // 0.9 = Warnung ab 90 % des Tagesbudgets
// ------------------------------------

function main() {
  const query = `
    SELECT campaign.name, campaign_budget.amount_micros, metrics.cost_micros
    FROM campaign
    WHERE campaign.status = 'ENABLED' AND segments.date DURING TODAY
  `;
  const zeilen = AdsApp.search(query);

  const warnungen = [];
  while (zeilen.hasNext()) {
    const zeile = zeilen.next();
    const budget = zeile.campaignBudget.amountMicros;
    const kosten = zeile.metrics.costMicros;
    if (budget > 0 && kosten / budget >= SCHWELLE) {
      const prozent = Math.round((kosten / budget) * 100);
      const kostenEuro = (kosten / 1000000).toFixed(2);
      const budgetEuro = (budget / 1000000).toFixed(2);
      warnungen.push(`${zeile.campaign.name}: ${prozent} % des Tagesbudgets (${kostenEuro} von ${budgetEuro} €)`);
    }
  }

  if (warnungen.length > 0) {
    MailApp.sendEmail(
      EMPFAENGER,
      `Budget-Warnung: ${AdsApp.currentAccount().getName()}`,
      'Diese Kampagnen haben heute die Schwelle erreicht:\n\n' + warnungen.join('\n')
    );
  }
}

Und jetzt einrichten

Wo ein Skript hinkommt und wie die Freigabe läuft

Schritt für Schritt, inklusive Zeitplan und was das 30-Minuten-Limit für größere Konten bedeutet.

Zur Anleitung