Google Ads Skript:
Campaign metrics out of limits alerts

Das ultimative Skript, um Kennzahlen wie Conversions, Kosten, Impressionen etc. von Google Ads Kampagnen zu überwachen. Es können absolute Werte für konfigurierbare Zeiträume überprüft werden (min x Impressionen gestern) oder prozentuale Abweichungen zu konfigurierbaren Zeiträumen (z.B. die letzten 7 Tagen maximal 20% weniger Conversions zur Vorwoche). Weicht irgendein Wert von ihren Vorgaben ab, erhalten Sie eine E-Mail.

Alarm	Überwachung	Kosten sparen	Reiner Lesezugriff
Sendet eine E-Mail, wenn etwas überprüft werden sollte.	Das Skript überwacht das Google Ads Konto (stündliche oder tägliche Ausführung).	Das Skript hilft unnötige oder ungewollte Ausgaben zu vermeiden.	Es werden keine Änderungen in Google Ads, dem Merchant Center oder Google Analytics durchgeführt.

Beispiel-Überprüfungen

Für jede Kampagne können für unterschiedliche Kennzahlen unterschiedliche Überprüfungen durchgeführt werden. Zum Beispiel:

Anzahl der Conversions gestern muss größer als 2000 betragen.
Kosten der letzten 7 Tage muss zwischen 200.000€ und 300.000€ liegen.
Abweichung der Anzahl der Conversions der letzten 7 Tage zur Vorwoche darf maximal +/- 30% betragen.
Abweichung der Anzahl der Conversions der letzten 28 Tage zum vorherigen Zeitraum darf maximal +/- 15% betragen.

Schlägt mindestens ein Test fehl, erhalten Sie eine Alarm-Email in der alle gefundenen Probleme aufgeführt werden.

Beispiel Alarm-Email

In dieser Alarm-Email wurde das Problem erkannt, dass die Kosten der Kampagne "Search Prio" der letzten 2 Tage über als 30% höher waren als im Vergleichzeitrum (Vorwoche). Unter den erkannten Problemen werden immer Diagramme mit (konfigurierbaren) Kennzahlen angezeigt.

Google Ads Script Campaign metrics out of limits alerts Alarm Email

Mit einem Klick auf "alertIncrease" landen Sie direkt im Config Sheet vom Script Campaign metrics out of limits alerts beim Parameter "alertIncrease", so dass Sie sofort die "30%" bei alertIncrease oder andere Parameter anpassen können. Mit einem Klick auf "Google Ads Account" sind Sie sofort im Google Ads Konto der Demo AG. cost_micros ist übrigens Googles Metrikname für die Kosten.

Konfiguration

Es empfiehlt sich für jedes Konto und für jede Kampagne mehrere Kennzahlen zu überwachen. Werden mehrere unerlaubte Abweichungen erkannt, erhält man alle zusammen in einer Email aufgeschlüsselt.

Konfigurationsparameter

Parameter	Description
campaignName	Der Name der Kampagne, die überwacht werden soll. Tipp: Legen Sie mehrere Zeilen für jede Kampagne an und konfigurieren Sie unterschiedliche Kennzahlen (Impressionen, Kosten, Conversions, ...) und unterschiedliche Überprüfungen.
campaignNamesOrPattern	Ersatz für campaignName. Ermöglicht die Überprüfung mehrerer Kampagnen. Standardwert: [leer = alle Kampagnen] Es können entweder eine oder mehrere Kampagnen mit vollen Namen in [] angegeben werden oder ein Pattern. Beispiele: 3 Kampagnen: ["Brand Search","Shopping Prio","PMax"] Alle Kampagne die "Brand" enthalten: Brand Alle Kampagne die "Brand" nicht enthalten: !Brand
campaignLabelNames	Alternativ können mehrere Kampagnen auch über Labels ausgewählt werden.
eachCampaignIndividually	Standardwert: FALSE FALSE: Wurden mehrere Kampagnen ausgewählt, so werden die aggregierten Daten dieser Kampagnen überprüft. TRUE: Jede Kampagne für sich wird gegen die angegebenen Testparameter überprüft.
metricName	Klickt man auf den kleinen Pfeil in der Zelle, kann man die beliebtesten Kennzahlen (Kosten, Impressionen, Kosten pro Conversions, Durchschnittskosten, Klicks, Conversions, Conversions nach Zeit, Conversionwert nach Zeit) direkt auswählen. Aber auch andere Metricen sind möglich. Siehe developers.google.com.
daysBackRecent	1 = den Zeitraum ab gestern untersuchen, 0 = ab heute
daysBackCompareTo	7 = mit den Kennzahlen vor einer Woche vergleichen.
numberOfDays	1 = nur die Kennzahlen eines Tages betrachten. Wert muss kleiner oder gleich daysBackCompareTo sein.
alertLessThan	Absoluter Betrag. Wenn der für die Kennzahl unterschritten wird, erhält man eine Alarm-Email.
alertGreaterThan	analog
alertDecrease	Vergleicht den Zeitraum "recent" mit "compareTo" über die definierte Anzahl Tage. Weicht "recent" um mehr als alertDecrease % nach unten ab, erhält man eine Alarm-Email.
alertIncrease	analog
#hours	Tipp: Wenn Kennzahlen ab gestern überprüft werden sollen, stellen Sie #hours=5,6,7 (5,6,7 damit die Ausführung um 5 Uhr erfolgt und falls es da zu Problemen kommen sollte auch nochmal um 6 und um 7 Uhr) ein, damit die Ausführung nicht direkt nach Mitternacht erfolgt, wo manche Kennzahlen von Google noch nicht bereitgestellt werden.

Dieses Skript ist kostenlos. Die roten Parameter sind jedoch exklusiv für Nutzer der Webanwendung SEA Suite. Einige Vorteile der SEA Suite:

Skriptergebnisse können an die SEA Suite und/oder per Mail verschickt werden.
Übersichtliche Anzeige und Verwaltung aller Skriptergebnisse und Warnungen für alle Konten, die man betreut.
Ideal auch für Teams. Aufgaben können zum Beispiel als erledigt markiert werden.
Erweiterte Funktionalität einiger Skripte exklusiv für SEA Suite Nutzer.
Zusätzliche Skripte exklusiv für SEA Suite Nutzer.

Testen Sie die SEA Suite einen Monat lange kostenlos!

Bitte loggen Sie sich ein, damit Ihnen auch die nicht-öffentlichen Skripte und die für Sie verfügbaren erweiterte Funktionalitäten angezeigt werden.

Parameter, die für alle Skripte gelten

anzeigen

Hinweis zur Aktualität von Kennzahlen in Google Ads

Das Problem

Kennzahlen (insb. Conversions) stellt Google teilweise sehr zeitverzögert Schritt für Schritt zur Verfügung. Das bedeutet, wenn man jeden Tag die Kennzahlen für ein bestimmtes Datum abruft, nähern sich die Kennzahlen jeden Tag etwas dem tatsächlichen Wert an. Wie groß der Effekt ist, hängt vom Konto und dem Messwert ab. Wenn man um 5 Uhr die Kostendaten von gestern abruft, erhält man unserer Erfahrung nach einen Wert, der sich nicht mehr groß ändert. Ruft man dagegen Conversiondaten ab, können über 40% weniger Conversions ausgewiesen werden, als tatsächlich erfolgt sind. Erst nach ein paar Tagen erhält man für Conversions zuverlässige Daten von Google.

Laut Google können sich Conversiondaten (auch die nach Zeitpunkt) innerhalb von 7 Tagen deutlich ändern, bis zu 30 Tagen noch leicht ändern und erst nach 30 Tagen sollten sie sich nicht mehr ändern.

Die Lösungen

Daten von gestern nicht vor 5 Uhr abrufen

Es ergibt natürlich Sinn viele Daten von gestern zu überprüfen, um schnell auf Probleme reagieren zu können. Es empfiehlt sich in der Spalte #hours 5,6,7,8,10 einzutragen, damit erst ab 5 Uhr Daten vom Vortag ausgelesen werden. So hat Google wenigstens ein paar Stunden Zeit Daten vom Vortag zu aktualisieren.
(Die weiteren Stunden sind nur zur Vorsicht. Falls es bei einer Skriptausführung mal Probleme gibt, wird es eine Stunde später erneut versucht.)

Unvollständigkeit berücksichtigen

Wenn man Kennzahlen für gestern oder die letzten Tage überprüft, muss man berücksichtigen, dass diese ggf. noch nicht vollständig sind. Für Überprüfungen von Kennzahlen der letzten paar Tage sollte man also primär Extremwerte überprüfen und zum Beispiel bei Conversions berücksichtigen, dass ggf. nur die Hälfte der Conversion vom Vortag in den Daten von Google schon enthalten sind.

Mehrere Überprüfungen für dieselben Kennzahlen

Es ergibt Sinn für den Vortag zu überprüfen, ob conversions_by_conversion_date größer 0 (oder ein Wert 50% unter dem Minimum) ist, um einen Alert bei Trackingausfälle zu bekommen. Für einen weiteren Test konfiguriert man daysBackRecent=7, um die Kennzahlen von vor einer Woche daraufhin zu überprüfen, ob die im Normalbereich liegen. Da kann man sich überlegen, ob man nur einen einzelnen Tag mit großer Toleranz überprüft oder doch besser einen Zeitraum von mehreren Tagen, damit Ausreißer an einzelnen Tagen nicht zu unnötigen Alerts führen.