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.
Ambil
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 apa pun jika Anda 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 kustom untuk kampanye dari
pukul 07.00 hingga 11.00 di zona waktu akun, setiap hari Sabtu, dengan pengubah bid
sebesar 1,1.
campaign.addAdSchedule({
dayOfWeek: "SATURDAY",
startHour: 7,
startMinute: 0,
endHour: 11,
endMinute: 0,
bidModifier: 1.1
});
Anda dapat melihat 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
target lokasi
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 iklan 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 menyetel kampanye untuk ditayangkan di semua negara dan wilayah, Anda akan mendapatkan daftar lokasi yang 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 melakukan penelusuran di resource
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.
Ambil
Anda dapat mengambil daftar kedekatan yang ditargetkan menggunakan metode
targetedProximities
pada
target kampanye.
Cuplikan kode berikut memilih semua kedekatan yang ditargetkan yang menerima lebih dari 100 tayangan iklan 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. 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 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 milik lintang dan bujur yang diberikan. Alamat tidak memiliki tujuan lain 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
targets 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 yang telah ditentukan sebelumnya 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 helper yang disediakan oleh
PlatformSelector.