Bergabunglah bersama kami secara live di Discord di server Komunitas Periklanan dan Pengukuran Google dan di YouTube pada 15 Oktober pukul 21.00 WIB. Kami akan membahas fitur baru yang ditambahkan di Google Ads API v26.

Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Mengonversi kampanye Smart menjadi kampanye Performa Maksimal

Di v25 dan versi yang lebih baru, Anda dapat menggunakan metode SmartCampaignSettingService.GeneratePMaxDraftCampaign untuk mengonversi kampanye Pintar 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, anggaran, grup aset, dan aset, berdasarkan konfigurasi kampanye Pintar yang diberikan dalam permintaan. Setelah dibuat, Anda harus memeriksa, mengubah, dan meningkatkan kualitas aset baru sebelum mengaktifkan kampanye untuk menayangkan iklan.

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

status ditetapkan ke PAUSED.
Kelayakan penayangannya tercermin dalam primary_status.
contains_eu_political_advertising ditetapkan ke DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING secara default (jika belum ditentukan di kampanye Pintar). Verifikasi dan perbarui kolom ini jika kampanye Anda berisi iklan politik Uni Eropa.

Dengan demikian, Anda dapat memeriksa, mengubah, dan meningkatkan kualitas kampanye, anggaran, grup aset, dan aset Performa Maksimal yang dihasilkan sebelum mengaktifkan kampanye untuk menayangkan iklan.

Aset draf

Kampanye baru disertai dengan sekelompok gambar placeholder yang perlu diganti sebelum kampanye baru diaktifkan. Jika kolom image_enabled didukung dan ditetapkan ke true dalam permintaan, API akan otomatis membuat gambar, bukan menggunakan gambar placeholder. Anda dapat memeriksa aset baru di kolom assets respons, dan menggantinya dengan mengikuti langkah-langkah berikut:

Tinjau panduan persyaratan aset.
Upload gambar baru dengan mengikuti contoh upload aset gambar.
Tautkan aset baru ke grup aset kampanye draf, lalu hapus link AssetGroupAsset untuk gambar placeholder (baik dalam permintaan mutasi atomik yang sama atau setelah menautkan aset baru agar persyaratan aset minimum tetap terpenuhi) dengan mengikuti panduan menautkan grup aset ke aset.

Parameter permintaan

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 akan divalidasi, tetapi tidak dijalankan. 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 didukung dan akan 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 ditetapkan atau false; menetapkannya ke true tidak didukung dan menampilkan error SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

Detail respons

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

pmax_campaign: Nama resource Campaign dari draf kampanye Performa Maksimal yang dihasilkan.
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 dihasilkan.
assets: Daftar nama resource Asset yang ditautkan ke kampanye Performa Maksimal yang dihasilkan.
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:

Buat draf kampanye: 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.
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.
Aktifkan kampanye dan jeda kampanye asli: Saat Anda siap menayangkan iklan, perbarui status kampanye Performa Maksimal menjadi ENABLED, lalu perbarui status kampanye Pintar asli menjadi PAUSED untuk mencegah penayangan duplikat.