Wenn Sie sich mit anderen Nutzern über unsere Produkte austauschen und Feedback geben möchten, können Sie dem offiziellen Google Ads-Discord-Kanal auf dem Server der
Google Advertising and Measurement Community beitreten.
Los gehts
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
So starten Sie Ihr erstes Skript:
Google Ads-Konten
- Melden Sie sich in Ihrem Google Ads-Konto an.
- Wählen Sie im Menü „Tools“ in der linken Navigationsleiste Bulk-Aktionen und dann Scripts aus. Sie können diese Seite auch aufrufen, indem Sie in der Google Ads-Suchleiste nach „Scripts“ suchen.
- Drücken Sie das Pluszeichen
, um ein Skript hinzuzufügen. Sie können im Drop-down-Menü nach Skriptvorlagen suchen. Wählen Sie für diese Übung jedoch „Neues Skript“ aus.
- Optional können Sie im Textfeld „Scriptname“ einen Namen für das Script angeben. So behalten Sie den Überblick und wissen, was das Skript macht.
Kopieren Sie den folgenden Code und fügen Sie ihn in den Editorbereich ein. Ersetzen Sie dabei die Hauptfunktion:
function main() {
// Get the campaign names from all the campaigns
const rows = AdsApp.search('SELECT campaign.name FROM campaign');
console.log('My campaigns:');
// Iterate through the campaigns and print the campaign names
for (const row of rows) {
console.log(row.campaign.name);
}
}
Klicken Sie bei Aufforderung auf Autorisieren, damit das Skript in Ihrem Namen auf das Konto zugreifen kann. Dies muss einmal für jedes Skript erfolgen.
Klicken Sie auf Vorschau, um das Script im Vorschaumodus auszuführen.
Die Ergebnisse werden im Bereich Änderungen / Logs angezeigt. In diesem Beispiel sollten Ihre Kampagnennamen in den Logs angezeigt werden.
Wenn Sie mit den Vorschauergebnissen zufrieden sind, klicken Sie auf Ausführen, um das Script auszuführen und die Seite Scripthistorie zu öffnen. Auf dieser Seite werden die zuletzt ausgeführten Skripts mit Informationen zu ihrem Status und ihren Ergebnissen angezeigt.
Wenn Sie eine detaillierte Ansicht der Änderungen und Protokolle aufrufen möchten, klicken Sie in der Spalte Änderungen auf den Link, der dem gerade ausgeführten Skript entspricht. Sie sollten dieselbe Logausgabe sehen, die zuvor in der Vorschau angezeigt wurde.
Verwaltungskonten
Sie benötigen ein Google Ads-Verwaltungskonto, um Ads Manager-Scripts auszuführen.
- Melden Sie sich in Ihrem Google Ads-Verwaltungskonto an.
- Wählen Sie im Menü „Tools“ in der linken Navigationsleiste Bulk-Aktionen und dann Scripts aus. Sie können diese Seite auch aufrufen, indem Sie in der Google Ads-Suchleiste nach „Scripts“ suchen.
- Drücken Sie das Pluszeichen
, um ein Skript hinzuzufügen. Sie können im Drop-down-Menü nach Skriptvorlagen suchen. Wählen Sie für diese Übung jedoch „Neues Skript“ aus.
- Optional können Sie im Textfeld „Scriptname“ einen Namen für das Script angeben. So behalten Sie den Überblick und wissen, was das Skript macht.
Kopieren Sie den folgenden Code und fügen Sie ihn in den Editorbereich ein. Ersetzen Sie dabei die Hauptfunktion:
function main() {
// Retrieve all children accounts.
const accountIterator = AdsManagerApp.accounts().get();
// Iterate through the account list.
for (const account of accountIterator) {
// Get stats for the child account.
const stats = account.getStatsFor("THIS_MONTH");
// And log it.
console.log(`${account.getCustomerId()},${stats.getClicks()},` +
`${stats.getImpressions()},${stats.getCost()}`);
}
}
Klicken Sie bei Aufforderung auf Autorisieren, damit das Skript in Ihrem Namen auf das Konto zugreifen kann. Dies muss einmal für jedes Skript erfolgen.
Klicken Sie auf Vorschau, um das Script im Vorschaumodus auszuführen.
Die Ergebnisse werden im Bereich Änderungen / Logs angezeigt. In diesem Beispiel sollten die Konten Ihrer Kinder und die zugehörigen Messwerte in den Protokollen angezeigt werden.
Wenn Sie mit den Vorschauergebnissen zufrieden sind, klicken Sie auf Ausführen, um das Script auszuführen und die Seite Scripthistorie zu öffnen. Auf dieser Seite werden die zuletzt ausgeführten Skripts mit Informationen zu ihrem Status und ihren Ergebnissen angezeigt.
Wenn Sie eine detaillierte Ansicht der Änderungen und Protokolle aufrufen möchten, klicken Sie in der Spalte Änderungen auf den Link, der dem gerade ausgeführten Skript entspricht. Sie sollten dieselbe Logausgabe sehen, die zuvor in der Vorschau angezeigt wurde.
Weitere Beispiel-Script-Snippets finden Sie auf unserer Beispielseite.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-09-10 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-09-10 (UTC)."],[[["\u003cp\u003eLaunching your first Google Ads script involves signing in, navigating to the Scripts section, and adding a new script.\u003c/p\u003e\n"],["\u003cp\u003eYou need to copy and paste provided code snippets into the script editor to define its functionality, such as analyzing keywords or account statistics.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is necessary for the script to access your account data, and preview mode allows for testing before full execution.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Ads manager accounts are required to run Ads Manager scripts, which can access and process data from multiple child accounts.\u003c/p\u003e\n"],["\u003cp\u003eMore script examples and resources are available on the Google Ads Scripts examples page for further exploration and customization.\u003c/p\u003e\n"]]],[],null,["Follow these steps to launch your first script. \n\nGoogle Ads accounts\n\n1. [Sign in](//ads.google.com/) to your Google Ads account.\n2. From the Tools menu in the left navigation, select **Bulk actions** , then **Scripts**. You can also navigate to this page by searching for \"Scripts\" in the Google Ads search bar.\n3. Press the + icon to add a script. You can browse script templates from the drop-down menu, but for the sake of this exercise, select \"New script\".\n4. You can optionally provide a name for your script in the \"Script name\" text field. This can help you stay organized and remember what the script does.\n5. Copy and paste the following code into the editor area, replacing the main\n function:\n\n function main() {\n // Get the campaign names from all the campaigns\n const rows = AdsApp.search('SELECT campaign.name FROM campaign');\n\n console.log('My campaigns:');\n // Iterate through the campaigns and print the campaign names\n for (const row of rows) {\n console.log(row.campaign.name);\n }\n }\n\n6. When prompted, click **Authorize** so the script can access the account on\n your behalf. This has to be done once for each script.\n\n7. Click **Preview** to run the script in [preview mode](/google-ads/scripts/docs/concepts/preview).\n Results will appear in the **Changes** / **Logs** panel. For this example,\n you should see your campaign names displayed in the Logs.\n\n8. When you're happy with the preview results, click **Run** to run your\n script and open the **Script history** page. This page displays the\n most recently run scripts, with information on their status and results.\n\n9. To get a detailed view of changes and logs, click the link in the\n **Changes** column that corresponds to the script you just ran. You should\n see the same log output that was previewed before.\n\nManager accounts\n\nYou must first have a\n[Google Ads manager account](//support.google.com/google-ads/answer/6139186)\nto run Ads Manager scripts.\n\n1. [Sign in](//ads.google.com/) to your Google Ads manager account.\n2. From the Tools menu in the left navigation, select **Bulk actions** , then **Scripts**. You can also navigate to this page by searching for \"Scripts\" in the Google Ads search bar.\n3. Press the + icon to add a script. You can browse script templates from the drop-down menu, but for the sake of this exercise, select \"New script\".\n4. You can optionally provide a name for your script in the \"Script name\" text field. This can help you stay organized and remember what the script does.\n5. Copy and paste the following code into the editor area, replacing the main\n function:\n\n function main() {\n // Retrieve all children accounts.\n const accountIterator = AdsManagerApp.accounts().get();\n\n // Iterate through the account list.\n for (const account of accountIterator) {\n // Get stats for the child account.\n const stats = account.getStatsFor(\"THIS_MONTH\");\n // And log it.\n console.log(`${account.getCustomerId()},${stats.getClicks()},` +\n `${stats.getImpressions()},${stats.getCost()}`);\n }\n }\n\n6. When prompted, click **Authorize** so the script can access the account on\n your behalf. This has to be done once for each script.\n\n7. Click **Preview** to run the script in [preview mode](/google-ads/scripts/docs/concepts/preview).\n Results will appear in the **Changes** / **Logs** panel. For this example,\n you should see your children accounts and their metrics displayed in the\n Logs.\n\n8. When you're happy with the preview results, click **Run** to run your\n script and open the **Script history** page. This page displays the\n most recently run scripts, with information on their status and results.\n\n9. To get a detailed view of changes and logs, click the link in the\n **Changes** column that corresponds to the script you just ran. You should\n see the same log output that was previewed before.\n\nFor more sample script snippets, check out our\n[examples page](/google-ads/scripts/docs/examples)."]]