Skrip Google Ads menyediakan platform otomatisasi serverless yang memungkinkan Anda mengelola dan mengkueri data Google Ads secara terprogram menggunakan JavaScript modern (ES6+) di IDE berbasis browser. Dengan skrip Google Ads, Anda dapat mengotomatiskan alur kerja pengelolaan akun rutin, membuat laporan kustom, dan mengintegrasikan Google Ads dengan sumber data eksternal—di satu akun atau ribuan akun—tanpa menyediakan server atau mengelola kredensial developer.
Sebagian besar fitur Google Ads tersedia di skrip Google Ads melalui panggilan mutate dan search. Anda dapat menggunakan skrip untuk:
- Mengelola kampanye, grup iklan, kata kunci, dan iklan.
- Sesuaikan bid, anggaran, dan status berdasarkan performa real-time atau data eksternal.
- Jalankan kueri menggunakan Google Ads Query Language (GAQL) untuk membuat laporan kustom dan dasbor.
- Jadwalkan eksekusi otomatis untuk dijalankan per jam, harian, mingguan, bulanan, atau sesuai permintaan.
- Koordinasikan operasi multi-akun di seluruh akun turunan menggunakan skrip pengelola.
- Terhubung ke layanan Google Workspace (seperti Spreadsheet dan Drive), layanan Google Cloud (seperti BigQuery), dan API pihak ketiga.
Skrip juga menyertakan pemilih entitas dan laporan bawaan.
Spesifikasi teknis utama
Spesifikasi teknis berikut menentukan lingkungan eksekusi dan batasan operasional skrip Google Ads:
| Spesifikasi | Skrip akun tunggal | Skrip akun pengelola |
|---|---|---|
| Waktu tunggu eksekusi | Maksimum 30 menit |
Hingga 60 menit dengan executeInParallel dan callback
(standar 30 menit)
|
| Mesin runtime | Runtime JavaScript V8 (ECMAScript 6+) | Runtime JavaScript V8 (ECMAScript 6+) |
| Batas iterator entity | Default 50.000 entity per iterator (laporan dan kueri penelusuran dikecualikan) | 50.000 entitas per akun turunan (laporan dan kueri penelusuran dikecualikan) |
| Akun paralel | T/A (1 akun) | Hingga 50 akun secara paralel |
| Batas upload massal | Ukuran file 50 MB, 1.000.000 baris | Ukuran file 50 MB, 1.000.000 baris |
| Skrip yang diizinkan | Hingga 250 skrip yang diizinkan per pengguna | Hingga 250 skrip resmi per pengguna |
| Hosting dan infrastruktur | Terkelola sepenuhnya oleh Google (serverless) | Terkelola sepenuhnya oleh Google (serverless) |
Untuk informasi selengkapnya, lihat Batas.
Apakah skrip Google Ads adalah produk yang tepat untuk saya?
Google menyediakan beberapa produk untuk membantu mengotomatiskan akun Google Ads. Tabel berikut menguraikan skenario dan rekomendasi umum untuk membantu Anda memilih produk yang tepat sesuai kebutuhan:
| Skenario | Rekomendasi | Karakteristik utama |
|---|---|---|
| Saya adalah developer yang ingin membuat produk software sendiri, atau berintegrasi dengan Google Ads API. Saya mahir menulis kode, mengelola infrastruktur software termasuk server dan database. | Gunakan Google Ads API. | Kontrol API penuh, throughput yang lebih tinggi, hosting khusus, dan pengelolaan OAuth. |
| Saya adalah developer yang terbiasa menulis kode, tetapi tidak ingin mengelola infrastruktur software saya sendiri. | Gunakan skrip Google Ads. | Eksekusi serverless di dalam Google Ads, penjadwalan otomatis, IDE berbasis browser. |
| Saya bukan developer, tetapi bersedia meluangkan waktu untuk mempelajari pemrograman guna mengotomatiskan Google Ads. | Menggunakan skrip Google Ads. | Sintaksis JavaScript sederhana, template skrip bawaan, pelengkapan otomatis dan penyorotan sintaksis IDE. |
| Saya ingin mengelola kampanye video secara terprogram. | Gunakan skrip Google Ads. |
Pengelolaan kampanye video langsung menggunakan
AdsApp.videoCampaigns().
|
| Saya ingin menjadwalkan tugas untuk dijalankan tanpa memerlukan sesi pengguna aktif. | Gunakan skrip Google Ads. | Otorisasi latar belakang OAuth2 dengan penjadwalan otomatis per jam, harian, mingguan, atau bulanan. |
| Saya ingin mengakses akun Google Ads bertingkat secara terprogram. | Gunakan skrip pengelola untuk mengakses akun turunan penayangan dari satu skrip. |
Iterasi berurutan di seluruh akun turunan, atau eksekusi paralel di
hingga 50 akun turunan menggunakan executeInParallel.
|
| Saya ingin mengintegrasikan API milik Google atau pihak ketiga ke pengelolaan Google Ads saya. | Gunakan Google API atau API pihak ketiga dengan skrip Google Ads. |
Layanan Google Workspace bawaan (Spreadsheet, Drive, Gmail), Advanced Google
API (BigQuery, Analytics, YouTube), dan UrlFetchApp untuk
REST API eksternal.
|
| Saya adalah analis data (atau peran serupa) yang ingin mendownload laporan Google Ads untuk analisis lebih lanjut. | Gunakan BigQuery Data Transfer Service untuk Google Ads. | Pipeline otomatis terjadwal untuk data iklan Google Ads ke BigQuery tanpa kode. |
| Saya ingin mengelola Google Ads secara massal, dan tidak keberatan menulis kode. | Gunakan upload massal dengan skrip Google Ads. | Upload spreadsheet atau CSV terprogram yang mendukung hingga 1.000.000 baris. |
| Saya ingin mengelola Google Ads secara massal, tetapi tidak ingin menulis kode apa pun. | Gunakan aturan otomatis, upload massal, atau Google Ads Editor. | Alat desktop atau UI tanpa coding untuk update massal dan aturan terjadwal. |
Prasyarat
Anda hanya perlu memahami JavaScript tingkat dasar—IDE membantu dengan penyorotan sintaksis, pelengkapan otomatis, dan pratinjau. Anda hanya memerlukan akun Google Ads untuk mulai menulis skrip pertama Anda.
Pertanyaan umum (FAQ)
Temukan jawaban atas pertanyaan umum tentang arsitektur, batas eksekusi, dan integrasi skrip Google Ads.
Apa yang dimaksud dengan skrip Google Ads?
Skrip Google Ads menyediakan lingkungan otomatisasi serverless dalam Google Ads. Skrip Google Ads memungkinkan pengiklan dan developer menulis kode JavaScript untuk membuat kueri metrik performa, membuat dan mengubah kampanye, memperbarui bid dan anggaran, serta terhubung dengan API eksternal tanpa mengonfigurasi server, mengelola token OAuth, atau membayar infrastruktur.
Apa perbedaan antara skrip Google Ads dan Google Ads API?
Skrip Google Ads berjalan langsung di akun Google Ads Anda menggunakan JavaScript, tidak memerlukan infrastruktur server, dan menangani otorisasi secara otomatis di browser. Google Ads API adalah REST dan gRPC API yang dirancang untuk aplikasi perusahaan berskala lebih besar, alat pihak ketiga, dan pipeline data bervolume tinggi yang berjalan di server Anda sendiri serta memerlukan token developer dan kredensial OAuth khusus.
Apakah saya memerlukan server untuk menjalankan skrip Google Ads?
Tidak. Skrip Google Ads berjalan sepenuhnya di infrastruktur cloud Google tanpa biaya tambahan. Anda dapat menulis skrip, mengujinya dengan mode pratinjau, dan menjadwalkannya langsung di antarmuka web Google Ads.
Apa saja batas eksekusi untuk skrip Google Ads?
Skrip standar di setiap akun dapat berjalan hingga 30 menit per eksekusi. Skrip akun pengelola yang menggunakan executeInParallel dapat dieksekusi
hingga 60 menit di maksimal 50 akun turunan (jika fungsi callback
ditentukan). Jika waktu tunggu skrip habis, Google Ads tetap menerapkan perubahan yang dilakukan sebelum pembatalan. Lihat Batas
untuk mengetahui detail lengkap tentang waktu tunggu, kuota, dan batas upload massal.
Dapatkah skrip Google Ads terhubung ke API eksternal?
Ya. Skrip Google Ads menyertakan layanan bawaan seperti SpreadsheetApp untuk membaca dan menulis Google Spreadsheet, UrlFetchApp untuk mengirim permintaan HTTP ke REST API eksternal, dan Google API Lanjutan untuk berintegrasi dengan layanan seperti BigQuery dan YouTube. Untuk mengetahui detail selengkapnya, lihat
API pihak ketiga
dan Google API lanjutan.
Masukan
Jika ada masukan tentang skrip Google Ads, sampaikan kepada kami. Hubungi kami di Discord.
Jika Anda memerlukan dukungan, hubungi dukungan teknis skrip.