Mengonversi kampanye pintar menjadi kampanye Performa Maksimal

Mulai rilis v25_2, Google Ads API memperkenalkan metode SmartCampaignSettingService.GeneratePMaxDraftCampaign untuk membantu Anda mengonversi kampanye Pintar menjadi kampanye Performa Maksimal.

Cara kerja konversi

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

Kampanye draf Performa Maksimal yang dibuat diinisialisasi dengan nilai status berikut:

• status disetel ke PAUSED.
• creation_status disetel ke INCOMPLETE.

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.

Parameter permintaan

Perhatian: Parameter gbp_enabled dan image_enabled saat ini belum diterapkan dan akan menyebabkan error jika ditetapkan ke true dalam permintaan. Kolom ini akan diaktifkan dalam rilis mendatang.

Pesan GeneratePMaxDraftCampaignRequest menerima kolom berikut:

• resource_name (Wajib): Nama resource SmartCampaignSetting yang terkait dengan kampanye Pintar yang ada yang ingin Anda konversi, dalam format berikut:

  customers/customer_id/smartCampaignSettings/campaign_id
  

• validate_only (Opsional): Jika true, permintaan divalidasi tetapi tidak dijalankan. Hanya error, peringatan, atau kemungkinan masalah konversi yang ditampilkan dalam kolom validated_info respons.

• gbp_enabled (Saat ini tidak didukung): Apakah akan mengonversi dan menautkan lokasi Google Profil Bisnis (GBP) yang terkait dengan kampanye Smart ke kampanye Performa Maksimal yang dibuat. Menetapkan kolom ini ke true saat ini belum diterapkan dan akan menampilkan error GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

• image_enabled (Saat ini tidak didukung): Apakah akan membuat gambar yang diperlukan secara otomatis untuk kampanye Performa Maksimal (seperti aset gambar horizontal, persegi, dan logo). Menetapkan kolom ini ke true saat ini tidak diterapkan dan akan menampilkan error IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

Detail respons

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

• pmax_campaign: Nama resource Campaign dari draf kampanye Performa Maksimal 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 tambahan atau kemungkinan masalah konversi yang ditampilkan saat validate_only disetel ke true.

Alur kerja yang direkomendasikan

Untuk mengonversi kampanye Pintar, gunakan alur kerja berikut:

1. Buat kampanye draf: Panggil SmartCampaignSettingService.GeneratePMaxDraftCampaign hanya dengan set resource_name yang diperlukan (biarkan gbp_enabled dan image_enabled tidak disetel atau disetel ke false). Simpan nama resource pmax_campaign, campaign_budget, asset_group, dan assets yang ditampilkan.
2. Tinjau dan sesuaikan kampanye: Karena draf kampanye Performa Maksimal dibuat dengan status = PAUSED dan creation_status = INCOMPLETE, periksa dan konfigurasi anggaran, grup aset, dan asetnya.
3. Aktifkan kampanye: Saat Anda siap menayangkan iklan, perbarui status kampanye menjadi ENABLED dan creation_status menjadi COMPLETE.

Catatan: Setelah gbp_enabled dan image_enabled diaktifkan dalam rilis mendatang, Anda juga dapat memigrasikan aset gambar dan lokasi GBP secara otomatis.