Selektor membantu programmer membuat kueri yang mengambil entitas Google Ads yang diminta. Dengan pemilih, seseorang dapat mempersempit daftar entity yang diambil dan mengurutkannya. Sebagian besar pemilih memiliki metode berikut:
withCondition()- Menambahkan kondisi ke pemilih. Jika beberapa kondisi digunakan, kondisi tersebut akan digabungkan dengan operator AND. Dengan kata lain, pemilih hanya akan menampilkan entity yang memenuhi semua kondisi yang ditentukan.
withIds()- Menambahkan kumpulan ID sebagai kondisi. Kondisi berbasis ID akan digabungkan menggunakan fungsi AND dengan semua kondisi lainnya.
forDateRange()- Diperlukan saat klausa kondisi atau pengurutan mereferensikan kolom Stats, seperti Ctr atau Impressions. Jika Anda meminta semua kampanye dengan lebih dari 100 tayangan, skrip Google Ads perlu mengetahui rentang tanggal yang akan diperiksa.
orderBy()- Menentukan pengurutan entity yang ditampilkan.
withLimit()- Membatasi jumlah entity yang ditampilkan ke nilai yang ditentukan. Fungsi ini sangat berguna bersama dengan
orderBy()untuk mengambil hal-hal seperti "10 kata kunci dengan tayangan iklan terbanyak kemarin". Secara default, semua pemilih akan menetapkan batas hingga 50.000. Anda dapat meningkatkan batas dengan menentukan batas secara manual.
Metode ini dapat dipanggil dalam urutan apa pun. Satu pengecualian adalah orderBy(), yang urutan panggilannya memang penting: beberapa panggilan ke metode ini akan menentukan beberapa klausa pengurutan, dan akan diterapkan secara berurutan. Perhatikan cuplikan berikut:
selector = selector.forDateRange("LAST_14_DAYS")
.orderBy("metrics.clicks DESC")
.orderBy("metrics.ctr ASC");
Hasilnya akan diurutkan berdasarkan Klik dalam urutan menurun. Hasil dengan nilai Klik yang sama akan diurutkan berdasarkan Ctr dalam urutan menaik.
Panggilan ke metode pemilih dapat dirangkai bersama. Kode berikut
var campaignSelector = AdsApp.campaigns();
campaignSelector.withCondition("metrics.clicks > 10");
campaignSelector.withCondition("metrics.impressions > 1000");
campaignSelector.orderBy("metrics.impressions DESC");
campaignSelector.forDateRange("YESTERDAY");
dapat ditulis ulang dengan cara yang lebih ringkas:
var campaignSelector = AdsApp.campaigns()
.withCondition("metrics.clicks > 10")
.withCondition("metrics.impressions > 1000")
.orderBy("metrics.impressions DESC")
.forDateRange("YESTERDAY");
Setelah pemilih dibuat, Anda dapat memperoleh
Iterator darinya dengan memanggil
selector.get().
Baca Praktik Terbaik untuk mendapatkan tips dan trik tentang penggunaan pemilih yang efisien.