Mengonversi kampanye Smart menjadi kampanye Performa Maksimal

Pada v25 (mulai v25.2), Anda dapat menggunakan metode SmartCampaignSettingService.GeneratePMaxDraftCampaign untuk mengonversi kampanye Smart menjadi kampanye Performa Maksimal. Metode ini tidak tersedia di v24 dan yang lebih lama.

Cara kerja konversi

Saat Anda memanggil SmartCampaignSettingService.GeneratePMaxDraftCampaign, API akan membuat draf kampanye Performa Maksimal berdasarkan konfigurasi kampanye Pintar.

Kampanye draf Performa Maksimal yang dibuat diinisialisasi dengan status disetel ke PAUSED (dan kelayakan penayangannya tercermin dalam primary_status). Jika semua konverter fitur gagal divalidasi untuk kampanye Pintar, permintaan akan gagal dengan error SmartCampaignError.GENERATE_PMAX_CONVERTERS_FAIL.

Dengan begitu, Anda dapat memeriksa, mengubah, dan meningkatkan kualitas kampanye, anggaran, grup aset, dan aset Performa Maksimal yang dibuat sebelum mengaktifkan kampanye untuk menayangkan iklan. Membuat draf kampanye Performa Maksimal tidak mengubah atau menjeda kampanye Pintar asli, yang tetap aktif hingga Anda menjedanya secara manual.

Parameter permintaan

Perhatian: Parameter gbp_enabled dan image_enabled tidak diterapkan di v25 dan menyebabkan error jika ditetapkan ke true dalam permintaan. Biarkan kedua kolom tidak disetel atau disetel ke false.

Pesan GeneratePMaxDraftCampaignRequest menerima kolom berikut:

• resource_name (Wajib): Nama resource SmartCampaignSetting yang akan dibuat ulang untuk kampanye Pintar yang ingin Anda konversi, dalam format berikut:

  customers/customer_id/smartCampaignSettings/campaign_id
  

• validate_only (Opsional): Jika true, permintaan divalidasi tetapi tidak dieksekusi. Hanya error validasi, peringatan, atau kemungkinan masalah konversi yang ditampilkan di kolom validated_info respons tanpa membuat entitas draf.

• gbp_enabled (Tidak didukung): Opsional. Apakah akan mengonversi lokasi Google Profil Bisnis (GBP) yang ditautkan dengan kampanye Performa Maksimal. Biarkan kolom ini tidak disetel atau false; menyetelnya ke true tidak diterapkan di v25 dan menampilkan error SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

• image_enabled (Tidak didukung): Opsional. Apakah akan membuat gambar kampanye Performa Maksimal yang diperlukan (seperti jenis gambar horizontal, persegi, dan logo). Biarkan kolom ini tidak disetel atau false; menyetelnya ke true tidak diterapkan di v25 dan akan menampilkan error SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

Detail respons

Pesan GeneratePMaxDraftCampaignResponse menampilkan nama resource kampanye draf Performa Maksimal yang dibuat dan entitas terkaitnya:

• pmax_campaign: Nama resource Campaign kampanye Performa Maksimal draf yang dibuat.
• campaign_budget: Nama resource CampaignBudget yang ditautkan ke kampanye Performa Maksimal yang dibuat.
• asset_group: Nama resource AssetGroup yang ditautkan ke kampanye Performa Maksimal yang dibuat.
• assets: Daftar nama resource Asset yang ditautkan ke kampanye Performa Maksimal yang dibuat.
• validated_info: Informasi validasi atau kemungkinan masalah konversi yang ditampilkan oleh pemeriksaan konversi (diisi baik saat validate_only disetel ke true dan bersama nama resource entity yang dihasilkan saat validate_only adalah false).

Alur kerja yang direkomendasikan

Untuk mengonversi kampanye Pintar, gunakan alur kerja berikut:

1. Buat kampanye draf: Panggil SmartCampaignSettingService.GeneratePMaxDraftCampaign dengan hanya menetapkan resource_name yang diperlukan (biarkan gbp_enabled dan image_enabled tidak ditetapkan atau ditetapkan ke false). Simpan nama resource pmax_campaign, campaign_budget, asset_group, dan assets yang ditampilkan.
2. Tinjau dan sesuaikan kampanye: Karena kampanye Performa Maksimal draf dibuat dengan status = PAUSED, periksa dan konfigurasi anggaran, grup aset, dan asetnya.
3. Aktifkan kampanye dan jeda kampanye asli: Saat Anda siap menayangkan iklan, perbarui status kampanye Performa Maksimal menjadi ENABLED, lalu perbarui status kampanye Smart Shopping asli menjadi PAUSED untuk mencegah penayangan duplikat.