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.
/**
* 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.
/**
* 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.