Permintaan Struktur

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

Membuat 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 aset minimum agar dapat ditayangkan.

Untuk kampanye yang mengaktifkan pedoman merek, 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 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 menyusun permintaan yang membuat kampanye Performa Maksimal. Keputusan tentang cara mengelompokkan operasi dan menyusun permintaan sangat 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 diaktifkan, resource Campaign dan CampaignAsset yang diperlukan harus disertakan bersama dalam satu permintaan)
  • Sertakan semua resource ini dalam satu permintaan modifikasi.

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

Persyaratan minimum untuk kampanye Performa Maksimal yang valid dan aktif

gambar

Anda dapat menyesuaikan kampanye Performa Maksimal lebih lanjut dengan membuat referensi 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 bersifat unik karena ada dua cara berbeda untuk membuat grup aset yang menghasilkan kampanye penayangan yang valid:

  • Grup aset tanpa aset kustom (atau hanya dengan aset HTML5 MEDIA_BUNDLE)
  • Grup aset yang berisi semua aset yang diperlukan (lebih disukai)

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 menjangkau semua inventaris. Kampanye retail Performa Maksimal memerlukan kumpulan resource minimum berikut agar dapat ditayangkan:

  • CampaignBudget
  • Campaign (dengan ShoppingSetting yang diisi)
  • AssetGroup
  • AssetGroupListingGroupFilter

Kolom Campaign.shopping_setting harus diisi di kampanye retail. Selain itu, setiap final_urls yang tercantum dalam AssetGroup harus cocok dengan domain situs yang terkait dengan ID akun Merchant Center yang ditentukan di Campaign.shopping_setting. Terakhir, setiap AssetGroup harus memiliki hierarki grup listingan produk yang terkait dan valid yang terdiri dari satu atau beberapa resource AssetGroupListingGroupFilter. Setidaknya, Anda harus membuat hierarki node tunggal 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 resource ini dibuat dengan benar.

Persyaratan minimum untuk kampanye retail Performa Maksimal yang valid dan aktif

gambar

Kampanye retail Performa Maksimal dapat menggunakan 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 kustom (selain aset MEDIA_BUNDLE HTML5) ke AssetGroup saat membuat resource AssetGroup, permintaan Anda harus memenuhi semua persyaratan aset minimum (termasuk aset merek tingkat kampanye jika pedoman merek diaktifkan). Dengan kata lain, jangan sertakan aset kustom atau sertakan semua aset yang diperlukan.

Kampanye retail Performa Maksimal dengan opsi tambahan

gambar

Status tidak valid versus permintaan tidak valid

Saat menggunakan kampanye Performa Maksimal di Google Ads API, ada perbedaan penting antara status tidak valid dan permintaan 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 dari PERFORMANCE_MAX. Meskipun permintaan untuk membuat kampanye berhasil, kampanye tersebut 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 menempatkan kampanye atau resource ke dalam status tidak valid. Misalnya, Google Ads API akan menampilkan error jika Anda mencoba membuat AssetGroup untuk kampanye non-retail (selain kampanye Performa Maksimal Jasa dan Servis) tanpa menyertakan aset minimum yang diperlukan. Oleh karena itu, Anda harus menyertakan AssetGroup dan resource AssetGroupAsset-nya dalam permintaan yang sama. Artinya, semua resource AssetGroupAsset Anda harus memenuhi spesifikasi yang benar untuk field_type tertentu agar seluruh permintaan tidak gagal.

Mengelompokkan operasi dengan permintaan modifikasi

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 terkait di 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 resource yang diperlukan yang disebutkan di seluruh panduan ini. Saat mengeluarkan permintaan terpisah, gunakan nama resource sebenarnya dari resource yang direferensikan dalam permintaan berikutnya. Saat mengeluarkan permintaan mutasi massal yang berisi beberapa operasi, gunakan nama resource yang dibentuk dengan menggunakan ID sementara.

Urutan operasi

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

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

gambar

Server Google Ads mengelompokkan AssetGroupAssetOperations berturut-turut 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 membuat grup aset berada di bawah persyaratan aset minimum. Permintaan semacam itu akan menampilkan error. Misalnya, jika Anda membuat AssetGroup dengan satu MARKETING_IMAGE (persyaratan minimum), permintaan untuk menghapus hanya MARKETING_IMAGE AssetGroupAsset tersebut akan menampilkan error. Namun, di kampanye retail Performa Maksimal, Anda dapat mengembalikan AssetGroup untuk mengandalkan aset yang dibuat otomatis oleh Google Merchant Center dengan menghapus semua link AssetGroupAsset kustom dalam satu permintaan.

Untuk grup aset di kampanye retail Performa Maksimal yang dibuat tanpa aset kustom terkait, permintaan berikutnya untuk menautkan aset kustom (selain aset MEDIA_BUNDLE HTML5) harus memastikan setidaknya satu final_urls ditetapkan di AssetGroup (mengisinya terlebih dahulu jika awalnya dihilangkan) dan harus menyediakan semua aset minimum yang diperlukan (termasuk aset merek tingkat kampanye jika pedoman merek diaktifkan) dalam satu permintaan atomik. Jangan menautkan aset opsional seperti YOUTUBE_VIDEO saja atau menambahkan aset secara inkremental di seluruh permintaan terpisah. Menautkan hanya aset kustom opsional akan membuat grup aset dalam status tidak didukung yang memblokir pengeditan di UI Google Ads. Untuk mengetahui detailnya, lihat Menautkan grup aset ke aset di kampanye retail Performa Maksimal.

Sebelumnya
Pelaporan Kriteria Kampanye
Berikutnya
Batch processing