Panduan ini menjelaskan berbagai seluk-beluk penataan permintaan yang membuat dan memperbarui kampanye Performa Maksimal. Ini dapat menjadi referensi yang berguna saat merancang integrasi. Panduan ini menjelaskan cara pemrosesan permintaan yang mengubah kampanye Performa Maksimal dan dapat menjadi referensi pendamping untuk panduan pemecahan masalah Performa Maksimal dan panduan batch processing Performa Maksimal.
Buat kampanye Performa Maksimal
Di Google Ads API, entitas kampanye Performa Maksimal direpresentasikan sebagai kombinasi dari beberapa resource unik.
Kampanye Performa Maksimal Standar
Kampanye Performa Maksimal Standar memerlukan kumpulan resource minimum agar dapat ditayangkan.
Penting untuk diperhatikan bahwa operasi untuk membuat entity AssetGroup
dan
AssetGroupAsset
harus disertakan bersama dalam satu permintaan, dan
resource AssetGroupAsset
harus digabungkan untuk memenuhi semua persyaratan
aset minimum dan spesifikasi;
lihat perbedaannya untuk
Kampanye retail. Permintaan untuk membuat
AssetGroup
tanpa semua entitas AssetGroupAsset
yang diperlukan akan menghasilkan
error; lihat
Status tidak valid versus permintaan tidak valid
untuk konteks selengkapnya.
Ada berbagai opsi dalam hal menyusun permintaan yang membuat kampanye Performa Maksimal. Keputusan tentang cara mengelompokkan operasi dan permintaan struktur sangat bergantung pada tujuan dan infrastruktur Anda.
- Buat resource
CampaignBudget
,Campaign
, danAsset
dalam permintaan terpisah sebelum membuat resourceAssetGroup
danAssetGroupAsset
. - Sertakan semua resource ini dalam satu permintaan mutasi.
Meskipun Anda berhasil membuat resource CampaignBudget
, Campaign
, dan Asset
dalam permintaan sebelumnya yang terpisah, kampanye Performa Maksimal tidak akan
memenuhi syarat untuk ditayangkan hingga resource AssetGroup
dan AssetGroupAsset
juga dibuat.
Persyaratan minimum agar kampanye Performa Maksimal ditayangkan secara valid
Anda dapat menyesuaikan lebih lanjut kampanye Performa Maksimal dengan membuat resource tambahan seperti yang ditunjukkan dalam diagram.
Anda dapat menyertakan operasi untuk membuat resource AssetGroupSignal
dalam permintaan
yang sama yang membuat resource AssetGroup
dan AssetGroupAsset
.
Atau, Anda dapat membuat entity AssetGroupSignal
dalam permintaan terpisah
setelah pembuatan AssetGroup
.
Kampanye Performa Maksimal dengan opsi tambahan
Kampanye Performa Maksimal untuk retail
Kampanye retail bersifat unik karena ada dua cara berbeda untuk membuat grup aset yang menghasilkan kampanye penayangan yang valid:
- Grup aset tanpa aset
- Grup aset yang berisi SEMUA aset yang diperlukan (lebih disarankan)
Jika Anda memilih untuk mengecualikan aset dari grup aset, Google akan otomatis menggunakan aset yang disediakan di akun Merchant Center tertaut untuk membuat iklan. Namun, sebaiknya sediakan aset untuk dijangkau di semua inventaris. Kampanye Performa Maksimal untuk retail memerlukan kumpulan resource minimum berikut agar dapat ditayangkan.
CampaignBudget
Campaign
(denganShoppingSettings
terisi)AssetGroup
AssetGroupListingGroupFilter
Penting untuk diperhatikan bahwa kolom Campaign.shopping_settings
harus diisi di kampanye retail. Selain itu, final_urls
yang tercantum di setiap AssetGroup
harus cocok dengan URL yang terkait dengan ID akun Merchant Center yang ditentukan dalam Campaign.shopping_settings
. Terakhir, setiap AssetGroup
harus
memiliki hierarki grup listingan produk terkait yang valid dan terdiri dari satu atau beberapa
resource AssetGroupListingGroupFilter
. Anda harus membuat minimal satu hierarki node untuk memperhitungkan semua produk di feed Merchant Center yang ditentukan.
Setiap resource ini dapat dibuat secara terpisah atau dalam satu permintaan. Namun, kampanye tidak akan valid untuk ditayangkan sampai semua resource ini dibuat dengan benar.
Persyaratan minimum untuk kampanye Performa Maksimal Retail yang valid dan menayangkan iklan
Kampanye Retail dapat memanfaatkan semua opsi yang tersedia untuk kampanye Performa Maksimal standar, termasuk membuat sinyal grup aset, sasaran konversi kampanye, dan kriteria kampanye. Jika Anda memilih untuk menambahkan aset ke
AssetGroup
saat membuat resource AssetGroup
, AssetGroup
Anda
tunduk pada persyaratan aset minimum. Dengan kata lain, Anda dapat menyertakan
tidak ada aset atau semua aset yang diperlukan.
Kampanye Performa Maksimal Retail dengan opsi tambahan
Status tidak valid versus permintaan tidak valid
Saat menggunakan kampanye Performa Maksimal di Google Ads API, ada perbedaan penting antara status yang tidak valid dan permintaan yang tidak valid.
- Status tidak valid
- Kampanye tidak memenuhi syarat untuk ditayangkan karena konfigurasinya. Misalnya, Anda dapat membuat resource
Campaign
mandiri denganadvertising_channel_type
dariPERFORMANCE_MAX
. Meskipun permintaan untuk membuat kampanye berhasil, permintaan tersebut tidak memenuhi syarat untuk ditayangkan sampai Anda menambahkan setidaknya satuAssetGroup
ke kampanye. Jika permintaan berhasil, tetapi kampanye atau grup aset tidak ditayangkan, Anda dapat menggunakanCampaignPrimaryStatus
,CampaignPrimaryStatusReason
,AssetGroupPrimaryStatus
, danAssetGroupPrimaryStatusReason
untuk menentukan alasannya, seperti yang dijelaskan dalam panduan pemecahan masalah. - Permintaan tidak valid
- Permintaan yang tidak akan berhasil karena akan membuat kampanye atau
resource menjadi tidak valid. Misalnya, Google Ads API akan menampilkan error jika Anda mencoba membuat
AssetGroup
untuk kampanye non-retail tanpa menyertakan aset minimum yang diperlukan. Inilah alasan Anda harus menyertakanAssetGroup
dan resourceAssetGroupAsset
-nya dalam permintaan yang sama. Ini juga berarti bahwa semua resourceAssetGroupAsset
Anda harus memenuhi spesifikasi yang benar untukfield_type
yang ditentukan guna mencegah kegagalan seluruh permintaan.
Operasi grup dengan permintaan mutasi
Kampanye Performa Maksimal terdiri dari beberapa resource, dan Anda memiliki opsi untuk membuat resource terpisah ini dalam permintaan unik atau dalam satu permintaan mutasi massal. Namun, AssetGroups
dan AssetGroupAssets
yang terkait dalam kampanye Performa Maksimal standar harus dibuat dalam satu permintaan atomik seperti yang telah disebutkan.
Kampanye Anda tidak memenuhi syarat untuk ditayangkan sebelum Anda berhasil membuat semua referensi yang diperlukan yang tercantum dalam panduan ini. Saat mengeluarkan permintaan terpisah, gunakan nama resource sebenarnya dari resource yang direferensikan dalam permintaan berikutnya. Saat menerbitkan permintaan mutasi massal yang berisi beberapa operasi, gunakan nama resource yang dibuat dengan penggunaan ID sementara.
Urutan operasi ({i>Order of operations<i})
Terlepas dari apakah Anda menggunakan permintaan mutasi massal untuk membuat kampanye Performa Maksimal atau tidak, Anda harus mengurutkan permintaan dan operasi sedemikian rupa agar tidak pernah mereferensikan resource sebelum dibuat. Dalam kasus permintaan mutasi massal, hal ini berarti mengurutkan operasi sedemikian rupa sehingga resource referensi dicantumkan sebelum resource yang mereferensikannya.
Jika Anda memilih untuk membuat resource Aset dalam permintaan mutasi massal yang sama dengan
yang membuat AssetGroup
dan resource AssetGroupAsset
-nya, semua
AssetOperations
harus ditempatkan sebelum semua AssetGroupAssetOperations
, seperti
yang ditunjukkan dalam diagram.
Server Google Ads mengelompokkan AssetGroupAssetOperations
yang berurutan dan mengevaluasi apakah AssetGroup
memenuhi persyaratan aset minimum setelah operasi terakhir dalam grup tersebut. Jika Anda berganti-ganti antara AssetOperations
dan AssetGroupAssetOperations
dalam permintaan Anda, server API akan mengevaluasi
persyaratan aset minimum setelah AssetGroupAssetOperation
pertama dan
menampilkan error tanpa melanjutkan operasi lainnya dalam
permintaan. Akibatnya, tidak ada aset dalam permintaan yang akan ditambahkan ke akun Google Ads Anda. Selain itu, baik AssetGroup
maupun resource
AssetGroupAsset
terkait tidak akan dibuat.
Perbarui grup aset
Setelah membuat AssetGroup
yang valid, Anda tidak dapat mengeluarkan permintaan berikutnya
yang akan menghasilkan status tidak valid dengan persyaratan aset minimum
tidak lagi terpenuhi. Permintaan semacam itu akan menampilkan error. Misalnya, jika Anda
membuat AssetGroup
dengan satu MARKETING_IMAGE
(persyaratan minimum), setiap permintaan untuk menghapus AssetGroupAsset
yang terkait dengan MARKETING_IMAGE
tersebut akan menampilkan error.
Hal ini sangat penting untuk grup aset dalam kampanye retail
yang dibuat tanpa aset terkait. Permintaan berikutnya untuk menambahkan aset ke
AssetGroup
dengan membuat resource AssetGroupAsset
hanya akan berhasil jika
permintaan tersebut memenuhi semua persyaratan aset. Dengan kata lain, Anda tidak dapat menambahkan
aset ke grup aset ini secara bertahap.