Permintaan Struktur

Panduan ini menjelaskan banyak kerumitan dalam menyusun permintaan yang membuat dan memperbarui kampanye Performa Maksimal. Dokumen ini dapat menjadi referensi yang berguna saat Anda mendesain 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 pemrosesan batch Performa Maksimal.

Membuat kampanye Performa Maksimal

Di Google Ads API, entitas kampanye Performa Maksimal ditampilkan sebagai kombinasi beberapa resource unik.

Kampanye Performa Maksimal standar

Kampanye Performa Maksimal standar memerlukan kumpulan minimum aset agar dapat ditayangkan.

Untuk kampanye dengan pedoman merek yang diaktifkan, operasi untuk membuat Campaign dan resource CampaignAsset yang diperlukan harus disertakan dalam satu permintaan, dan resource CampaignAsset harus memenuhi persyaratan dan spesifikasi aset minimum.

Perlu diperhatikan bahwa operasi untuk membuat entitas AssetGroup dan AssetGroupAsset harus disertakan bersama dalam satu permintaan, dan resource AssetGroupAsset harus digabungkan untuk memenuhi semua persyaratan dan spesifikasi aset minimum; lihat perbedaannya untuk Kampanye Retail. Permintaan untuk membuat AssetGroup tanpa semua entity AssetGroupAsset yang diperlukan akan menghasilkan error; lihat Status tidak valid versus permintaan tidak valid untuk mengetahui konteks selengkapnya.

Ada berbagai opsi terkait penataan permintaan yang membuat kampanye Performa Maksimal. Keputusan tentang cara mengelompokkan operasi dan menyusun permintaan sebagian besar bergantung pada tujuan dan infrastruktur Anda.

  • Buat resource CampaignBudget, Campaign, Asset, dan CampaignAsset dalam permintaan terpisah sebelum membuat resource AssetGroup dan AssetGroupAsset. (Untuk kampanye dengan pedoman merek yang diaktifkan, Campaign dan resource CampaignAsset yang diperlukan harus disertakan bersama dalam satu permintaan)
  • Sertakan semua resource ini dalam satu permintaan perubahan.

Meskipun Anda dapat berhasil membuat resource CampaignBudget, Campaign, Asset, dan CampaignAsset dalam permintaan sebelumnya yang terpisah, kampanye Performa Maksimal tidak akan memenuhi syarat untuk ditayangkan hingga resource AssetGroup dan AssetGroupAsset dibuat juga.

Persyaratan minimum untuk kampanye Performa Maksimal yang valid dan dapat ditayangkan

gambar

Anda dapat menyesuaikan kampanye Performa Maksimal lebih lanjut dengan membuat aset 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

gambar

Kampanye Performa Maksimal untuk retail

Kampanye retail unik karena ada dua cara terpisah untuk membuat grup aset yang menghasilkan kampanye penayangan yang valid:

  • Grup aset tanpa aset
  • Grup aset yang berisi SEMUA aset yang diperlukan (disarankan)

Jika Anda memilih untuk mengecualikan aset dari grup aset, Google akan otomatis menggunakan aset yang diberikan di akun Merchant Center tertaut untuk membuat iklan. Namun, sebaiknya sediakan aset untuk menjangkau semua inventaris. Kampanye Performa Maksimal untuk retail memerlukan set minimum sumber daya berikut agar dapat ditayangkan.

  • CampaignBudget
  • Campaign (dengan ShoppingSettings yang terisi)
  • AssetGroup
  • AssetGroupListingGroupFilter

Perlu 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 yang valid dan terkait, yang terdiri dari satu atau beberapa resource AssetGroupListingGroupFilter. Minimal, Anda harus membuat satu pohon 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 memenuhi syarat untuk ditayangkan hingga semua aset ini dibuat dengan benar.

Persyaratan minimum untuk kampanye Performa Maksimal Retail yang valid dan ditayangkan

gambar

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 tidak menyertakan aset atau menyertakan semua aset yang diperlukan.

Kampanye Performa Maksimal Retail dengan opsi tambahan

gambar

Status tidak valid versus permintaan tidak valid

Saat bekerja dengan kampanye Performa Maksimal di Google Ads API, ada perbedaan penting antara status yang tidak valid dan permintaan yang tidak valid.

Negara bagian tidak valid
Kampanye tidak memenuhi syarat untuk ditayangkan karena konfigurasinya. Misalnya, Anda dapat membuat resource Campaign mandiri dengan advertising_channel_type PERFORMANCE_MAX. Meskipun permintaan untuk membuat kampanye berhasil, kampanye tidak memenuhi syarat untuk ditayangkan hingga Anda menambahkan setidaknya satu AssetGroup ke kampanye. Jika permintaan Anda berhasil, tetapi kampanye atau grup aset tidak ditayangkan, Anda dapat menggunakan CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus, dan AssetGroupPrimaryStatusReason untuk menentukan alasannya, seperti yang dijelaskan dalam panduan pemecahan masalah.
Permintaan tidak valid
Permintaan yang tidak akan berhasil karena akan membuat kampanye atau resource berada dalam status tidak valid. Misalnya, Google Ads API akan menampilkan error jika Anda mencoba membuat AssetGroup untuk kampanye non-retail tanpa menyertakan aset minimum yang diperlukan. Itulah sebabnya Anda harus menyertakan AssetGroup dan resource AssetGroupAsset-nya dalam permintaan yang sama. Ini juga berarti bahwa semua resource AssetGroupAsset Anda harus memenuhi spesifikasi yang benar untuk field_type tertentu agar seluruh permintaan tidak gagal.

Mengelompokkan operasi dengan permintaan perubahan

Kampanye Performa Maksimal terdiri dari beberapa aset, dan Anda memiliki opsi untuk membuat aset terpisah ini dalam permintaan unik atau dalam satu permintaan mutasi massal. Namun, AssetGroups dan AssetGroupAssets terkait dalam kampanye Performa Maksimal standar harus dibuat dalam satu permintaan atomik seperti yang telah disebutkan.

Kampanye Anda tidak memenuhi syarat untuk ditayangkan sampai Anda berhasil membuat semua aset yang diperlukan yang disebutkan dalam panduan ini. Saat mengeluarkan permintaan terpisah, gunakan nama resource sebenarnya dari resource yang dirujuk dalam permintaan berikutnya. Saat mengeluarkan permintaan perubahan massal yang berisi beberapa operasi, gunakan nama resource yang dibuat dengan menggunakan ID sementara.

Urutan operasi

Terlepas dari apakah Anda menggunakan permintaan perubahan massal untuk membuat kampanye Performa Maksimal, Anda harus mengurutkan permintaan dan operasi agar tidak pernah mereferensikan resource sebelum dibuat. Dalam kasus permintaan perubahan massal, hal ini berarti mengurutkan operasi sedemikian rupa sehingga resource yang dirujuk dicantumkan sebelum resource yang merujuknya.

Jika Anda memilih untuk membuat resource Aset dalam permintaan mutasi massal yang sama yang membuat AssetGroup dan resource AssetGroupAsset-nya, semua AssetOperations harus muncul sebelum semua AssetGroupAssetOperations, seperti yang ditunjukkan dalam diagram.

gambar

Server Google Ads mengelompokkan AssetGroupAssetOperations yang berurutan dan mengevaluasi apakah AssetGroup memenuhi persyaratan aset minimum setelah operasi terakhir dalam grup tersebut. Jika Anda bergantian antara AssetOperations dan AssetGroupAssetOperations dalam permintaan, 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, AssetGroup maupun resource AssetGroupAsset terkait tidak akan dibuat.

Memperbarui grup aset

Setelah membuat AssetGroup yang valid, Anda tidak dapat mengeluarkan permintaan berikutnya yang akan menghasilkan status tidak valid di mana persyaratan aset minimum tidak lagi terpenuhi. Setiap permintaan tersebut akan memunculkan 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 dalam kasus grup aset di kampanye retail yang dibuat tanpa aset terkait. Permintaan berikutnya untuk menambahkan aset ke AssetGroup dengan membuat resource AssetGroupAsset hanya akan berhasil jika permintaan memenuhi semua persyaratan aset. Dengan kata lain, Anda tidak dapat menambahkan aset ke grup aset ini secara inkremental.