Tak, ChatGPT, Claude czy Gemini napiszą Ci użyteczne skrypty Google Ads. Niebezpiecznie robi się dopiero wtedy, gdy uruchamiasz kod bez czytania. Modele językowe dobrze znają podstawową strukturę, ale mylą nazwy pól, sięgają po przestarzałe metody i zapominają, że koszty przychodzą w mikrojednostkach. Stały proces to wyłapuje: dokładnie opisz zadanie, dołącz fragment dokumentacji, przeczytaj kod, przetestuj go w podglądzie i wprowadzaj zmiany dopiero po przeglądzie.
W tym artykule dostajesz ten proces razem z szablonami promptów, cztery kompletne, skomentowane przykładowe skrypty (tylko do odczytu albo z DRY_RUN = true) oraz błędy, które wciąż znajduję w kodzie z AI, za każdym razem w wersji błędnej i poprawnej. Jak działa AI w samym Google Ads, czyli Smart Bidding, Performance Max i AI Max, opisuję w artykule AI i automatyzacja w Google Ads. Tutaj chodzi o kod, który sam wprowadzasz na konto.
Stan: 8.10.2026. Podstawą jest dokumentacja dla programistów dotycząca skryptów Google Ads (strona z limitami ostatnio zaktualizowana 30.09.2026) oraz dokumentacja pól Google Ads API w wersji v25. Wszystkie skrypty to skonstruowane przykłady bez danych z kont. Źródła znajdziesz na końcu artykułu.
Czym są skrypty Google Ads i co potrafią
Skrypty Google Ads to programy w JavaScripcie, które działają bezpośrednio na Twoim koncie Google Ads. Google opisuje je jako sposób na programowe zarządzanie danymi Google Ads i ich odpytywanie w środowisku programistycznym w przeglądarce, dla jednego konta albo dla wielu kont przez konto menedżera (Google, przegląd skryptów). Własny serwer nie jest potrzebny.
Typowe zadania:
- automatyczne zapisywanie raportów w Arkuszach Google
- alert e-mailem, gdy koszty lub kliknięcia wychodzą poza normę
- sprawdzanie adresów URL stron docelowych pod kątem błędów
- zmiana stawek, budżetów lub etykiet według stałych reguł
Według Google zaplanowane skrypty działają także wtedy, gdy nikt nie jest zalogowany (Autoryzacja). Od marca 2022 nowe środowisko skryptów jest dostępne w pełnej wersji, z nowoczesnym JavaScriptem, czyli let, klasami i pętlami for...of (Google Ads Developer Blog, marzec 2022). Google zapowiedziało, że od września 2022 zacznie automatycznie migrować stare skrypty, a w październiku 2022 przeniesie wszystkie (Developer Blog, sierpień 2022). Dla kodu z AI ma to znaczenie: w sieci jest mnóstwo przykładowego kodu sprzed tej zmiany, a z mojej praktyki wynika, że modele chętnie mieszają stare wzorce z nowymi.
Limity z dokumentacji
| Limit | Wartość według Google |
|---|---|
| Czas działania jednego uruchomienia na koncie reklamodawcy | 30 minut, potem przerwanie |
| Czas działania na koncie menedżera z executeInParallel i funkcją zwrotną | do 60 minut, do 50 kont |
| Wyniki na jeden iterator | domyślnie maksymalnie 50 000 |
| Identyfikatory w withIds() | maksymalnie 10 000 |
| Dane wyjściowe dziennika | obcinane przy 100 KB |
| Autoryzowane skrypty na konto | 250, powyżej tej liczby starszy skrypt tymczasowo traci autoryzację |
| Odbiorcy e-maili dziennie (MailApp) | 100 na prywatnym koncie Google, 1500 w Google Workspace |
| Wywołania URL Fetch dziennie (UrlFetchApp) | 20 000 na prywatnym koncie Google, 100 000 w Google Workspace |
Pierwsze sześć wierszy pochodzi ze strony limity skryptów Google Ads. Dwa ostatnie pochodzą z limitów Google Apps Script, bo poczta, pobieranie adresów URL i arkusze działają przez usługi Apps Script. Te limity obowiązują na użytkownika i resetują się 24 godziny po pierwszym żądaniu. Szczegół, którego kod z AI prawie nigdy nie uwzględnia: jeśli skrypt zostanie przerwany po 30 minutach, według Google wszystkie zmiany wprowadzone do tego momentu zostają zastosowane. Skrypt, który zmienia stawki i urywa się w połowie, zostawia więc konto przebudowane do połowy.
Jak utworzyć skrypt
- W Google Ads otwórz w menu po lewej stronie Narzędzia > Działania zbiorcze > Skrypty. Możesz też wyszukać „Skrypty” na pasku wyszukiwania Google Ads.
- Kliknij ikonę plusa i wybierz „Nowy skrypt”. W tym samym menu znajdziesz też szablony skryptów od Google.
- Nadaj skryptowi nazwę i wklej kod do edytora.
- Przy pierwszym podglądzie kliknij „Autoryzuj”, gdy pojawi się komunikat. Trzeba to zrobić raz dla każdego skryptu, potem skrypt uzyskuje dostęp do konta w Twoim imieniu.
- Kliknij „Podgląd”. Wyniki i dzienniki pojawią się w panelu „Zmiany / Dzienniki”.
- Dopiero gdy podgląd wygląda dobrze, kliknij „Uruchom”. Otworzy się strona „Historia skryptów” ze stanem i wynikami.
Nazwy pochodzą z polskiej wersji przewodnika Google dla początkujących. Na Twoim koncie mogą się nieznacznie różnić.
Podgląd a uruchomienie: najważniejsza różnica
Według Google skrypty uruchomione w trybie podglądu nie wprowadzają żadnych zmian w rzeczywistych danych kampanii (dokumentacja podglądu). Haczyk jest zaraz potem: tryb podglądu dotyczy tylko wywołań, które zaczynają się od AdsApp. Pozostałe usługi działają normalnie. E-mail wysłany przez MailApp wychodzi, a arkusz Google zostaje zapisany, niezależnie od tego, czy był to podgląd, czy prawdziwe uruchomienie. Podgląd niczego też nie tworzy. Kod, który tworzy nowy obiekt i od razu go używa, zachowuje się tam inaczej niż w prawdziwym uruchomieniu.
Z tego wynikają dwie zasady dla wszystkich skryptów w tym artykule:
- E-maile wychodzą tylko wtedy, gdy
AdsApp.getExecutionInfo().isPreview()zwraca false. Dokładnie ten wzorzec pokazuje Google w dokumentacji ExecutionInfo. - Zmiany na koncie są ukryte za przełącznikiem
DRY_RUN. Dopóki ma wartość true, skrypt tylko zapisuje w dzienniku, co by zrobił.
Harmonogram i dzienniki
Dla każdego skryptu możesz ustawić harmonogram. Gotowe rozwiązania Google pokazują rozpiętość: Link Checker ma działać co godzinę, a Account Summary codziennie o 3:00 lub później, bo według Google statystyki Google Ads mogą być opóźnione nawet o trzy godziny. To opóźnienie dotyczy każdego skryptu, który liczy na danych z poprzedniego dnia.
Zaplanowane skrypty działają w imieniu osoby, która je autoryzowała. Jeśli ta osoba straci dostęp do konta, skrypt przestaje działać. Zostaje jednak zachowany, dopóki ktoś z dostępem nie autoryzuje go ponownie. Gdy odchodzi koleżanka, która ustawiła wszystkie skrypty, zauważysz to inaczej dopiero wtedy, gdy przestaną przychodzić alerty.
Dzienniki zapisujesz za pomocą console.log(). Pojawiają się w podglądzie w panelu „Zmiany / Dzienniki”, a po prawdziwym uruchomieniu w historii skryptów. Wszystko powyżej 100 KB Google obcina, więc lepiej zapisywać podsumowania niż każdy pojedynczy wiersz.
Proces pracy z AI
Tak pracuję, niezależnie od tego, czy z ChatGPT, Claude czy Gemini. Z mojego doświadczenia o jakości bardziej decyduje kontekst, który podajesz, niż wybór modelu. Szablony promptów do zadań bez kodu, od klastrów słów kluczowych po raport miesięczny, znajdziesz w artykule Prompty ChatGPT do Google Ads.
1. Dokładnie opisz zadanie
„Zrób mi skrypt do alertów budżetowych” daje kod, który coś tam robi. Zamiast tego opisz:
- jakie dane skrypt odczytuje (zasób, zakres dat, typy kampanii)
- jaki próg obowiązuje i w jakiej jednostce (waluta konta czy mikrojednostki)
- co dzieje się na końcu (dziennik, e-mail, arkusz, etykieta)
- czego skrypt w żadnym wypadku nie może robić, np. zmieniać stawek, budżetów czy stanu
2. Podaj kontekst
Skopiuj do promptu fragmenty opisujące metody, których skrypt ma używać, z dokumentacji AdsApp, a do tego pola GAQL z dokumentacji pól Google Ads API. Z mojej praktyki wynika, że wyraźnie zmniejsza to liczbę wymyślonych metod. Strukturę konta opisz abstrakcyjnie: „kampanie w sieci wyszukiwania i jedna kampania Performance Max, waluta EUR, strefa czasowa Europe/Berlin”. Nazwy kampanii, identyfikatory klientów i wyszukiwane hasła nie są modelowi potrzebne.
3. Poproś o kod, z jasnymi zasadami
Ten szablon traktuję jako punkt wyjścia. Fragmenty w nawiasach kwadratowych zastąp własnymi:
Jesteś doświadczonym programistą skryptów Google Ads.
Zadanie: [DOKŁADNY OPIS, np. "porównaj koszty bieżącego miesiąca z
miesięcznym budżetem i wyślij alert e-mailem"]
Kontekst:
- Środowisko: skrypty Google Ads (aktualne środowisko skryptów, JavaScript
z let/const i for...of). Zapytania przez AdsApp.search() i GAQL,
bez kolumn AWQL.
- Konto: [ABSTRAKCYJNA STRUKTURA, np. "tylko kampanie w sieci wyszukiwania,
waluta EUR, strefa czasowa Europe/Berlin"]. Bez prawdziwych nazw i ID.
- Fragment dokumentacji: [WKLEJ FRAGMENTY Z OFICJALNEJ DOKUMENTACJI]
Zasady:
1. Używaj tylko metod i pól, które są we fragmencie dokumentacji albo
w oficjalnej dokumentacji skryptów Google Ads. Niczego nie wymyślaj.
Jeśli nie masz pewności, powiedz to wprost.
2. Skrypt niczego nie zmienia na koncie. [ALBO: zmiany tylko przy
DRY_RUN = false. Domyślnie DRY_RUN = true, wtedy tylko dziennik.]
3. GAQL zwraca koszty w mikrojednostkach: podziel przez 1 000 000.
4. Daty twórz w strefie czasowej konta
(AdsApp.currentAccount().getTimeZone()).
5. E-maile wysyłaj tylko, gdy AdsApp.getExecutionInfo().isPreview() ma
wartość false.
6. Ograniczaj ilość danych (LIMIT lub withLimit), a przy długich
uruchomieniach sprawdzaj pozostały czas przez getRemainingTime().
7. Skomentuj każdą sekcję po polsku i na końcu wypisz wszystkie użyte
metody z linkiem do odpowiedniej strony dokumentacji.
4. Przeczytaj kod
Zanim cokolwiek uruchomisz, przeczytaj każdą linię. Moja checklista:
- Każda metoda występuje w dokumentacji skryptów Google Ads albo Apps Script. Linki podane przez model otwierasz sam.
- Każde pole GAQL istnieje w dokumentacji pól odpytywanego zasobu.
- W wynikach pola mają zapis lowerCamelCase:
metrics.cost_microsz zapytania staje sięrow.metrics.costMicros(Google, raporty w skryptach). - Kwoty są konsekwentnie albo w mikrojednostkach, albo w walucie konta.
- Metody, które zmieniają kampanie, stawki, budżety lub stan, występują tylko w gałęzi
DRY_RUN. - Wiesz, co
MailApp,UrlFetchAppiSpreadsheetApprobią już w podglądzie. - Są limity: LIMIT lub withLimit, kontrola pozostałego czasu, rozsądna liczba e-maili.
Drugi model w roli recenzenta znajduje kolejne błędy. Wklejam do tego kod w nowym czacie:
Sprawdź ten skrypt Google Ads jak surowy recenzent kodu.
1. Wypisz każdą wywoływaną metodę i każde pole GAQL i przy każdym podaj,
czy istnieje w oficjalnej dokumentacji skryptów Google Ads lub
Google Ads API. Oznacz wszystko, czego nie możesz pewnie potwierdzić.
2. Wskaż wszystkie miejsca, w których skrypt zmienia dane na koncie,
wysyła e-maile lub zapisuje arkusze.
3. Sprawdź jednostki (mikrojednostki czy waluta konta), strefy czasowe
i granice dat.
4. Sprawdź, czy przy dużej ilości danych skrypt nie trafi na limity
(30 minut działania, 50 000 wyników na iterator).
Nie zmieniaj kodu. Podaj tylko ponumerowaną listę usterek.
[WKLEJ KOD]
5. Przetestuj w podglądzie
Uruchom podgląd i przeczytaj dzienniki. Jeśli skrypt zgłasza, że jakieś pole jest undefined, zapisz w dzienniku jeden wiersz wyniku przez console.log(JSON.stringify(row)). Wtedy zobaczysz prawdziwe nazwy pól. Ślepe kopiowanie nie pomaga zresztą nawet przy przykładach od Google: na stronie z dobrymi praktykami jeden przykład odpytuje metrics.cost_micros, a potem zapisuje w dzienniku row.metrics.cost, czyli pole, o które w ogóle nie pytał.
Gdy skrypt się wywraca, pomaga ten szablon:
Skrypt przerywa działanie w podglądzie z tym komunikatem:
[DOKŁADNY KOMUNIKAT BŁĘDU]
Dziennik jednego wiersza wyniku, wartości zastąpione symbolami:
[WYNIK JSON.stringify(row), ZANONIMIZOWANY]
Znajdź przyczynę. Używaj tylko metod z oficjalnej dokumentacji i wyjaśnij
zmianę w dwóch zdaniach, zanim pokażesz poprawiony kod.
6. Zabezpiecz się
Nowy skrypt testuj najpierw na koncie, na którym niewiele ryzykujesz, albo ogranicz go do jednej kampanii, np. warunkiem campaign.name = 'Kampania testowa' w zapytaniu GAQL lub przez etykietę. Na koncie menedżera zacznij od jednego konta klienta.
7. Wdrażaj stopniowo
DRY_RUN = true, podgląd, czytanie dzienników.DRY_RUN = true, prawdziwe uruchomienie przez „Uruchom”, sprawdzenie historii skryptów.DRY_RUN = false, ale tylko dla jednej kampanii lub jednej etykiety.- Rozszerzenie zakresu i dopiero wtedy ustawienie harmonogramu.
Cztery przykładowe skrypty do dopasowania
Wszystkie cztery skrypty odczytują dane przez AdsApp.search() i GAQL, tak jak Google zaleca na stronie z dobrymi praktykami. Wartości pisane wielkimi literami na początku to przykłady, które dopasowujesz do swojego konta. Żaden ze skryptów nie zmienia stawek, budżetów ani stanu. Skrypt 3 może oznaczyć reklamy etykietą, ale tylko wtedy, gdy świadomie ustawisz DRY_RUN na false.
Skrypt 1: alert tempa wydawania budżetu e-mailem
Skrypt porównuje koszty od pierwszego dnia miesiąca do wczoraj z proporcjonalną częścią miesięcznego budżetu i szacuje, gdzie wylądujesz na koniec miesiąca. Jeśli konto wychodzi poza tolerancję, przychodzi e-mail. Dzisiejszy dzień celowo pomijam, bo jeszcze trwa, a statystyki mogą być opóźnione.
/**
* Alert tempa wydawania budżetu (tylko do odczytu)
* Porównuje koszty od pierwszego dnia miesiąca do wczoraj z proporcjonalną
* częścią miesięcznego budżetu i wysyła e-mail, gdy konto wydaje za szybko
* lub za wolno. Niczego nie zmienia na koncie.
*/
const MONTHLY_BUDGET = 3000; // budżet miesięczny w walucie konta (przykład)
const UPPER_LIMIT = 1.15; // alert przy 15 % powyżej planu (przykład)
const LOWER_LIMIT = 0.85; // alert przy 15 % poniżej planu (przykład)
const EMAIL = 'ty@example.com'; // odbiorca alertu
function main() {
const account = AdsApp.currentAccount();
const timeZone = account.getTimeZone();
const now = new Date();
// Daty zawsze w strefie czasowej konta
const day = Number(Utilities.formatDate(now, timeZone, 'd'));
const month = Number(Utilities.formatDate(now, timeZone, 'M'));
const year = Number(Utilities.formatDate(now, timeZone, 'yyyy'));
const daysInMonth = new Date(year, month, 0).getDate();
if (day === 1) {
console.log('Pierwszy dzień miesiąca: brak pełnego dnia do porównania.');
return;
}
const firstDay = Utilities.formatDate(now, timeZone, 'yyyy-MM') + '-01';
// 24 godziny wstecz to wczoraj w czasie konta (nie planować tuż po północy)
const yesterday = Utilities.formatDate(
new Date(now.getTime() - 24 * 60 * 60 * 1000), timeZone, 'yyyy-MM-dd');
const query =
'SELECT metrics.cost_micros FROM customer ' +
"WHERE segments.date BETWEEN '" + firstDay + "' AND '" + yesterday + "'";
let costMicros = 0;
for (const row of AdsApp.search(query)) {
costMicros += Number(row.metrics.costMicros); // nazwa pola w lowerCamelCase
}
const cost = costMicros / 1000000; // mikrojednostki na walutę konta
const daysDone = day - 1;
const plan = MONTHLY_BUDGET * daysDone / daysInMonth;
const forecast = cost / daysDone * daysInMonth;
const ratio = cost / plan;
const currency = account.getCurrencyCode();
const summary =
'Koszty do wczoraj: ' + cost.toFixed(2) + ' ' + currency + '\n' +
'Plan do wczoraj: ' + plan.toFixed(2) + ' ' + currency + '\n' +
'Prognoza na koniec miesiąca: ' + forecast.toFixed(2) + ' ' + currency;
console.log(summary);
if (ratio > UPPER_LIMIT || ratio < LOWER_LIMIT) {
const subject = 'Tempo budżetu ' + account.getName() + ': ' +
Math.round(ratio * 100) + ' % planu';
if (AdsApp.getExecutionInfo().isPreview()) {
console.log('Podgląd, bez e-maila. Temat byłby: ' + subject);
} else {
MailApp.sendEmail(EMAIL, subject, summary);
}
}
}
Użyte metody: AdsApp.currentAccount() z getTimeZone(), getCurrencyCode() i getName() z dokumentacji Account, Utilities.formatDate(), AdsApp.search(), AdsApp.getExecutionInfo().isPreview() i MailApp.sendEmail(). GAQL: zasób customer, pola metrics.cost_micros i segments.date.
Zasób customer obejmuje całe konto. Jeśli masz osobne budżety dla różnych grup kampanii, odpytuj zamiast tego campaign i filtruj warunkiem na campaign.name. Zaplanuj skrypt codziennie przed południem.
Skrypt 2: wyszukiwane hasła z kosztami, ale bez konwersji, do arkusza
Skrypt zapisuje w Arkuszu Google najdroższe wyszukiwane hasła z ostatnich 30 dni, które nie przyniosły konwersji. Na koncie niczego nie zmienia. To Ty decydujesz, które hasła wykluczyć, a pomoże Ci w tym moja lista wykluczających słów kluczowych.
/**
* Wyszukiwane hasła z kosztami, ale bez konwersji (na koncie tylko odczyt)
* Zapisuje najdroższe wyszukiwane hasła z ostatnich 30 dni bez konwersji
* w Arkuszu Google. Uwaga: arkusz jest zapisywany także w podglądzie.
*/
const SPREADSHEET_URL = 'https://docs.google.com/spreadsheets/d/ID-ARKUSZA/edit';
const SHEET_NAME = 'Hasła bez konwersji';
const MIN_COST = 20; // minimalny koszt w walucie konta (przykład)
const MAX_ROWS = 500; // górny limit zapytania
function main() {
const minCostMicros = Math.round(MIN_COST * 1000000); // próg w mikrojednostkach
// search_term_view nie zawiera danych Performance Max
const query =
'SELECT search_term_view.search_term, campaign.name, ad_group.name, ' +
'metrics.clicks, metrics.cost_micros, metrics.conversions ' +
'FROM search_term_view ' +
'WHERE segments.date DURING LAST_30_DAYS ' +
'AND metrics.cost_micros > ' + minCostMicros + ' ' +
'ORDER BY metrics.cost_micros DESC ' +
'LIMIT ' + MAX_ROWS;
const output = [];
for (const row of AdsApp.search(query)) {
// Konwersje to liczby dziesiętne, możliwe są ułamki
if (Number(row.metrics.conversions) > 0) {
continue;
}
output.push([
row.searchTermView.searchTerm,
row.campaign.name,
row.adGroup.name,
Number(row.metrics.clicks),
Number(row.metrics.costMicros) / 1000000,
]);
}
const header = ['Wyszukiwane hasło', 'Kampania', 'Grupa reklam', 'Kliknięcia', 'Koszt'];
const spreadsheet = SpreadsheetApp.openByUrl(SPREADSHEET_URL);
const sheet = spreadsheet.getSheetByName(SHEET_NAME) ||
spreadsheet.insertSheet(SHEET_NAME);
sheet.clearContents();
sheet.getRange(1, 1, 1, header.length).setValues([header]);
if (output.length > 0) {
sheet.getRange(2, 1, output.length, header.length).setValues(output);
}
console.log('Zapisano haseł bez konwersji: ' + output.length);
}
Użyte metody: AdsApp.search(), SpreadsheetApp.openByUrl(), getSheetByName(), insertSheet(), clearContents(), getRange() i setValues() z dokumentacji Apps Script. GAQL: zasób search_term_view z search_term_view.search_term, metrics.clicks, metrics.cost_micros i metrics.conversions.
W tym raporcie brakuje Performance Max: według dokumentacji pól search_term_view nie zawiera danych PMax, a Google odsyła w zamian do zasobu campaign_search_term_view. LIMIT działa przed filtrem konwersji w kodzie, więc może przyjść mniej niż 500 wierszy. Arkusz jest zapisywany już w podglądzie, bo arkusze nie są wywołaniem AdsApp, dlatego do testów użyj osobnego arkusza testowego. Zapis odbywa się jednym wywołaniem setValues() zamiast wiersz po wierszu, tak jak Google zaleca na stronie z dobrymi praktykami. Jakie jeszcze wskaźniki są potrzebne do takich analiz, opisuję w artykule Raporty i analiza Google Ads.
Skrypt 3: Link Checker dla końcowych adresów URL z DRY_RUN
Skrypt raz wywołuje każdy końcowy URL aktywnych reklam i zgłasza wszystko, co nie odpowiada kodem stanu 200. Przy DRY_RUN = true tylko zapisuje dziennik, a po prawdziwym uruchomieniu wysyła e-mail. Przy DRY_RUN = false reklamy, których to dotyczy, dostają dodatkowo etykietę, którą wcześniej utworzysz na koncie. Etykieta sama w sobie nie zmienia stawek, budżetów ani stanu, dlatego dobrze nadaje się na pierwszą zmianę do przećwiczenia. Sprawdź jednak, czy reguły automatyczne lub inne skrypty na Twoim koncie nie reagują na etykiety.
/**
* Link Checker dla końcowych adresów URL aktywnych reklam
* Raz wywołuje każdy końcowy URL i zgłasza wszystko, co nie odpowiada
* kodem 200. Przy DRY_RUN = true skrypt niczego nie zmienia na koncie.
* Przy DRY_RUN = false reklamy z błędami dostają etykietę, która musi
* wcześniej istnieć na koncie.
*/
const DRY_RUN = true; // true: tylko sprawdzanie i dziennik
const LABEL_NAME = 'Błąd linku'; // musi już istnieć na koncie
const EMAIL = 'ty@example.com';
const MAX_URLS = 300; // górny limit na uruchomienie (przykład)
const TIME_BUFFER_SECONDS = 120; // zapas przed limitem 30 minut
function main() {
const query =
'SELECT ad_group.id, ad_group_ad.ad.id, ad_group_ad.ad.final_urls ' +
'FROM ad_group_ad ' +
"WHERE ad_group_ad.status = 'ENABLED' " +
"AND ad_group.status = 'ENABLED' " +
"AND campaign.status = 'ENABLED'";
// Każdy URL sprawdzany tylko raz, ale z zapamiętaniem reklam, które go używają
const adsByUrl = new Map();
for (const row of AdsApp.search(query)) {
const urls = row.adGroupAd.ad.finalUrls || [];
for (const url of urls) {
if (!adsByUrl.has(url)) {
adsByUrl.set(url, []);
}
adsByUrl.get(url).push([String(row.adGroup.id), String(row.adGroupAd.ad.id)]);
}
}
const executionInfo = AdsApp.getExecutionInfo();
const broken = [];
let checked = 0;
for (const url of adsByUrl.keys()) {
if (checked >= MAX_URLS ||
executionInfo.getRemainingTime() < TIME_BUFFER_SECONDS) {
console.log('Osiągnięto limit, resztę sprawdzi kolejne uruchomienie.');
break;
}
checked++;
let status;
try {
// muteHttpExceptions: 404 lub 500 nie rzucają błędu, tylko zwracają kod
status = UrlFetchApp.fetch(url, {muteHttpExceptions: true}).getResponseCode();
} catch (e) {
status = 'Błąd: ' + e.message; // np. domena nieosiągalna
}
if (status !== 200) {
broken.push({url: url, status: status, adIds: adsByUrl.get(url)});
}
}
console.log('Sprawdzono ' + checked + ' z ' + adsByUrl.size + ' URL, ' +
'z problemami: ' + broken.length);
if (broken.length === 0) {
return;
}
const report = broken.map(function(item) {
return item.status + ' ' + item.url + ' (reklamy: ' + item.adIds.length + ')';
}).join('\n');
console.log(report);
if (DRY_RUN) {
console.log('DRY_RUN: nie ustawiono etykiet.');
} else {
const labelExists = AdsApp.labels()
.withCondition("label.name = '" + LABEL_NAME + "'")
.get()
.hasNext();
if (!labelExists) {
console.log('Brak etykiety "' + LABEL_NAME + '". Najpierw utwórz ją na koncie.');
} else {
for (const item of broken) {
const ads = AdsApp.ads().withIds(item.adIds).get();
while (ads.hasNext()) {
ads.next().applyLabel(LABEL_NAME);
}
}
}
}
if (!executionInfo.isPreview()) {
MailApp.sendEmail(EMAIL, 'Link Checker: błędne URL: ' + broken.length, report);
}
}
Użyte metody: AdsApp.search(), AdsApp.getExecutionInfo() z getRemainingTime() i isPreview(), UrlFetchApp.fetch() z getResponseCode(), AdsApp.labels().withCondition(), AdsApp.ads().withIds() z parami identyfikatora grupy reklam i identyfikatora reklamy zgodnie z dokumentacją AdSelector, applyLabel() i MailApp.sendEmail(). GAQL: zasób ad_group_ad z ad_group_ad.ad.final_urls, czyli polem z listą wartości.
UrlFetchApp domyślnie podąża za przekierowaniami, więc 301 na działającą stronę liczy się jako 200 (dokumentacja UrlFetchApp). Każde wywołanie obciąża dzienny limit pobierania adresów URL, a wywołania odbywają się także w podglądzie, bo nie przechodzą przez AdsApp. Tutaj to nieszkodliwe, bo skrypt tylko odczytuje strony. Według dokumentacji applyLabel() kończy się błędem, jeśli etykieta nie istnieje, dlatego skrypt sprawdza to wcześniej. Ta prosta wersja sprawdza tylko końcowe adresy URL reklam, bez szablonów śledzenia, parametrów niestandardowych i adresów mobilnych. Pełny Link Checker od Google sprawdza też słowa kluczowe i linki do podstron, a duże konta przerabia w kilku cogodzinnych uruchomieniach. Z doświadczenia wiem, że niektóre serwery blokują automatyczne żądania i odpowiadają kodem 403, choć strona działa dla ludzi. Takie wyniki sprawdzaj ręcznie.
Skrypt 4: alert anomalii dla kliknięć i kosztów
Skrypt porównuje wczorajszy dzień ze średnią z tego samego dnia tygodnia z czterech poprzednich tygodni i wysyła alert przy dużym odchyleniu. Porównanie z tym samym dniem tygodnia jest stabilniejsze niż z dniem poprzednim, bo w większości kont, które widzę, poszczególne dni tygodnia wyglądają bardzo różnie.
/**
* Alert anomalii dla kliknięć i kosztów (tylko do odczytu)
* Porównuje wczorajszy dzień ze średnią z tego samego dnia tygodnia
* z czterech poprzednich tygodni i wysyła e-mail przy dużym odchyleniu.
*/
const WEEKS_BACK = 4; // liczba tygodni do porównania
const THRESHOLD = 0.4; // alert przy 40 % odchylenia (przykład)
const MIN_CLICKS = 30; // poniżej porównanie jest zbyt chwiejne (przykład)
const EMAIL = 'ty@example.com';
function main() {
const account = AdsApp.currentAccount();
const timeZone = account.getTimeZone();
const currency = account.getCurrencyCode();
const dayMs = 24 * 60 * 60 * 1000;
const now = Date.now();
// Data sprzed n dni w strefie czasowej konta
const dateDaysAgo = function(n) {
return Utilities.formatDate(new Date(now - n * dayMs), timeZone, 'yyyy-MM-dd');
};
const yesterday = dateDaysAgo(1);
const compareDays = [];
for (let week = 1; week <= WEEKS_BACK; week++) {
compareDays.push(dateDaysAgo(1 + 7 * week));
}
const firstDay = compareDays[compareDays.length - 1];
const query =
'SELECT segments.date, metrics.clicks, metrics.cost_micros FROM customer ' +
"WHERE segments.date BETWEEN '" + firstDay + "' AND '" + yesterday + "'";
const byDate = new Map();
for (const row of AdsApp.search(query)) {
byDate.set(row.segments.date, {
clicks: Number(row.metrics.clicks),
cost: Number(row.metrics.costMicros) / 1000000,
});
}
// Dni, w których wszystkie wartości wynoszą 0, API nie zwraca: liczyć jako 0
const valuesFor = function(date) {
return byDate.get(date) || {clicks: 0, cost: 0};
};
const last = valuesFor(yesterday);
let sumClicks = 0;
let sumCost = 0;
for (const date of compareDays) {
sumClicks += valuesFor(date).clicks;
sumCost += valuesFor(date).cost;
}
const avgClicks = sumClicks / WEEKS_BACK;
const avgCost = sumCost / WEEKS_BACK;
if (avgClicks < MIN_CLICKS) {
console.log('Za mało kliknięć na sensowne porównanie.');
return;
}
const clickChange = (last.clicks - avgClicks) / avgClicks;
const costChange = avgCost > 0 ? (last.cost - avgCost) / avgCost : 0;
const summary =
'Wczoraj (' + yesterday + '): kliknięcia ' + last.clicks + ', koszt ' +
last.cost.toFixed(2) + ' ' + currency + '\n' +
'Średnia z tego samego dnia tygodnia: kliknięcia ' + avgClicks.toFixed(1) +
', koszt ' + avgCost.toFixed(2) + ' ' + currency + '\n' +
'Odchylenie: kliknięcia ' + Math.round(clickChange * 100) + ' %, koszt ' +
Math.round(costChange * 100) + ' %';
console.log(summary);
if (Math.abs(clickChange) > THRESHOLD || Math.abs(costChange) > THRESHOLD) {
const subject = 'Anomalia na koncie ' + account.getName();
if (AdsApp.getExecutionInfo().isPreview()) {
console.log('Podgląd, bez e-maila. Temat byłby: ' + subject);
} else {
MailApp.sendEmail(EMAIL, subject, summary);
}
}
}
Użyte metody: AdsApp.currentAccount() z getTimeZone(), getCurrencyCode() i getName(), Utilities.formatDate(), AdsApp.search(), isPreview() i MailApp.sendEmail(). GAQL: zasób customer z segments.date, metrics.clicks i metrics.cost_micros.
Google liczy zakresy dat GAQL w strefie czasowej konta (zakresy dat w GAQL), dlatego skrypt także własne daty tworzy w tej strefie. Przy zapytaniach z segmentacją API w ogóle nie zwraca wierszy, w których wszystkie wybrane wskaźniki wynoszą 0 (Google, zero metrics). Skrypt z AI, który po prostu uśrednia otrzymane wiersze, zawyży wtedy średnią. Konwersje celowo pomijam w tym alercie: z mojej praktyki wynika, że często spływają jeszcze przez kilka dni po kliknięciu, a poprzedni dzień wyglądałby prawie zawsze za słabo. Zaplanuj skrypt codziennie o 3:00 lub później. Jeśli chcesz więcej, w bibliotece rozwiązań Google znajdziesz rozbudowany Account Anomaly Detector.
Typowe błędy w kodzie z AI
Te błędy najczęściej znajduję w skryptach generowanych przez AI. Potwierdzenie znajdziesz w dokumentacji podlinkowanej pod tabelą.
| Błąd | Jak go rozpoznać | Poprawnie |
|---|---|---|
| Kolumny AWQL ze starego kodu | warunki typu 'Clicks > 10' albo 'Cost > 50' | pola GAQL, np. 'metrics.clicks > 10', Google wprost zaleca GAQL zamiast AWQL |
| Nazwy pól z zapytania użyte w wynikach | row.metrics.cost_micros ma wartość undefined | row.metrics.costMicros, pola wyników mają zapis lowerCamelCase |
| Mikrojednostki pomylone z walutą | próg 50 porównywany z cost_micros, skrypt alarmuje prawie przy każdym kliknięciu | pomnóż próg przez 1 000 000 albo podziel wynik przez 1 000 000 |
| Przestarzałe metody | getAveragePosition(), getRemainingGetQuota() | według dokumentacji getAveragePosition() od końca września 2019 zwraca tylko null, a metody limitów są przestarzałe, bo limitu już nie ma |
| Wymyślone metody | campaign.getCost() albo withStatus('ENABLED') na selektorze | koszty przez getStatsFor(...).getCost() albo GAQL, stan przez withCondition() |
| Tylko kampanie w sieci wyszukiwania i sieci reklamowej | AdsApp.campaigns() nie znajduje kampanii Performance Max, produktowych ani wideo | performanceMaxCampaigns(), shoppingCampaigns(), videoCampaigns() albo GAQL na campaign |
| Brak limitów | pętla po wszystkich słowach kluczowych bez withLimit(), bez kontroli pozostałego czasu | LIMIT lub withLimit() i getRemainingTime() |
| Zignorowana strefa czasowa | data zbudowana przez new Date() i toISOString() | Utilities.formatDate() ze strefą czasową konta |
| Źle zrozumiany podgląd | e-mail albo arkusz „tylko na próbę” w podglądzie | sprawdzanie isPreview(), arkusz testowy |
| Brakujące dni zerowe | średnia tylko z dni, które zwróciło API | brakujące dni liczyć jako 0 |
Tabelę można przewijać w bok
Potwierdzenia: CampaignSelector (warunki GAQL, koszty w mikrojednostkach), dobre praktyki (GAQL zamiast AWQL, search zamiast report), Stats (getCost() w walucie konta, getAveragePosition() przestarzała), ExecutionInfo (metody limitów przestarzałe), AdsApp (campaigns() zwraca kampanie w sieci wyszukiwania i sieci reklamowej).
Trzy z tych błędów w kodzie, za każdym razem źle i dobrze:
// ŹLE: kolumna AWQL ze starego przykładowego kodu, bez zakresu dat
const oldSelector = AdsApp.campaigns()
.withCondition('Clicks > 10')
.get();
// DOBRZE: pole GAQL. Przy warunkach na polach statystyk zakres dat jest obowiązkowy
const newSelector = AdsApp.campaigns()
.withCondition('metrics.clicks > 10')
.forDateRange('LAST_30_DAYS')
.get();
const rows = AdsApp.search(
'SELECT campaign.name, metrics.cost_micros FROM campaign ' +
'WHERE segments.date DURING LAST_7_DAYS');
for (const row of rows) {
// ŹLE: nazwa pola jak w zapytaniu, mikrojednostki odczytane jako euro
// if (row.metrics.cost_micros > 50) ...
// DOBRZE: lowerCamelCase i przeliczenie na walutę konta
const cost = Number(row.metrics.costMicros) / 1000000;
if (cost > 50) {
console.log(row.campaign.name + ': ' + cost.toFixed(2));
}
}
// ŹLE: toISOString() zwraca datę w UTC, a nie w czasie konta
const wrongDate = new Date().toISOString().slice(0, 10);
// DOBRZE: data w strefie czasowej konta
const rightDate = Utilities.formatDate(
new Date(), AdsApp.currentAccount().getTimeZone(), 'yyyy-MM-dd');
Na wymyślone metody pomaga tylko jedno: sprawdzanie każdej metody w dokumentacji. Jeśli jej tam nie ma, to nie istnieje, nawet jeśli nazwa brzmi bardzo wiarygodnie.
Bezpieczeństwo i ochrona danych
Żadnych danych klientów w czatach z AI. Do napisania kodu model potrzebuje struktury Twoich danych, a nie samych danych. Wyszukiwane hasła mogą zawierać nazwiska, adresy albo numery telefonów, które ludzie wpisali w Google. Listy klientów, eksporty z CRM i adresy e-mail tym bardziej nie mają czego szukać w czacie. Jeśli przy szukaniu błędu wklejasz wiersz z dziennika, najpierw zastąp wartości symbolami.
Sprawdź swój plan. To, czy dostawca wykorzystuje Twoje dane wejściowe, zależy od planu. Przy Gemini API Google pisze na przykład na swojej stronie z cennikiem, że treści z bezpłatnego poziomu są wykorzystywane do ulepszania produktów, a w płatnym planie nie. Ile kosztują modele przez API, zebrałem w porównaniu cen API AI.
Żadnych danych logowania w promptach. Haseł, kodów weryfikacyjnych, kluczy API ani tokenów programisty nigdy nie wklejasz do czatu. Skrypty Google Ads ich zresztą nie potrzebują: skrypt dostaje dostęp przez „Autoryzuj” z Twoim kontem Google. Jeśli skrypt wywołuje zewnętrzną usługę z kluczem, wpisujesz klucz sam w edytorze. Jest on wtedy widoczny dla każdego, kto może otworzyć skrypt. Jak chronić dostęp do samego konta, opisuję w artykule Bezpieczeństwo konta Google Ads.
Zmiany tylko po przeglądzie. Każdy skrypt, który coś zmienia na koncie, czyta druga osoba, zanim DRY_RUN przejdzie na false. Zapisuj, kto autoryzował który skrypt, bo działa on w imieniu tej osoby. I pamiętaj o przerwaniu po 30 minutach: co zostało do tego czasu zmienione, pozostaje zmienione.
Ograniczenia: kiedy lepiej sprawdzi się API, Edytor albo reguły
Google samo rozgranicza narzędzia w przeglądzie skryptów: Google Ads API służy do budowania własnego oprogramowania i infrastruktury, a do masowego zarządzania bez kodu Google wskazuje reguły automatyczne, przesyłanie zbiorcze i Edytor Google Ads.
| Zadanie | Lepiej pasuje |
|---|---|
| prosta, powtarzalna czynność bez własnej logiki, np. wstrzymywanie kampanii o stałych porach | reguły automatyczne |
| duże jednorazowe zmiany, przebudowa struktury konta | Edytor Google Ads albo przesyłanie zbiorcze |
| własny dashboard, baza danych, narzędzie dla wielu kont z własnym interfejsem | Google Ads API |
| kontrole, alerty, raporty w arkuszach, reguły z własną logiką | skrypty |
| zadania, które liczą się dłużej niż 30 minut | podział na kilka uruchomień albo API |
Skrypty, MCP i agenci AI
Skrypt to stały kod. Przy każdym uruchomieniu robi to samo i możesz z góry przeczytać, co zrobi. Agent AI podłączony do Google Ads API przez MCP (Model Context Protocol) decyduje natomiast dopiero w trakcie działania, jakie zapytania wysłać. To elastyczne przy pytaniach analitycznych, ale trudniejsze do kontrolowania. Do powtarzalnych kontroli wolę raz sprawdzony skrypt niż agenta, który za każdym razem decyduje od nowa. Jak agenci pracują z Google Ads i gdzie są ich granice, pokazuję w artykule Sterowanie Google Ads za pomocą agentów AI.
Podsumowanie: AI pisze, Ty odpowiadasz
Przy skryptach AI zdejmuje z Ciebie pisanie, ale nie odpowiedzialność. Daj modelowi dokładne zadanie i fragment dokumentacji, przeczytaj kod z checklistą, testuj w podglądzie i pamiętaj, że e-maile i arkusze działają tam mimo wszystko. Zmiany na koncie są ukryte za DRY_RUN i trafiają na produkcję dopiero po przeglądzie, krok po kroku.
Jeśli chcesz porządnie ułożyć automatyzację w swoim marketingu albo potrzebujesz drugiej pary oczu do kodu z AI, w ramach konsultingu AI zaczynam od audytu AI za 700 €. Jeśli powtarzalny proces w marketingu, na przykład raport albo powiadomienie, ma po prostu zostać zbudowany i działać, lepiej pasuje automatyzacja AI. Jeśli wolisz całkiem oddać prowadzenie konta, prowadzenie Twoich Google Ads jest dostępne od 1 000 € miesięcznie, z 3-miesięczną fazą startową, potem z miesięcznym wypowiedzeniem.
Źródła
- Google for Developers, skrypty Google Ads, przegląd: developers.google.com/google-ads/scripts/docs/start
- Google for Developers, skrypty Google Ads, pierwsze kroki (wersja polska): developers.google.com/google-ads/scripts/docs/getting-started
- Google for Developers, skrypty Google Ads, limity: developers.google.com/google-ads/scripts/docs/limits
- Google for Developers, skrypty Google Ads, tryb podglądu: developers.google.com/google-ads/scripts/docs/preview
- Google for Developers, skrypty Google Ads, autoryzacja: developers.google.com/google-ads/scripts/docs/authorization
- Google for Developers, skrypty Google Ads, dobre praktyki: developers.google.com/google-ads/scripts/docs/best-practices
- Google for Developers, skrypty Google Ads, raporty: developers.google.com/google-ads/scripts/docs/concepts/reports
- Google for Developers, dokumentacja AdsApp, Account, Ad, AdSelector, CampaignSelector, Stats, ExecutionInfo: developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp
- Google for Developers, rozwiązania Link Checker, Account Summary, Account Anomaly Detector: developers.google.com/google-ads/scripts/docs/solutions/link-checker
- Google for Developers, Google Ads API, zakresy dat w GAQL: developers.google.com/google-ads/api/docs/query/date-ranges
- Google for Developers, Google Ads API, zero metrics: developers.google.com/google-ads/api/docs/reporting/zero-metrics
- Google for Developers, Google Ads API v25, pola search_term_view: developers.google.com/google-ads/api/fields/v25/search_term_view
- Google for Developers, Google Ads API v25, pola ad_group_ad: developers.google.com/google-ads/api/fields/v25/ad_group_ad
- Google for Developers, Apps Script, limity: developers.google.com/apps-script/guides/services/quotas
- Google for Developers, Apps Script, UrlFetchApp: developers.google.com/apps-script/reference/url-fetch/url-fetch-app
- Google Ads Developer Blog, New Google Ads scripts experience (14.03.2022): ads-developers.googleblog.com
- Google Ads Developer Blog, Google Ads Scripts migration office hours (02.08.2022): ads-developers.googleblog.com
- Google AI for Developers, Gemini API, cennik: ai.google.dev/gemini-api/docs/pricing
Stan: 8.10.2026




