Skrypty Google Ads udostępniają bezserwerową platformę automatyzacji, która umożliwia programowe zarządzanie danymi reklam Google Ads i ich odpytywanie za pomocą nowoczesnego kodu JavaScript (ES6+) w środowisku IDE opartym na przeglądarce. Dzięki skryptom Google Ads możesz automatyzować rutynowe przepływy pracy związane z zarządzaniem kontem, generować raporty niestandardowe i integrować Google Ads z zewnętrznymi źródłami danych na jednym koncie lub na tysiącach kont bez konieczności udostępniania serwerów czy zarządzania danymi logowania dewelopera.
Większość funkcji Google Ads jest dostępna w skryptach Google Ads za pomocą wywołań mutate i search. Skryptów możesz używać do:
- Zarządzaj kampaniami, grupami reklam, słowami kluczowymi i reklamami.
- Dostosowywanie stawek, budżetów i stanu na podstawie skuteczności w czasie rzeczywistym lub danych zewnętrznych.
- Uruchamiaj zapytania za pomocą języka Google Ads Query Language (GAQL), aby generować niestandardowe raporty i panele.
- Zaplanuj automatyczne wykonywanie co godzinę, codziennie, co tydzień, co miesiąc lub na żądanie.
- Koordynuj operacje na wielu kontach podrzędnych za pomocą skryptów menedżera.
- Łącz się z usługami Google Workspace (takimi jak Arkusze i Dysk), usługami Google Cloud (takimi jak BigQuery) i interfejsami API innych firm.
Skrypty zawierają też wbudowane selektory elementów i raporty.
Najważniejsze dane techniczne
Te specyfikacje techniczne określają środowisko wykonywania i granice działania skryptów Google Ads:
| Specyfikacja | Skrypt na jednym koncie | Skrypt na koncie menedżera |
|---|---|---|
| Czas oczekiwania na wykonanie | Maksymalnie 30 minut |
Do 60 minut w przypadku executeInParallel i oddzwonienia (standardowo 30 minut)
|
| Silnik środowiska wykonawczego | środowisko wykonawcze JavaScript V8 (ECMAScript 6+), | środowisko wykonawcze JavaScript V8 (ECMAScript 6+), |
| Limit iteratora encji | Domyślnie 50 000 elementów na iterator (nie dotyczy raportów i zapytań) | 50 tys. elementów na konto podrzędne (nie dotyczy raportów i wyszukiwanych haseł). |
| Konta równoległe | Nie dotyczy (1 konto) | Maksymalnie 50 kont jednocześnie |
| Limit przesyłania zbiorczego | rozmiar pliku 50 MB, 1 000 000 wierszy; | rozmiar pliku 50 MB, 1 000 000 wierszy; |
| Autoryzowane skrypty | Do 250 autoryzowanych skryptów na użytkownika | Do 250 autoryzowanych skryptów na użytkownika |
| Hosting i infrastruktura | W pełni zarządzane przez Google (bezserwerowe) | W pełni zarządzane przez Google (bezserwerowe) |
Więcej informacji znajdziesz w sekcji Limity.
Czy skrypty Google Ads to odpowiednia usługa dla mnie?
Google udostępnia wiele usług, które pomagają automatyzować konta Google Ads. W tabeli poniżej znajdziesz typowe scenariusze i zalecenia, które pomogą Ci wybrać odpowiednią usługę:
| Scenariusz | Rekomendacja | Najważniejsze cechy |
|---|---|---|
| Jestem programistą, który chce utworzyć własne oprogramowanie lub przeprowadzić integrację z interfejsem Google Ads API. Potrafię pisać kod i zarządzać infrastrukturą oprogramowania, w tym serwerami i bazami danych. | Użyj interfejsu Google Ads API. | Pełna kontrola nad interfejsem API, większa przepustowość, dedykowany hosting i zarządzanie protokołem OAuth. |
| Jestem deweloperem, który potrafi pisać kod, ale wolę nie zarządzać własną infrastrukturą oprogramowania. | Użyj skryptów Google Ads. | Bezserwerowe wykonywanie w Google Ads, automatyczne planowanie, środowisko IDE dostępne w przeglądarce. |
| Nie jestem programistą, ale chcę poświęcić trochę czasu na naukę programowania, aby zautomatyzować Google Ads. | Użyj skryptów Google Ads. | Prosta składnia JavaScriptu, gotowe szablony skryptów, autouzupełnianie w IDE i wyróżnianie składni. |
| Chcę zarządzać kampaniami wideo automatycznie. | Użyj skryptów Google Ads. |
Bezpośrednie zarządzanie kampaniami wideo za pomocą AdsApp.videoCampaigns().
|
| Chcę zaplanować zadania, które będą uruchamiane bez konieczności aktywnej sesji użytkownika. | Użyj skryptów Google Ads. | Autoryzacja OAuth2 w tle z automatycznym harmonogramem co godzinę, codziennie, co tydzień lub co miesiąc. |
| Chcę uzyskać dostęp do zagnieżdżonych kont Google Ads w sposób zautomatyzowany. | Używaj skryptów menedżera, aby uzyskiwać dostęp do wyświetlających reklamy kont podrzędnych za pomocą jednego skryptu. |
Iteracja sekwencyjna na kontach podrzędnych lub równoległe wykonywanie na maksymalnie 50 kontach podrzędnych za pomocą executeInParallel.
|
| Chcę zintegrować interfejsy API należące do Google lub innych firm z zarządzaniem Google Ads. | Używaj interfejsów API Google lub interfejsów API innych firm ze skryptami Google Ads. |
Wbudowane usługi Google Workspace (Arkusze, Dysk, poczta), zaawansowane interfejsy API Google (BigQuery, Analytics, YouTube) i UrlFetchApp dla zewnętrznych interfejsów API typu REST.
|
| Jestem analitykiem danych (lub mam podobną rolę) i chcę pobierać raporty Google Ads do dalszej analizy. | Korzystaj z BigQuery Data Transfer Service w Google Ads. | Zaplanowany automatyczny potok danych reklam Google Ads do BigQuery bez kodu. |
| Chcę zarządzać Google Ads zbiorczo i nie mam nic przeciwko pisaniu kodu. | Używaj przesyłania zbiorczego ze skryptami Google Ads. | Zautomatyzowane przesyłanie pliku CSV lub arkusza kalkulacyjnego zawierającego do 1 000 000 wierszy. |
| Chcę zarządzać Google Ads zbiorczo, ale nie chcę pisać kodu. | Użyj reguł automatycznych, przesyłania zbiorczego lub Edytora Google Ads. | Narzędzia komputerowe lub interfejsu niewymagające kodowania, które umożliwiają przesyłanie zbiorcze i stosowanie zaplanowanych reguł. |
Wymagania wstępne
Wystarczy podstawowa znajomość JavaScriptu – IDE pomaga w podświetlaniu składni, autouzupełnianiu i podglądzie. Aby zacząć pisać swój pierwszy skrypt, potrzebujesz tylko konta Google Ads.
Najczęstsze pytania
Znajdź odpowiedzi na najczęstsze pytania dotyczące architektury skryptów Google Ads, limitów wykonywania i integracji.
Czym są skrypty Google Ads?
Skrypty Google Ads zapewniają bezserwerowe środowisko automatyzacji w Google Ads. Umożliwiają reklamodawcom i programistom pisanie kodu JavaScript w celu wysyłania zapytań o wskaźniki skuteczności, tworzenia i modyfikowania kampanii, aktualizowania stawek i budżetów oraz łączenia się z zewnętrznymi interfejsami API bez konfigurowania serwerów, zarządzania tokenami OAuth czy płacenia za infrastrukturę.
Czym skrypty Google Ads różnią się od interfejsu Google Ads API?
Skrypty Google Ads działają bezpośrednio na koncie Google Ads, korzystając z języka JavaScript. Nie wymagają infrastruktury serwerowej i automatycznie obsługują autoryzację w przeglądarce. Interfejs Google Ads API to interfejs API typu REST i gRPC przeznaczony do obsługi aplikacji korporacyjnych na większą skalę, narzędzi innych firm i potoków danych o dużej objętości, które działają na Twoich serwerach i wymagają dedykowanych tokenów programisty oraz danych logowania OAuth.
Czy do uruchamiania skryptów Google Ads potrzebuję serwera?
Nie. Skrypty Google Ads działają całkowicie w infrastrukturze Google w chmurze bez dodatkowych kosztów. Możesz tworzyć skrypty, testować je w trybie podglądu i planować ich uruchamianie bezpośrednio w interfejsie internetowym Google Ads.
Jakie są limity wykonywania skryptów Google Ads?
Standardowe skrypty na poszczególnych kontach mogą działać przez maksymalnie 30 minut na wykonanie. Skrypty konta menedżera, które używają executeInParallel, mogą działać przez maksymalnie 60 minut na maksymalnie 50 kontach podrzędnych (jeśli określono funkcję wywołania zwrotnego). Jeśli skrypt przekroczy limit czasu, Google Ads i tak zastosuje wszystkie zmiany wprowadzone przed anulowaniem. Szczegółowe informacje o limitach czasu, limitach i limitach przesyłania zbiorczego znajdziesz w sekcji Limity.
Czy skrypty Google Ads mogą łączyć się z zewnętrznymi interfejsami API?
Tak. Skrypty Google Ads obejmują wbudowane usługi, takie jak SpreadsheetApp do odczytu i zapisu Arkuszy Google, UrlFetchApp do wysyłania żądań HTTP do zewnętrznych interfejsów API REST oraz zaawansowane interfejsy API Google do integracji z usługami takimi jak BigQuery i YouTube. Więcej informacji znajdziesz w artykułach o interfejsach API innych firm i zaawansowanych interfejsach API Google.
Prześlij opinię
Jeśli masz jakieś uwagi na temat skryptów Google Ads, chętnie je poznamy. Skontaktuj się z nami na Discordzie.
Jeśli potrzebujesz pomocy, skontaktuj się z zespołem pomocy technicznej ds. skryptów.