Google Ads-Skripts bieten eine serverlose Automatisierungsplattform, mit der Sie Ihre Google Ads-Daten mithilfe von modernem JavaScript (ES6+) in einer browserbasierten IDE programmatisch verwalten und abfragen können. Mit Google Ads-Scripts können Sie routinemäßige Workflows zur Kontoverwaltung automatisieren, benutzerdefinierte Berichte erstellen und Google Ads in externe Datenquellen einbinden – für ein Konto oder Tausende von Konten –, ohne Server bereitstellen oder Entwickleranmeldedaten verwalten zu müssen.
Die meisten Funktionen von Google Ads sind in Google Ads-Scripts über mutate- und search-Aufrufe verfügbar. Sie können Skripts für Folgendes verwenden:
- Kampagnen, Anzeigengruppen, Keywords und Anzeigen verwalten
- Gebote, Budgets und Status basierend auf der Echtzeitleistung oder externen Daten anpassen.
- Führen Sie Abfragen mit der Google Ads Query Language (GAQL) aus, um benutzerdefinierte Berichte und Dashboards zu erstellen.
- Sie können automatisierte Ausführungen so planen, dass sie stündlich, täglich, wöchentlich, monatlich oder bei Bedarf ausgeführt werden.
- Mit Verwaltungsskripts können Sie kontoübergreifende Vorgänge in untergeordneten Konten koordinieren.
- Verbindung zu Google Workspace-Diensten (wie Google Sheets und Google Drive), Google Cloud-Diensten (wie BigQuery) und APIs von Drittanbietern herstellen.
Skripts enthalten auch integrierte Entitätsselektoren und Berichte.
Wichtige technische Daten
In den folgenden technischen Spezifikationen werden die Ausführungsumgebung und die Betriebsgrenzen von Google Ads-Scripts definiert:
| Spezifikation | Skript für ein einzelnes Konto | Skript für Verwaltungskonto |
|---|---|---|
| Zeitlimit für die Ausführung | Maximal 30 Minuten |
Bis zu 60 Minuten mit executeInParallel und einem Rückruf (30 Minuten Standard)
|
| Laufzeit-Engine | V8-JavaScript-Laufzeit (ECMAScript 6+) | V8-JavaScript-Laufzeit (ECMAScript 6+) |
| Limit für Entitäts-Iteratoren | Standardmäßig 50.000 Entitäten pro Iterator (Berichte und Suchanfragen sind ausgenommen) | 50.000 Entitäten pro untergeordnetem Konto (Berichte und Suchanfragen ausgenommen) |
| Parallele Konten | – (1 Konto) | Bis zu 50 Konten gleichzeitig |
| Limit für Bulk-Uploads | 50 MB Dateigröße, 1.000.000 Zeilen | 50 MB Dateigröße, 1.000.000 Zeilen |
| Autorisierte Skripts | Bis zu 250 autorisierte Skripts pro Nutzer | Bis zu 250 autorisierte Skripts pro Nutzer |
| Hosting und Infrastruktur | Vollständig von Google verwaltet (serverlos) | Vollständig von Google verwaltet (serverlos) |
Weitere Informationen finden Sie unter Beschränkungen.
Sind Google Ads-Scripts das richtige Produkt für mich?
Google bietet mehrere Produkte zur Automatisierung von Google Ads-Konten an. In der folgenden Tabelle werden gängige Szenarien und Empfehlungen beschrieben, die Ihnen bei der Auswahl des richtigen Produkts für Ihre Anforderungen helfen:
| Szenario | Empfehlung | Wichtige Merkmale |
|---|---|---|
| Ich bin ein Entwickler, der ein eigenes Softwareprodukt entwickeln oder die Google Ads API einbinden möchte. Ich kann Code schreiben und Softwareinfrastruktur wie Server und Datenbanken verwalten. | Verwenden Sie die Google Ads API. | Vollständige API-Kontrolle, höherer Durchsatz, dediziertes Hosting und OAuth-Verwaltung. |
| Ich bin ein Entwickler, der gerne Code schreibt, aber seine eigene Softwareinfrastruktur nicht verwalten möchte. | Google Ads-Scripts verwenden | Serverlose Ausführung in Google Ads, automatisierte Planung, browserbasierte IDE. |
| Ich bin kein Entwickler, aber ich bin bereit, etwas Zeit in das Erlernen der Programmierung zu investieren, um Google Ads zu automatisieren. | Google Ads-Scripts verwenden | Einfache JavaScript-Syntax, vordefinierte Skriptvorlagen, automatische Vervollständigung in der IDE und Syntaxhervorhebung. |
| Ich möchte Videokampagnen programmatisch verwalten. | Google Ads-Scripts verwenden |
Direkte Verwaltung von Videokampagnen mit AdsApp.videoCampaigns().
|
| Ich möchte Aufgaben planen, die ohne aktive Nutzersitzung ausgeführt werden. | Google Ads-Scripts verwenden | OAuth2-Hintergrundautorisierung mit automatischer stündlicher, täglicher, wöchentlicher oder monatlicher Planung. |
| Ich möchte programmatisch auf meine verschachtelten Google Ads-Konten zugreifen. | Mit Verwaltungsskripts können Sie über ein einziges Skript auf untergeordnete Konten zugreifen, die Anzeigen ausliefern. |
Sequenzielle Iteration über untergeordnete Konten oder parallele Ausführung über bis zu 50 untergeordnete Konten mit executeInParallel.
|
| Ich möchte Google-eigene APIs oder APIs von Drittanbietern in meine Google Ads-Verwaltung einbinden. | Google APIs oder Drittanbieter-APIs mit Google Ads-Skripts verwenden |
Integrierte Google Workspace-Dienste (Sheets, Drive, Mail), erweiterte Google APIs (BigQuery, Analytics, YouTube) und UrlFetchApp für externe REST APIs.
|
| Ich bin Datenanalyst (oder habe eine ähnliche Rolle) und möchte Google Ads-Berichte für weitere Analysen herunterladen. | Verwenden Sie den BigQuery Data Transfer Service für Google Ads. | Geplante automatisierte Pipeline für Google Ads-Daten in BigQuery ohne Code. |
| Ich möchte Google Ads-Konten im Bulk verwalten und habe kein Problem damit, Code zu schreiben. | Verwenden Sie Bulk-Uploads mit Google Ads-Scripts. | Programmatischer CSV- oder Tabellen-Upload mit bis zu 1.000.000 Zeilen. |
| Ich möchte Google Ads-Konten im Bulk verwalten, aber keinen Code schreiben. | Verwenden Sie automatisierte Regeln, Bulk-Uploads oder den Google Ads Editor. | No-Code-Desktop- oder UI-Tools für Bulk-Updates und geplante Regeln. |
Vorbereitung
Es sind nur grundlegende JavaScript-Kenntnisse erforderlich. Die IDE unterstützt Sie mit Syntaxhervorhebung, automatischer Vervollständigung und Vorschau. Sie benötigen lediglich ein Google Ads-Konto, um Ihr erstes Script zu schreiben.
Häufig gestellte Fragen
Hier finden Sie Antworten auf häufig gestellte Fragen zur Architektur, zu Ausführungslimits und zu Integrationen von Google Ads-Scripts.
Was sind Google Ads-Scripts?
Google Ads-Skripts bieten eine serverlose Automatisierungsumgebung in Google Ads. Werbetreibende und Entwickler können damit JavaScript-Code schreiben, um Leistungsmesswerte abzufragen, Kampagnen zu erstellen und zu ändern, Gebote und Budgets zu aktualisieren und eine Verbindung zu externen APIs herzustellen, ohne Server konfigurieren, OAuth-Tokens verwalten oder für die Infrastruktur bezahlen zu müssen.
Wie unterscheiden sich Google Ads-Scripts von der Google Ads API?
Google Ads-Skripts werden direkt in Ihrem Google Ads-Konto mit JavaScript ausgeführt. Sie erfordern keine Serverinfrastruktur und die Autorisierung erfolgt automatisch im Browser. Die Google Ads API ist eine REST- und gRPC-API, die für größere Unternehmensanwendungen, Drittanbietertools und Datenpipelines mit hohem Volumen entwickelt wurde, die auf Ihren eigenen Servern ausgeführt werden und dedizierte Entwicklertokens und OAuth-Anmeldedaten erfordern.
Benötige ich einen Server, um Google Ads-Scripts auszuführen?
Nein. Google Ads-Skripts werden vollständig in der Cloud-Infrastruktur von Google ausgeführt. Es fallen keine zusätzlichen Kosten an. Sie können Skripts erstellen, sie im Vorschaumodus testen und direkt in der Google Ads-Weboberfläche planen.
Welche Ausführungslimits gelten für Google Ads-Scripts?
Standardskripts in einzelnen Konten können pro Ausführung bis zu 30 Minuten lang ausgeführt werden. Verwaltungskontoskripts, die executeInParallel verwenden, können bis zu 60 Minuten lang in bis zu 50 untergeordneten Konten ausgeführt werden, wenn eine Callback-Funktion angegeben ist. Wenn ein Script das Zeitlimit überschreitet, werden in Google Ads trotzdem alle Änderungen übernommen, die vor dem Abbruch vorgenommen wurden. Ausführliche Informationen zu Zeitüberschreitungen, Kontingenten und Limits für Bulk-Uploads finden Sie unter Limits.
Können Google Ads-Scripts mit externen APIs verbunden werden?
Ja. Google Ads-Scripts enthalten integrierte Dienste wie SpreadsheetApp zum Lesen und Schreiben von Google Sheets, UrlFetchApp zum Senden von HTTP-Anfragen an externe REST APIs und erweiterte Google APIs für die Einbindung von Diensten wie BigQuery und YouTube. Weitere Informationen finden Sie unter Drittanbieter-APIs und Erweiterte Google APIs.
Feedback
Wir freuen uns über Ihr Feedback zu Google Ads-Scripts. Kontaktieren Sie uns auf Discord.
Wenn Sie Unterstützung benötigen, wenden Sie sich an den technischen Support für Skripts.