Skrypty Google Ads - jak automatyzować zarządzanie kampaniami

To pierwsza decyzja, którą podejmujesz przed jakąkolwiek automatyzacją konta. Reguły zautomatyzowane (Automated Rules) to konfigurator klik-klik wbudowany w panel: wybierasz warunek (np. CPA powyżej 80 zł) i akcję (pauza słowa kluczowego), bez linijki kodu. Skrypty to kod JavaScript z dostępem do Google Ads API, który robi to, czego reguły nie potrafią.

Granica jest prosta. Jeśli logika mieści się w jednym warunku i jednej akcji na jednym typie obiektu, użyj reguły. Jeśli potrzebujesz pętli, integracji z arkuszem, danych zewnętrznych albo działania na wielu kontach naraz, sięgasz po skrypt.

W praktyce nie wybierasz jednego narzędzia kosztem drugiego. Reguły obsługują proste pauzy i powiadomienia, a skrypty przejmują zadania, których panel nigdy nie ogarnie.

Skrypt to funkcja main(), która wykonuje się na serwerach Google z dostępem do obiektów Twojego konta: kampanii, grup reklam, słów kluczowych, reklam i statystyk. Czytasz dane przez selektory (AdsApp.campaigns()), filtrujesz warunkami i wykonujesz operacje – pauzę, zmianę stawki, zapis do arkusza.

Dodajesz skrypt w sekcji Narzędzia i ustawienia > Działania zbiorcze > Skrypty. Po wklejeniu kodu autoryzujesz dostęp do konta i uruchamiasz raz w trybie podglądu (Preview) – ten tryb pokazuje, co skrypt zrobi, bez wprowadzania zmian. To Twoja siatka bezpieczeństwa.

Harmonogram ustawiasz osobno dla każdego skryptu. Dostępne interwały to: jednorazowo, co godzinę, codziennie, co tydzień i co miesiąc. Alert budżetowy ustaw na co godzinę, raport tygodniowy na poniedziałek rano, a porządkowanie słów kluczowych raz na dobę w nocy.

Dwa limity, o których trzeba pamiętać: pojedyncze wykonanie skryptu nie może trwać dłużej niż 30 minut, a liczba operacji podlega limitom API. Na dużych kontach dziel logikę na mniejsze skrypty albo przetwarzaj dane wsadowo, żeby nie przekroczyć tych progów.

Warto rozróżnić skrypty na poziomie pojedynczego konta od tych na poziomie MCK. Te pierwsze widzą tylko jedno konto, te drugie iterują po wszystkich kontach pod menedżerem. Jeśli prowadzisz jedną firmę, zostań przy poziomie konta; cross-account ma sens dopiero przy obsłudze wielu klientów.

Skrypty zarabiają na siebie tam, gdzie zadanie jest powtarzalne, nudne i podatne na ludzki błąd. Trzy obszary dają największy zwrot z czasu wdrożenia: alerty, automatyczne porządki i raportowanie.

Alerty są najważniejsze, bo chronią budżet. Link Checker łapie sytuację, w której płacisz za kliknięcia prowadzące na stronę 404 – częsty efekt zmian na stronie, o których nikt nie powiadomił działu reklamy. Auto-wykluczenia i pauzy odchudzają konto z balastu, który po cichu zjada budżet bez konwersji.

Raportowanie to osobna liga. Zamiast ręcznie zrzucać dane co tydzień, skrypt zapisuje je do Google Sheets, a na tym arkuszu budujesz dashboard, który aktualizuje się sam. Dla agencji obsługujących wiele kont to różnica między godziną pracy a zerem.

Jest też mniej oczywista grupa zastosowań: integracje z danymi zewnętrznymi. Skrypt potrafi pobrać dane z arkusza lub zewnętrznego API i na ich podstawie podejmować decyzje – wstrzymać reklamy produktu, którego zabrakło w magazynie, albo podbić aktywność, gdy prognoza pogody sprzyja sprzedaży. To obszar, w którym skrypty robią rzeczy, jakich panel Google Ads nie zaoferuje w żadnym ustawieniu.

Kolejny praktyczny trik: skrypty obsługują wszystkie klasyczne typy kampanii – Search, Display, Wideo i Shopping – ale nie obsługują kampanii inteligentnych opartych w pełni na automatyce Google. Zanim zaplanujesz automatyzację, sprawdź, czy Twój typ kampanii w ogóle jest dostępny dla selektorów skryptu.

Najprostszy skrypt, który warto wdrożyć pierwszego dnia, pilnuje wydatków i wysyła e-mail, gdy kampania przekracza założony próg. Logika jest czytelna nawet bez znajomości programowania: pobierz aktywne kampanie, sprawdź dzisiejszy koszt względem budżetu, wyślij powiadomienie przy przekroczeniu.

function main() {
  var EMAIL = 'twoj@email.com';
  var THRESHOLD = 1.5; // 150% budzetu dziennego

  var campaigns = AdsApp.campaigns()
    .withCondition('Status = ENABLED')
    .get();

  var alerts = [];

  while (campaigns.hasNext()) {
    var campaign = campaigns.next();
    var stats = campaign.getStatsFor('TODAY');
    var budget = campaign.getBudget().getAmount();
    var cost = stats.getCost();

    if (cost > budget * THRESHOLD) {
      alerts.push(campaign.getName() + ': ' + cost + ' zl');
    }
  }

  if (alerts.length > 0) {
    MailApp.sendEmail(EMAIL, 'Alert budzetowy Google Ads',
      'Kampanie z wysokimi wydatkami:\n' + alerts.join('\n'));
  }
}

Konstrukcja powtarza się w większości skryptów: selektor pobiera obiekty, while iteruje po wynikach, warunek decyduje o akcji. Gdy zrozumiesz ten wzorzec, czytanie gotowych skryptów z bibliotek przestaje być zagadką. Zmienne na górze (EMAIL, THRESHOLD) to jedyne, co zwykle podmieniasz pod swoje konto.

Ustaw ten skrypt na harmonogram co godzinę w godzinach pracy. Dzięki temu o przepalonym budżecie dowiesz się w ciągu 60 minut, a nie następnego dnia, gdy dzienna pula jest już wydana.

Nie musisz pisać od zera. Google udostępnia w panelu gotowe szablony, które uruchomisz w kilka kliknięć – m.in. wykrywacz anomalii konta i kontroler linków. To dobry punkt startu, zanim sięgniesz po bardziej rozbudowane rozwiązania.

Poza panelem działa kilka sprawdzonych źródeł. Oficjalna dokumentacja Google Ads Scripts (developers.google.com/google-ads/scripts) zawiera bibliotekę z przykładami pod konkretne cele. Brainlabs i Optmyzr publikują skrypty agencyjne, często bardziej zaawansowane niż wbudowane szablony. Warto też wiedzieć, że skrypty wspierają już ES6 – zmienne let i const, funkcje strzałkowe oraz template stringi – więc nowoczesny kod z internetu zadziała bez przeróbek.

Zasada przy każdym kopiowanym skrypcie jest jedna: przeczytaj kod, zanim go uruchomisz. Sprawdź, jakie obiekty modyfikuje i czy nie zawiera zaszytych adresów e-mail albo identyfikatorów cudzego konta. Skrypt z nieznanego źródła ma pełny dostęp do Twoich kampanii – traktuj go jak instalację oprogramowania, nie jak wklejenie tekstu.

Dla agencji osobną wartością są skrypty na poziomie MCK (Menedżer kont, dawniej My Client Center). Jeden skrypt może działać na dziesiątkach kont klientów naraz – ten sam alert budżetowy, ta sama kontrola linków, jedno miejsce zarządzania. To realna oszczędność, której regułami zautomatyzowanymi nie osiągniesz.

Przy ocenie gotowego szablonu zwróć uwagę na trzy rzeczy: jakie obiekty modyfikuje (tylko czyta czy też zmienia stawki/statusy), jaki zakres dat analizuje i czy nie wysyła danych na zewnątrz. Skrypt raportowy, który tylko czyta i zapisuje do Twojego arkusza, jest praktycznie bezpieczny. Skrypt, który masowo pauzuje słowa kluczowe na podstawie progu, wymaga dokładnego przejrzenia warunku, zanim go puścisz na żywo.

Błędny skrypt nie zgłasza błędu – po prostu robi coś nie tak na Twoich pieniądzach. Dlatego automatyzację wdraża się stopniowo, a nie hurtem na całym koncie produkcyjnym.

Zawsze zaczynaj od trybu Preview. Pokazuje on dokładnie, jakie zmiany skrypt by wprowadził, bez ich faktycznego zastosowania. Dopiero gdy lista zmian wygląda sensownie, przełączasz na uruchomienie na żywo. Pierwszy bieg ogranicz do jednej kampanii lub krótkiego okresu, żeby zweryfikować efekt na małej próbce.

Monitoruj historię uruchomień. Panel skryptów ma rejestr aktywności – po każdym wykonaniu sprawdzisz, czy skrypt zadziałał i co zmienił. Jeśli Google uzna sposób użycia za nieprawidłowy, wyśle ostrzeżenie na e-mail przypisany do konta; reakcja jest wtedy potrzebna szybko, więc nie ignoruj tych powiadomień.

Dokumentuj, co robi każdy skrypt. Na koncie z kilkunastoma automatyzacjami po pół roku nikt nie pamięta, dlaczego stawki spadają w środy. Krótki komentarz na górze kodu i nazwa opisowa zamiast Skrypt 1 oszczędzają sporo nerwów przy przekazaniu konta lub audycie.

Większość problemów ze skryptami nie wynika z trudnego kodu, tylko z pominięcia testów i kontroli. Oto pułapki, które widać najczęściej.

1. Uruchomienie skryptu od razu na żywo, z pominięciem trybu Preview – zmiany dotykają całego konta, zanim ktokolwiek je sprawdzi.
2. Zbyt agresywne progi w warunkach – pauza słów kluczowych po jednym dniu bez konwersji wycina ruch, który dopiero się rozkręca.
3. Brak monitoringu historii uruchomień – skrypt cicho przestaje działać po zmianie struktury konta, a nikt tego nie zauważa.
4. Kopiowanie kodu bez czytania – zaszyty cudzy e-mail albo zakres dat liczony od złej daty potrafią zafałszować cały raport.
5. Brak nazw i komentarzy – po kilku miesiącach nikt nie wie, który skrypt za co odpowiada.

Prosta zasada chroni przed większością z nich: każdy nowy skrypt przechodzi przez Preview, startuje na wąskim zakresie i dostaje opisową nazwę. Te trzy nawyki kosztują kilka minut, a oszczędzają budżet, który łatwo przepalić jedną źle ustawioną automatyzacją.

Nie – i to dobra wiadomość, bo te narzędzia grają w różnych rolach. Smart Bidding korzysta z sygnałów aukcyjnych, których API nie udostępnia: historii użytkownika, kontekstu zapytania, danych w czasie rzeczywistym przy każdej pojedynczej aukcji. Skrypt nie ma do nich dostępu, więc nie wygra licytacji o ustalanie stawek z algorytmem Google.

Skrypty błyszczą w warstwie operacyjnej: alerty, porządki, raporty, kontrola jakości konta, integracja z danymi spoza Google Ads (stany magazynowe, pogoda, dane z CRM). To zadania, których Smart Bidding nie dotyka, bo nie jest od tego.

Najzdrowszy układ to podział pracy: Smart Bidding optymalizuje stawki, reguły obsługują proste pauzy, a skrypty zajmują się monitoringiem, raportowaniem i wszystkim, co wymaga logiki lub danych zewnętrznych. Jeśli wolisz oddać konfigurację i utrzymanie tej automatyki specjalistom, sprawdź naszą ofertę Google Ads – ustawimy alerty, raporty i kontrolę jakości tak, by pracowały po cichu w tle.