Permintaan Struktur

Panduan ini menjelaskan banyak seluk-beluk struktur permintaan yang membuat dan memperbarui kampanye Performa Maksimal. Ini bisa menjadi referensi yang berguna saat Anda mendesain integrasi Anda. Panduan ini menjelaskan cara permintaan yang memutasikan Performa Maksimal kampanye diproses dan dapat menjadi referensi untuk Performa Maksimal panduan pemecahan masalah dan Panduan batch processing Performa Maksimal.

Buat kampanye Performa Maksimal

Di Google Ads API, entitas kampanye Performa Maksimal direpresentasikan sebagai kombinasi dari beberapa sumber daya unik.

Kampanye Performa Maksimal Standar

Kampanye Performa Maksimal Standar memerlukan kumpulan resource minimum agar dapat untuk ditayangkan.

• Anggaran kampanye
• Kampanye
• Grup aset
• Aset grup aset
• Aset

Penting untuk diperhatikan bahwa operasi untuk membuat AssetGroup dan AssetGroupAsset entitas harus disertakan bersama dalam satu permintaan, dan resource AssetGroupAsset harus digabungkan untuk memenuhi semua aset minimum persyaratan dan spesifikasi; melihat bagaimana hal ini berbeda untuk Kampanye retail. Permintaan pembuatan AssetGroup tanpa semua entity AssetGroupAsset yang diperlukan akan menghasilkan {i>error<i}; lihat Status tidak valid versus permintaan tidak valid untuk konteks selengkapnya.

Ada berbagai opsi dalam hal menyusun permintaan yang membuat Kampanye Performa Maksimal. Keputusan bagaimana cara mengelompokkan operasi dan permintaan struktur akan sangat bergantung pada tujuan dan infrastruktur Anda.

• Membuat resource CampaignBudget, Campaign, dan Asset secara terpisah sebelum membuat resource AssetGroup dan AssetGroupAsset.
• Sertakan semua resource ini dalam satu permintaan mutasi.

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

Persyaratan minimum agar kampanye Performa Maksimal ditayangkan secara valid

Anda dapat menyesuaikan kampanye Performa Maksimal lebih lanjut dengan membuat resource seperti yang ditunjukkan dalam diagram.

• Sinyal Grup Aset
• Sasaran Konversi Kampanye
• Kriteria Kampanye

Anda dapat menyertakan operasi untuk membuat resource AssetGroupSignal dengan cara 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 terdapat dua cara terpisah untuk membuat grup aset yang menghasilkan penayangan yang valid kampanye:

• 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 tersedia di akun Merchant Center tertaut untuk membuat iklan. Namun, sebaiknya sediakan aset untuk dijangkau di semua inventaris. Kampanye Performa Maksimal untuk retail memerlukan kumpulan minimum berikut resource agar dapat ditayangkan.

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

Penting untuk diperhatikan bahwa kolom Campaign.shopping_settings harus yang 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 AssetGroupListingGroupFilter resource. Setidaknya, Anda harus membuat 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 hingga semua materi ini telah 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, termasuk membuat sinyal grup aset, kampanye sasaran konversi, dan kriteria kampanye. Jika Anda memilih untuk menambahkan aset ke AssetGroup saat membuat resource AssetGroup, AssetGroup Anda akan tunduk pada persyaratan aset minimum. Dengan kata lain, Anda bisa tidak menyertakan aset atau semua aset yang diperlukan.

Kampanye Performa Maksimal Retail dengan opsi tambahan

Status tidak valid versus permintaan tidak valid

Saat menangani 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. Sebagai misalnya, Anda dapat membuat resource Campaign mandiri dengan advertising_channel_type dari PERFORMANCE_MAX. Meskipun permintaan untuk membuat kampanye berhasil, kampanye tidak memenuhi syarat untuk ditayangkan sampai Anda menambahkan minimal 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 pemecahan masalah kami.

Permintaan tidak valid

Permintaan yang tidak akan berhasil karena akan membuat kampanye atau resource ke dalam status tidak valid. Misalnya, Google Ads API akan menampilkan error jika Anda coba buat AssetGroup untuk kampanye non-retail tanpa menyertakan aset minimum yang diperlukan. Ini adalah mengapa Anda harus menyertakan AssetGroup dan resource AssetGroupAsset-nya di permintaan yang sama. Ini juga berarti bahwa semua resource AssetGroupAsset Anda harus memenuhi spesifikasi yang benar untuk field_type tertentu guna mencegah keseluruhan permintaan gagal.

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 sampai Anda berhasil membuat semua referensi yang diperlukan yang tercantum dalam panduan ini. Ketika menerbitkan permintaan resource, gunakan nama resource sebenarnya dari resource yang direferensikan permintaan. Saat menerbitkan permintaan mutasi massal yang berisi beberapa operasi, gunakan nama sumber daya yang dibentuk dengan penggunaan ID sementara.

Urutan operasi ({i>Order of operations<i})

Terlepas dari apakah Anda menggunakan permintaan mutasi massal untuk membuat Performa Maksimal kampanye, Anda harus mengurutkan permintaan dan operasi sedemikian rupa sehingga Anda tidak merujuk ke resource sebelum dibuat. Jika terjadi mutasi massal permintaan, ini berarti mengurutkan operasi sedemikian rupa sehingga resource dicantumkan sebelum resource yang mereferensikannya.

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

Server Google Ads mengelompokkan AssetGroupAssetOperations yang berturut-turut dan mengevaluasi apakah AssetGroup memenuhi persyaratan aset minimum dengan mengikuti operasi terakhir dalam grup tersebut. Jika Anda bergantian antara AssetOperations dan AssetGroupAssetOperations dalam permintaan Anda, server API akan mengevaluasi persyaratan aset minimum setelah AssetGroupAssetOperation pertama dan menampilkan kesalahan tanpa melanjutkan operasi lain di permintaan. Akibatnya, tidak ada aset dalam permintaan yang akan ditambahkan ke Akun Google Ads. Selain itu, baik AssetGroup maupun AssetGroupAsset resource akan dibuat.

Perbarui grup aset

Setelah Anda membuat AssetGroup yang valid, Anda tidak dapat mengirimkan permintaan berikutnya yang akan menghasilkan status tidak valid, dengan persyaratan aset minimum tidak lagi terpenuhi. Permintaan semacam itu akan menampilkan error. Misalnya, jika Anda buat 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 memenuhi semua persyaratan aset. Dengan kata lain, Anda tidak dapat menambahkan aset ke grup aset ini secara bertahap.