Opis usługi

Skrypty Google Ads to bezserwerowa platforma automatyzacji, która umożliwia programowe zarządzanie danymi reklam Google Ads i wysyłanie do nich zapytań za pomocą nowoczesnego JavaScriptu (ES6+) w środowisku IDE w przeglądarce. Dzięki skryptom Google Ads możesz automatyzować rutynowe procesy zarządzania kontem, generować raporty niestandardowe i integrować Google Ads z zewnętrznymi źródłami danych na jednym lub tysiącach kont bez konieczności udostępniania serwerów ani zarządzania danymi logowania dewelopera.

Większość funkcji Google Ads jest dostępna w skryptach Google Ads za pomocą mutate i search wywołań. Skrypty umożliwiają:

• zarządzanie 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;
• uruchamianie zapytań za pomocą języka Google Ads Query Language (GAQL) w celu generowania raportów niestandardowych i paneli;
• planowanie automatycznego uruchamiania co godzinę, codziennie, co tydzień, co miesiąc lub na żądanie;
• koordynowanie operacji na wielu kontach podrzędnych za pomocą skryptów menedżera;
• łączenie 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 jednostek i raporty.

Najważniejsze specyfikacje techniczne

Poniższe specyfikacje techniczne określają środowisko wykonawcze i granice operacyjne skryptów Google Ads:

Specyfikacja	Skrypt na jednym koncie	Skrypt na koncie menedżera
Limit czasu wykonania	Maksymalnie 30 minut	Do 60 minut w przypadku użycia funkcji executeInParallel i wywołania zwrotnego (standardowo 30 minut)
Silnik czasu działania	Środowisko wykonawcze JavaScript V8 (ECMAScript 6+)	Środowisko wykonawcze JavaScript V8 (ECMAScript 6+)
Limit iteratora jednostek	Domyślnie 50 000 jednostek na iterator (nie dotyczy raportów i wyszukiwanych haseł )	50 000 jednostek na konto podrzędne (nie dotyczy raportów i wyszukiwanych haseł) nie dotyczy)
Równoległe konta	Nie dotyczy (1 konto)	Równolegle do 50 kont
Limit przesyłania zbiorczego	Rozmiar pliku 50 MB, 1 000 000 wierszy	Rozmiar pliku 50 MB, 1 000 000 wierszy
Autoryzowane skrypty	Maksymalnie 250 autoryzowanych skryptów na użytkownika	Maksymalnie 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 są dla mnie odpowiednie?

Google udostępnia kilka usług, które pomagają w automatyzacji kont Google Ads. W tabeli poniżej znajdziesz typowe scenariusze i rekomendacje, które pomogą Ci wybrać odpowiednią usługę:

Scenariusz	Rekomendacja	Najważniejsze cechy
Jestem deweloperem, który chce stworzyć własne oprogramowanie lub zintegrować się 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 OAuth.
Jestem deweloperem, który potrafi pisać kod, ale nie chce zarządzać własną infrastrukturą oprogramowania.	Użyj skryptów Google Ads.	Bezserwerowe wykonywanie w Google Ads, automatyczne planowanie, środowisko IDE w przeglądarce.
Nie jestem deweloperem, ale chcę poświęcić trochę czasu na naukę programowania, aby zautomatyzować Google Ads.	Użyj skryptów Google Ads.	Prosta składnia JavaScript, gotowe szablony skryptów, autouzupełnianie i wyróżnianie składni w środowisku IDE.
Chcę programowo zarządzać kampaniami wideo.	Użyj skryptów Google Ads.	Bezpośrednie zarządzanie kampaniami wideo za pomocą AdsApp.videoCampaigns().
Chcę zaplanować uruchamianie zadań bez konieczności aktywnej sesji użytkownika.	Użyj skryptów Google Ads.	Autoryzacja w tle OAuth2 z automatycznym planowaniem co godzinę, codziennie, co tydzień, lub co miesiąc.
Chcę programowo uzyskiwać dostęp do zagnieżdżonych kont Google Ads.	Użyj skryptów menedżera aby uzyskać dostęp do kont podrzędnych z jednego skryptu.	Sekwencyjne iterowanie po kontach podrzędnych lub równoległe wykonywanie na maksymalnie 50 kontach podrzędnych za pomocą funkcji executeInParallel.
Chcę zintegrować interfejsy API Google lub innych firm z zarządzaniem Google Ads.	Użyj 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 do zewnętrznych interfejsów REST API.
Jestem analitykiem danych (lub mam podobne stanowisko) i chcę pobierać raporty Google Ads raporty do dalszej analizy.	Korzystaj z BigQuery Data Transfer Service w Google Ads.	Zaplanowany automatyczny potok danych reklam Google Ads do BigQuery bez użycia kodu.
Chcę zbiorczo zarządzać Google Ads i nie mam nic przeciwko pisaniu kodu.	Użyj przesyłania zbiorczego ze skryptami Google Ads.	Programowe przesyłanie plików CSV lub arkuszy kalkulacyjnych z maksymalnie 1 000 000 wierszy.
Chcę zbiorczo zarządzać Google Ads, ale nie chcę pisać kodu.	Użyj reguł automatycznych, przesyłania zbiorczego, lub Edytora Google Ads.	Narzędzia bez kodu na komputer lub w interfejsie do zbiorczych aktualizacji i zaplanowanych reguł.

Wymagania wstępne

Wystarczy podstawowa znajomość JavaScriptu – środowisko IDE pomaga w wyróżnianiu składni, autouzupełnianiu i wyświetlaniu podglądu. Aby zacząć pisać pierwszy skrypt, wystarczy konto Google Ads.

Najczęstsze pytania

Znajdź odpowiedzi na najczęstsze pytania dotyczące architektury skryptów Google Ads, limitów wykonania i integracji.

Czym są skrypty Google Ads?

Skrypty Google Ads zapewniają bezserwerowe środowisko automatyzacji w Google Ads. Umożliwiają reklamodawcom i deweloperom pisanie kodu JavaScript do wysyłania zapytań o dane o 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 ani płacenia za infrastrukturę.

Czym skrypty Google Ads różnią się od interfejsu Google Ads API?

Skrypty Google Ads działają bezpośrednio na Twoim koncie Google Ads za pomocą JavaScriptu, nie wymagają infrastruktury serwerowej i automatycznie obsługują autoryzację w przeglądarce. Interfejs Google Ads API to interfejs REST i gRPC API przeznaczony do aplikacji korporacyjnych na dużą skalę, narzędzi innych firm i potoków danych o dużej ilości danych które działają na Twoich serwerach i wymagają dedykowanych tokenów dewelopera i danych logowania OAuth.

Czy do uruchamiania skryptów Google Ads potrzebuję serwera?

Nie. Skrypty Google Ads działają w całości w infrastrukturze w chmurze Google bez dodatkowych kosztów. Możesz tworzyć skrypty, testować je w trybie podglądu i planować bezpośrednio w interfejsie internetowym Google Ads.

Jakie są limity wykonania skryptów Google Ads?

Standardowe skrypty na poszczególnych kontach mogą działać maksymalnie 30 minut na wykonanie. Skrypty na koncie menedżera, które używają funkcji executeInParallel, mogą działać maksymalnie 60 minut na maksymalnie 50 kontach podrzędnych (gdy określona jest funkcja wywołania zwrotnego). Jeśli skrypt przekroczy limit czasu, Google Ads nadal 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 zawierają wbudowane usługi, takie jak SpreadsheetApp do odczytywania i zapisywania Arkuszy Google, UrlFetchApp do wysyłania żądań HTTP do zewnętrznych interfejsów REST API oraz zaawansowane interfejsy API Google do integracji z usługami takimi jak BigQuery i YouTube. Więcej informacji znajdziesz w sekcji Interfejsy API innych firm i zaawansowane interfejsy API Google.

Prześlij opinię

Jeśli masz jakieś uwagi dotyczące 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.