Pemilih

Pemilih membantu programmer membuat kueri yang mengambil entity Google Ads yang diinginkan. Dengan pemilih, seseorang dapat mempersempit daftar yang telah diambil lalu mengurutkannya. Sebagian besar pemilih memiliki metode berikut:

withCondition()
Menambahkan kondisi ke pemilih. Jika beberapa kondisi digunakan, kondisi tersebut akan digabungkan dengan logika DAN. 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 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 perlu diperiksa.
orderBy()
Menentukan pengurutan entity yang ditampilkan.
withLimit()
Membatasi jumlah entity yang ditampilkan pada nilai yang ditentukan. Penting sangat berguna jika digunakan bersama orderBy() untuk mengambil seperti "10 kata kunci dengan tayangan iklan terbanyak kemarin". Secara default, semua pemilih akan menetapkan batas menjadi 50.000. Anda dapat meningkatkan batas dengan menentukan batas waktu.

Metode ini dapat dipanggil dalam urutan apa pun. Satu pengecualian adalah orderBy(), dengan urutan panggilan memang penting: beberapa panggilan ke metode ini akan menentukan beberapa klausa pengurutan, dan mereka akan diterapkan secara berurutan. Pertimbangkan cuplikan berikut:

selector = selector.forDateRange("LAST_14_DAYS")
    .orderBy("metrics.clicks DESC")
    .orderBy("metrics.ctr ASC");

Hasil akan diurutkan berdasarkan Klik dalam urutan menurun. Hasil dengan tanda sama dengan Nilai klik akan diurutkan berdasarkan 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, seseorang dapat memperoleh Iterator darinya dengan memanggil selector.get().

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