Skrip Google Ads menyediakan platform otomatisasi serverless yang memungkinkan Anda mengelola dan membuat kueri 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 mutasi dan penelusuran panggilan. Anda dapat menggunakan skrip untuk:
- Mengelola kampanye, grup iklan, kata kunci, dan iklan.
- Menyesuaikan bid, anggaran, dan status berdasarkan performa real-time atau data eksternal.
- Menjalankan kueri menggunakan Google Ads Query Language (GAQL) untuk membuat laporan kustom dan dasbor.
- Menjadwalkan eksekusi otomatis untuk dijalankan per jam, harian, mingguan, bulanan, atau sesuai permintaan.
- Mengoordinasikan operasi multi-akun di seluruh akun turunan menggunakan skrip pengelola.
- Menghubungkan 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 batas operasional skrip Google Ads:
| Spesifikasi | Skrip akun tunggal | Skrip akun pengelola |
|---|---|---|
| Batas waktu 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 entitas | 50.000 entitas default per iterator (laporan dan kueri penelusuran dikecualikan ) | 50.000 entitas per akun turunan (laporan dan kueri penelusuran dikecualikan) |
| Akun paralel | Tidak berlaku (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 diotorisasi | Hingga 250 skrip yang diotorisasi per pengguna | Hingga 250 skrip yang diotorisasi per pengguna |
| Hosting dan infrastruktur | Dikelola sepenuhnya oleh Google (serverless) | Dikelola 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 Anda:
| Skenario | Rekomendasi | Karakteristik utama |
|---|---|---|
| Saya adalah developer yang ingin membuat produk software saya sendiri, atau berintegrasi dengan Google Ads API. Saya terbiasa menulis kode, mengelola infrastruktur software termasuk server dan database. | Gunakan Google Ads API. | Kontrol API penuh, throughput lebih tinggi, hosting khusus, dan pengelolaan OAuth. |
| Saya adalah developer yang terbiasa menulis kode, tetapi lebih suka tidak mengelola infrastruktur software saya sendiri. | Gunakan skrip Google Ads. | Eksekusi serverless di dalam Google Ads, penjadwalan otomatis, browser-based IDE. |
| Saya bukan developer, tetapi bersedia meluangkan waktu untuk mempelajari pemrograman guna mengotomatiskan Google Ads. | Gunakan skrip Google Ads. | Sintaksis JavaScript sederhana, template skrip bawaan, pelengkapan otomatis IDE dan penyorotan sintaksis. |
| 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 saya secara terprogram. | Gunakan skrip pengelola untuk mengakses akun turunan yang menayangkan iklan dari satu skrip. |
Iterasi berurutan di seluruh akun turunan, atau eksekusi paralel di seluruh akun turunan hingga 50 akun menggunakan executeInParallel.
|
| Saya ingin mengintegrasikan API milik Google atau pihak ketiga ke dalam pengelolaan Google Ads manajemen saya. | Gunakan Google API atau API pihak ketiga dengan skrip Google Ads. |
Layanan Google Workspace bawaan (Spreadsheet, Drive, Mail), Google API Lanjutan (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 CSV atau spreadsheet 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 kode untuk update massal dan aturan terjadwal. |
Prasyarat
Anda hanya perlu memahami JavaScript tingkat dasar—IDE akan membantu penyorotan sintaksis, pelengkapan otomatis, dan pratinjau. Yang Anda perlukan hanyalah akun Google Ads untuk mulai menulis skrip pertama Anda.
Pertanyaan umum (FAQ)
Temukan jawaban atas pertanyaan umum tentang arsitektur skrip Google Ads, batas eksekusi, dan integrasi.
Apa yang dimaksud dengan skrip Google Ads?
Skrip Google Ads menyediakan lingkungan otomatisasi serverless di dalam Google Ads. Skrip ini 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 skrip Google Ads dengan 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 skala besar, alat pihak ketiga, dan pipeline data bervolume tinggi yang berjalan di server Anda sendiri dan memerlukan token developer khusus serta kredensial OAuth.
Apakah saya memerlukan server untuk menjalankan skrip Google Ads?
Tidak. Skrip Google Ads berjalan sepenuhnya di infrastruktur cloud Google tanpa biaya tambahan. Anda dapat membuat skrip, mengujinya dengan mode pratinjau, dan menjadwalkannya langsung di antarmuka web Google Ads.
Berapa batas eksekusi untuk skrip Google Ads?
Skrip standar di akun perorangan dapat berjalan hingga 30 menit per eksekusi. Skrip akun pengelola yang menggunakan executeInParallel dapat dieksekusi hingga 60 menit di seluruh akun turunan hingga 50 akun (jika fungsi callback ditentukan). Jika waktu tunggu skrip habis, Google Ads tetap akan menerapkan perubahan yang dilakukan sebelum pembatalan. Lihat Batas
untuk mengetahui detail lengkap tentang batas waktu, 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 Anda memiliki masukan tentang skrip Google Ads, beri tahu kami. Hubungi kami di Discord.
Jika Anda memerlukan dukungan, hubungi dukungan teknis skrip.