Penargetan Kampanye

Skrip Google Ads memungkinkan Anda menggunakan setelan penargetan tingkat kampanye di akun Anda. Dukungan tersedia untuk jadwal iklan, lokasi yang ditargetkan dan dikecualikan, kedekatan yang ditargetkan, dan platform. Panduan ini menunjukkan cara menggunakan target kampanye.

Jadwal iklan

Jadwal iklan memungkinkan Anda mengontrol kapan iklan harus berjalan.

Mengambil

Anda dapat mengambil jadwal iklan kampanye menggunakan metode adSchedules dari target kampanye. Cuplikan kode berikut menunjukkan cara mengambil daftar semua kriteria AdSchedule untuk kampanye:

const campaign = AdsApp.campaigns()
    .withCondition("campaign.name = 'My campaign'")
    .get()
    .next();

const adSchedules = campaign.targeting().adSchedules().get();
for (const adSchedule of adSchedules) {
  // Process your ad schedule.
  ...
}

Secara default, kampanye ditayangkan setiap saat, sehingga Anda tidak akan mendapatkan jadwal iklan kembali jika belum menetapkan jadwal iklan kustom untuk kampanye.

Perbarui

Setelah mengambil jadwal iklan, Anda dapat mengubah propertinya secara langsung; misalnya, Anda dapat memperbarui pengubah bid jadwal iklan sebagai berikut:

adSchedule.setBidModifier(1.1);

Buat

Untuk membuat jadwal iklan baru, Anda dapat menggunakan metode addAdSchedule dari Campaign. Cuplikan kode berikut membuat jadwal iklan khusus untuk kampanye dari 07.00 hingga 11.00 dalam zona waktu akun, setiap hari Sabtu, dengan pengubah bid 1.1.

campaign.addAdSchedule({
   dayOfWeek: "SATURDAY",
   startHour: 7,
   startMinute: 0,
   endHour: 11,
   endMinute: 0,
   bidModifier: 1.1
});

Catatan: Ada batas enam jadwal iklan untuk setiap hari dalam seminggu, misalnya, membagi setiap hari menjadi enam periode 4 jam didukung, tetapi membagi setiap hari menjadi 24 periode 1 jam tidak didukung.

Anda dapat membaca dokumentasi kami untuk mengetahui detail selengkapnya tentang nilai yang diizinkan untuk setiap parameter, serta batasan tambahan yang perlu diingat saat membuat jadwal iklan.

Hapus

Anda dapat menghapus jadwal iklan menggunakan metode remove. Untuk mereset penjadwalan iklan kustom kampanye, Anda dapat menghapus semua penjadwalan iklan kustomnya sebagai berikut:

const adSchedules = campaign.adSchedules().get();
for (const adSchedule of adSchedules) {
  adSchedule.remove();
}

Lokasi

Anda juga dapat menargetkan atau mengecualikan lokasi untuk kampanye menggunakan skrip Google Ads.

Ambil

Anda dapat mengambil daftar lokasi yang ditargetkan menggunakan metode targetedLocations dari target kampanye. Lokasi yang dikecualikan dapat diambil menggunakan metode excludedLocations. Cuplikan kode berikut memilih semua lokasi yang ditargetkan yang menerima lebih dari 100 tayangan bulan lalu.

const locations = AdsApp.targeting()
  .targetedLocations()
  .withCondition("metrics.impressions > 100")
  .forDateRange("LAST_MONTH")
  .orderBy("metrics.clicks DESC")
  .get();

for (const location of locations) {
 // Process the campaign target here.
 ...
}

Jika telah menetapkan kampanye untuk ditayangkan di semua negara dan wilayah, Anda akan mendapatkan daftar lokasi kosong.

Perbarui

Setelah mengambil lokasi, Anda dapat mengubah propertinya secara langsung. Misalnya, Anda dapat memperbarui pengubah bid lokasi sebagai berikut:

location.setBidModifier(1.1);

Buat

Anda dapat membuat target lokasi di kampanye menggunakan metode addLocation. Demikian pula, Anda dapat mengecualikan lokasi menggunakan metode excludeLocation. Cuplikan kode berikut menargetkan kampanye untuk Amerika Serikat dengan pengubah bid 1,15, sekaligus mengecualikan New York City.

campaign.addLocation(2840, 1.15);     // United States
campaign.excludeLocation(1023191);    // New York city

Anda dapat melihat dokumentasi Penargetan Geografis Google Ads API untuk mengetahui daftar ID yang akan digunakan saat menambahkan penargetan lokasi. Untuk melacak performa target lokasi, Anda dapat menelusuri referensi location_view Laporan.

Hapus

Anda dapat menghapus target lokasi menggunakan metode remove.

Kedekatan

Anda dapat menargetkan kampanye ke radius (kedekatan) di sekitar lokasi menggunakan skrip Google Ads.

Mengambil

Anda dapat mengambil daftar kedekatan yang ditargetkan menggunakan metode targetedProximities di target kampanye. Cuplikan kode berikut memilih semua kedekatan yang ditargetkan yang menerima lebih dari 100 tayangan bulan lalu.

const proximities = AdsApp.targeting()
    .targetedProximities()
    .withCondition("metrics.impressions > 100")
    .forDateRange("LAST_MONTH")
    .orderBy("metrics.clicks DESC")
    .get();

for (const proximity of proximities) {
  ...
}

Buat

Anda dapat membuat target kedekatan untuk kampanye menggunakan metode addProximity -nya. Cuplikan kode berikut menargetkan kampanye ke 20 kilometer di sekitar koordinat (37.423021, -122.083739).

campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS");

Anda juga dapat menggunakan metode ini untuk membuat target kedekatan yang sama dengan alamat dan pengubah bid:

campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS", {
  bidModifier: 1.15,
  address: {
    streetAddress: "1600 Amphitheatre Parkway",
    cityName: "Mountain View",
    provinceName: "California",
    provinceCode: "CA",
    postalCode: "94043",
    countryCode: "US"
  }
});

Perlu diingat bahwa tidak ada validasi untuk memeriksa apakah alamat tersebut benar-benar milik garis lintang dan bujur yang diberikan. Alamat tidak memiliki tujuan selain mengubah apa yang muncul di antarmuka Pengelolaan Kampanye.

Hapus

Anda dapat menghapus target kedekatan menggunakan metode remove.

Platform

Anda dapat mengambil daftar platform yang ditargetkan kampanye menggunakan metode platforms dari target kampanye. Karena kampanye Google Ads menargetkan semua platform (desktop, seluler, dan tablet), Anda tidak dapat menambahkan atau menghapus kriteria Platform. Penggunaan paling umum untuk kriteria penargetan ini adalah untuk menetapkan penyesuaian bid perangkat kampanye Anda:

campaign.targeting()
    .platforms()
    .mobile()
    .get()
    .next().
    setBidModifier(1.2);

ID platform dibagikan di seluruh kampanye dan memiliki nilai standar seperti yang ditentukan dalam lampiran platform Google Ads API. ID ini dapat berguna saat mengurai laporan. Saat memilih kriteria secara langsung, Anda dapat menggunakan metode bantuan yang disediakan oleh PlatformSelector.