Pemilih membantu programmer membuat kueri yang mengambil entity Google Ads yang diinginkan. Dengan pemilih, Anda 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 disatukan dan digabungkan, 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 dengan kondisi berbasis ID.
forDateRange()- Diperlukan saat klausa pengurutan atau kondisi mereferensikan kolom Stats, seperti Ctr atau Tayangan. Jika Anda meminta semua kampanye dengan lebih dari 100 tayangan, skrip Google Ads perlu mengetahui rentang tanggal untuk melakukan peninjauan.
orderBy()- Menentukan urutan entity yang ditampilkan.
withLimit()- Membatasi jumlah entitas yang ditampilkan ke nilai yang ditentukan. Hal ini
sangat berguna bersama dengan
orderBy()untuk mengambil hal seperti "10 kata kunci dengan tayangan terbanyak kemarin". Secara default, semua pemilih akan menetapkan batas ke 50.000. Anda dapat meningkatkan batas dengan menentukan batas secara manual.
Metode ini dapat dipanggil dalam urutan apa pun. Salah satu pengecualiannya adalah orderBy(), yang menganggap urutan panggilan sangat penting: beberapa panggilan ke metode ini akan menentukan beberapa klausa pengurutan, dan keduanya akan diterapkan secara berurutan. Pertimbangkan
cuplikan berikut:
selector = selector.forDateRange("LAST_14_DAYS")
.orderBy("metrics.clicks DESC")
.orderBy("metrics.ctr ASC");
Hasil akan diurutkan menurut Klik dalam urutan menurun. Hasil dengan nilai Klik yang sama akan diurutkan menurut Ctr dalam urutan menaik.
Panggilan ke metode pemilih bisa dirantai 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, orang dapat memperoleh Iterator darinya dengan memanggil selector.get().
Baca Praktik Terbaik untuk mengetahui tips dan trik penggunaan pemilih yang efisien.