Kampanye Pintar

Perhatian: Mulai 23 September 2026, pembuatan kampanye Pintar tidak digunakan lagi dan tidak lagi didukung. Upaya untuk membuat kampanye Pintar akan menampilkan SmartCampaignError.CREATION_FAILED di v24 dan yang lebih baru, atau AuthorizationError.ACTION_NOT_PERMITTED di v23. Kampanye Pintar di akun Anda akan terus menayangkan iklan dan masih dapat diperbarui atau dikueri dalam laporan.

Catatan: Di v25 dan yang lebih baru, Anda dapat menggunakan SmartCampaignSettingService.GeneratePMaxDraftCampaign untuk mengonversi kampanye Pintar menjadi kampanye Performa Maksimal (tidak tersedia di v24 dan yang lebih lama). Untuk mengetahui detailnya, lihat panduan Mengonversi kampanye Pintar menjadi kampanye Performa Maksimal.

Kampanye Pintar dirancang untuk membantu bisnis kecil menjangkau lebih banyak pelanggan secara online. Model ini memerlukan penyiapan dan pemeliharaan minimal. Kampanye Pintar mengandalkan teknologi iklan Google untuk otomatis mengoptimalkan kampanye berdasarkan detail bisnis dan sasaran Anda, baik itu panggilan telepon dari pelanggan, kunjungan ke lokasi Anda, atau tindakan di situs Anda.

Pembuatan kampanye

Alur kerja pembuatan kampanye Pintar memerlukan beberapa langkah yang berbeda dari jenis kampanye lainnya. Sebagai praktik terbaik, tambahkan entity dalam satu permintaan GoogleAdsService.Mutate.

Berikut adalah langkah-langkah dalam alur kerja pembuatan kampanye Pintar (hubungan dan setelan entitas yang dijelaskan dalam langkah-langkah ini juga berlaku saat memeriksa atau memperbarui kampanye Pintar di akun Anda). Lihat contoh kode lengkap untuk mengetahui detail selengkapnya.

1. Buat daftar tema kata kunci dengan saran dari SmartCampaignSuggestService, KeywordThemeConstantService, atau dengan tema kata kunci bentuk bebas. Tema kata kunci ini digunakan untuk mengambil berbagai tingkat saran anggaran, membuat kriteria kampanye tema kata kunci, dan membuat saran untuk materi iklan teks.
2. Ambil saran untuk jumlah anggaran, judul iklan, dan deskripsi dari SmartCampaignSuggestService. Layanan ini menggunakan informasi tentang bisnis Anda, target lokasi geografis, bahasa target, dan tema kata kunci untuk menyarankan jumlah anggaran harian high, low, atau recommended, serta hingga tiga judul dan dua teks deskripsi untuk iklan itu sendiri.
3. Buat CampaignBudget menggunakan jumlah anggaran yang disarankan. Menggunakan jumlah anggaran yang disarankan akan membantu memaksimalkan performa kampanye Anda. Anggaran kampanye Pintar tidak dapat digunakan bersama dengan kampanye lain.
4. Buat Campaign dan SmartCampaignSetting. SmartCampaignSetting tidak dapat ada secara terpisah dari Campaign yang terkait dengannya, jadi buat kedua entitas bersama-sama dalam permintaan Mutate yang sama menggunakan nama resource sementara negatif (seperti customers/{customer_id}/campaigns/-1) untuk menautkan resource dependen.
5. Buat daftar objek CampaignCriterion. Panduan ini menggunakan tema kata kunci yang dikompilasi di langkah 1 untuk membuat kriteria kampanye tema kata kunci, dan juga menjelaskan jenis kriteria kampanye lain yang didukung.
6. Buat AdGroup. Kampanye Pintar hanya dapat memiliki satu AdGroup yang terkait dengannya.
7. Buat AdGroupAd menggunakan SmartCampaignAdInfo yang berisi 3 hingga 15 judul dan 2 hingga 4 deskripsi.

Lokasi Profil Bisnis

Saat membuat saran atau mengonfigurasi kampanye, berikan ID lokasi Profil Bisnis Anda untuk memaksimalkan performa kampanye Pintar.

ID lokasi Profil Bisnis Anda dapat diperoleh dari kolom name Business Profile API atau UI Profil Bisnis.

Jika ditetapkan pada objek SmartCampaignSuggestionInfo atau SmartCampaignSetting, ID harus berupa string dalam format ini:

locations/locationId

Jika diambil dari API Profil Bisnis, ID sudah dalam format yang benar. Namun, jika diambil dari UI, ID harus ditambahkan ke locations/.

Campaign status

Untuk mengambil status kampanye Pintar, panggil SmartCampaignSettingService.GetSmartCampaignStatus dengan resource_name dari SmartCampaignSetting kampanye (customers/{customer_id}/smartCampaignSettings/{campaign_id}). Metode ini memberikan tampilan status kampanye Pintar yang lebih gabungan daripada campaign.primary_status atau campaign.primary_status_reasons.

GetSmartCampaignStatusResponse mencakup SmartCampaignStatus (ELIGIBLE, NOT_ELIGIBLE, PENDING, PAUSED, REMOVED, atau ENDED) beserta detail khusus status:

• not_eligible_details: Mencakup SmartCampaignNotEligibleReason (ACCOUNT_ISSUE, BILLING_ISSUE, BUSINESS_PROFILE_LOCATION_REMOVED, atau ALL_ADS_DISAPPROVED).
• eligible_details: Mencakup last_impression_date_time (stempel waktu tayangan terakhir yang diamati dalam 48 jam sebelumnya) dan end_date_time (jika ada).
• paused_details, removed_details, dan ended_details: Sertakan stempel waktu paused_date_time, removed_date_time, atau end_date_time masing-masing dalam zona waktu pelanggan (yyyy-MM-dd HH:mm:ss).

Pertimbangan untuk pelaporan

Kampanye Pintar dirancang dengan struktur yang disederhanakan, yang membatasi setiap kampanye hanya memiliki satu grup iklan. Struktur ini memiliki implikasi khusus untuk pelaporan:

• Metrik tingkat grup iklan: Karena hanya ada satu grup iklan per kampanye Pintar, metrik performa apa pun (seperti klik, tayangan iklan, dan konversi) di tingkat grup iklan sama dengan metrik untuk seluruh kampanye.
• Pengambilan metrik: Saat membuat kueri untuk data performa, Anda dapat mengambil metrik di tingkat kampanye. Meskipun Anda dapat mengambil metrik di tingkat grup iklan, metrik tersebut tidak memberikan detail tambahan selain yang tersedia di tingkat kampanye.

Untuk sebagian besar kebutuhan pelaporan terkait kampanye Pintar, membuat kueri campaign dan metrik terkaitnya akan memberikan gambaran performa yang lengkap.