Migrasi

Infrastruktur skrip Google Ads baru didasarkan pada Google Ads API. Karena arsitektur API tersebut berbeda, Anda mungkin perlu mengupdate dan skrip yang sudah ada. Kami telah berupaya sebaik mungkin untuk memastikan kompatibilitasnya sebaik mungkin, jadi perubahan ini harus kecil.

Laporan

Banyak laporan AWQL akan terus berfungsi. Di balik layar, saat menggunakan infrastruktur baru, skrip akan mengonversi kueri AWQL Anda menjadi GAQL (bahasa kueri baru untuk Google Ads API), jalankan terhadap backend baru, lalu mengonversi hasilnya kembali ke format yang awalnya digunakan oleh laporan AWQL. Kueri dengan GAQL akan diteruskan sebagaimana adanya.

Karena {i>overhead<i} ini, kami sarankan agar Anda memeriksa skrip Anda dan perbarui kueri AWQL ke GAQL jika memungkinkan. Anda dapat menggunakan migrasi kueri alat yang menggunakan logika yang sama sebagai skrip untuk menentukan kueri GAQL untuk kueri AWQL tertentu, atau Anda dapat menggunakan tindakan pembuat kueri interaktif untuk membantu membangun kueri.

Berikut ini beberapa batasan pada terjemahan AWQL ke GAQL otomatis:

  • Tidak semua kueri AWQL diterjemahkan dengan rapi ke kueri GAQL. Dalam kasus ini, pesan {i>error<i} yang berisi detail tentang apa yang salah akan dicatat, ke akan membantu Anda memperbaikinya secara manual.
  • Tidak semua jenis laporan dari AWQL didukung di GAQL.
  • GAQL tidak memiliki dukungan untuk "baris nol tayangan iklan". Menentukan bahwa laporan seharusnya menyertakan nol tayangan iklan akan mengakibatkan error.
  • Beberapa kolom yang ambigu tidak dapat digunakan dalam filter. Misalnya, "Judul" dapat merujuk ke sejumlah kolom iklan yang berbeda.
  • Beberapa kolom dapat menampilkan hasil dalam format yang berbeda, misalnya, memecah satu hasil menjadi banyak kolom.

Mengatur pemilih

Saat mengambil sumber daya dengan skrip, adalah hal yang cukup umum Panggilan withCondition dan orderBy untuk membatasi atau mengurutkan hasil dalam iterator. Kolom dalam panggilan ini sekarang menggunakan nama Google Ads API baru. Sebagai misalnya, untuk memfilter menurut nama kampanye, sebelumnya Anda harus menggunakan:

.withCondition('CampaignName = "SOME_CAMPAIGN_NAME"')

Sekarang, Anda harus menggunakan nama kolom baru untuk kondisi ini jika memungkinkan:

.withCondition('campaign.name = "SOME_CAMPAIGN_NAME"')

Meskipun demikian, kami telah berupaya menyertakan pemetaan nama lama ke Jadi, jika skrip Anda masih menggunakan CampaignName, skrip akan diganti dengan campaign.name saat runtime untuk memastikan skrip masih berfungsi. Jika Anda mengalami masalah dengan nama gaya lama, perbarui skrip Anda untuk gunakan nama gaya baru sebagai langkah pemecahan masalah pertama.

Batas

Banyak batasan yang sama seperti pada infrastruktur lama, dan perubahan yang dibuat di sini umumnya akan membantu meningkatkan performa.

  • Batas waktunya sama. Skrip dapat dieksekusi selama 30 menit.
  • Satu iterator menampilkan 50.000 entity secara default, tetapi ini dapat berupa diganti. Sebelumnya, batas 50.000 ini tidak dapat disesuaikan.
  • Satu pemilih dapat menangani maksimal 10.000 ID (tidak berubah).
  • Infrastruktur baru tidak memiliki batasan untuk jumlah entitas yang dapat diproses dalam satu skrip. Sebelumnya,batasnya adalah 250.000.
  • Infrastruktur baru tidak memiliki batasan jumlah kata kunci atau iklan yang dapat dibuat per eksekusi. Sebelumnya,batasnya adalah 250.000.
  • Output logging terpotong pada 100 kb (tidak berubah).
  • Kuota untuk layanan Apps Script (SpreadsheetApp, MailApp, dll.) adalah tidak berubah.
  • Kuota untuk Google Ads akan diterapkan seolah-olah Anda menggunakan API. Bahwa skrip Anda akan tunduk pada batas kapasitas API, tetapi ini memungkinkan lebih fleksibel untuk mengakses lebih banyak laporan atau membuat lebih banyak perubahan per eksekusi.

Perubahan lainnya

Tujuan ExecutionInfo tidak lagi mengekspos getRemainingCreateQuota() atau getRemainingGetQuota(), karena kuota tersebut tidak lagi berlaku di versi baru.