Kampanye Pintar

Perhatian: Mulai 23 September 2026, pembuatan kampanye Pintar akan dihentikan dan tidak lagi didukung. Mencoba membuat kampanye Pintar akan menampilkan SmartCampaignError.CREATION_FAILED di v24 (mulai v24.2) dan v25, atau AuthorizationError.ACTION_NOT_PERMITTED di v23 (dan v24 sebelum v24.2). Kampanye Pintar di akun Anda akan terus menayangkan iklan dan masih dapat diperbarui atau dikueri dalam laporan.

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

Kampanye Pintar dirancang untuk membantu bisnis kecil menjangkau lebih banyak pelanggan secara online. Aplikasi ini memerlukan penyiapan dan pemeliharaan minimal. Kampanye Pintar mengandalkan teknologi iklan Google untuk mengoptimalkan kampanye secara otomatis 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 dengan jenis kampanye lainnya. Sebagai praktik terbaik, tambahkan entitas dalam satu permintaan GoogleAdsService.Mutate.

Berikut 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 saran anggaran dari berbagai tingkat, 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, lokasi geografis target, 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 dibagikan 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 Anda.

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 SmartCampaignSetting kampanye (customers/{customer_id}/smartCampaignSettings/{campaign_id}). Metode ini memberikan tampilan status kampanye Pintar yang lebih diagregasi 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 menjadi satu grup iklan. Struktur ini memiliki implikasi khusus untuk pelaporan:

• Metrik tingkat grup iklan: Karena hanya ada satu grup iklan per kampanye Smart, semua metrik performa (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 di luar yang tersedia di tingkat kampanye.

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