Penargetan Kampanye

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

Jadwal iklan

Jadwal iklan memungkinkan Anda mengontrol kapan iklan harus berjalan.

Ambil

Anda dapat mengambil jadwal iklan kampanye menggunakan metode adSchedules di 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 kembali jadwal iklan jika belum menetapkan jadwal iklan khusus untuk kampanye.

Update

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 kustom untuk kampanye dari 07.00 hingga 11.00 dalam zona waktu akun, pada 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 menyetel ulang penjadwalan iklan khusus kampanye, Anda dapat menghapus semua jadwal iklan khususnya 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 target lokasi menggunakan metode targetedLocations dari target kampanye. Lokasi yang dikecualikan dapat diambil menggunakan metode excludedLocations. Cuplikan kode berikut memilih semua target lokasi 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.

Update

Setelah mengambil lokasi, Anda bisa 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 AS dengan pengubah bid 1,15, sementara mengecualikan New York City.

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

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

Hapus

Anda dapat menghapus target lokasi menggunakan metode remove.

Kedekatan

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

Ambil

Anda dapat mengambil daftar kedekatan yang ditargetkan menggunakan metode targetedProximities pada target kampanye. Cuplikan kode berikut memilih semua target kedekatan 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 jarak untuk kampanye menggunakan metode addProximity. Cuplikan kode berikut menargetkan kampanye hingga 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 pengubah bid dan alamat:

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 berada di lintang dan bujur yang diberikan. Alamat ini tidak memiliki tujuan selain untuk mengubah hal-hal 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 yang 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 digunakan bersama di seluruh kampanye dan memiliki nilai yang telah ditentukan 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.