Pemilih

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 digabungkan secara bersamaan, 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 semua kondisi lainnya menggunakan operator AND.
forDateRange()
Diperlukan saat kondisi atau klausa pengurutan mereferensikan kolom Stats, seperti Ctr atau Tayangan. Jika Anda meminta semua kampanye dengan lebih dari 100 tayangan, skrip Google Ads harus mengetahui rentang tanggal yang akan diperiksa.
orderBy()
Menentukan urutan entity yang ditampilkan.
withLimit()
Membatasi jumlah entity yang ditampilkan ke nilai yang ditentukan. Peristiwa ini sangat berguna bersama dengan orderBy() untuk mengambil hal-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. Satu pengecualian adalah orderBy(), dengan urutan panggilan yang memang penting: beberapa panggilan ke metode ini akan menentukan beberapa klausa pengurutan, dan klausa tersebut akan diterapkan secara berurutan. Perhatikan 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 dapat 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, Anda dapat memperoleh Iterator darinya dengan memanggil selector.get().

Baca Praktik Terbaik untuk mendapatkan tips dan trik tentang penggunaan pemilih yang efisien.