本指南將詳細說明建立及更新最高成效廣告活動的許多複雜要求。您在設計整合時，這會是實用的資源。本指南說明會如何變更最高成效廣告活動的請求處理方式，並可做為最高成效廣告活動疑難排解指南的輔助資源。
建立最高成效廣告活動
在 Google Ads API 中，最高成效廣告活動實體會以數個獨特資源表示。
標準最高成效廣告活動
標準最高成效廣告活動至少需要一組資源才能放送廣告。
請特別注意，建立 AssetGroup 和 AssetGroupAsset 實體的作業必須全部納入單一要求中，且 AssetGroupAsset 資源必須合併，才能符合所有最低資產規定及規格。請參閱零售廣告活動有何差異。如果要求建立 AssetGroup，但沒有所有必要的 AssetGroupAsset 實體，就會發生錯誤。詳情請參閱「無效狀態與無效要求」一節。
規劃建立最高成效廣告活動的要求時，有多種不同選擇。如何將作業和結構要求分組，主要取決於您的目標和基礎架構。
- 建立
AssetGroup和AssetGroupAsset資源前，請先分別要求建立CampaignBudget、Campaign和Asset資源。 - 將所有這些資源都加入一個 Change 請求中。
雖然您可以分別在先前的要求中建立 CampaignBudget、Campaign 和 Asset 資源，但也必須建立 AssetGroup 和 AssetGroupAsset 資源，最高成效廣告活動才能放送。
有效放送最高成效廣告活動的基本規定
您可以建立如圖所示的其他資源，進一步自訂最高成效廣告活動。
您可以在建立 AssetGroup 和 AssetGroupAsset 資源的同一個要求中，加入建立 AssetGroupSignal 資源的作業。或者，您也可以在建立 AssetGroup 後，在個別要求中建立 AssetGroupSignal 實體。
最高成效廣告活動搭配其他選項
零售業專用最高成效廣告活動
零售廣告活動的特色在於，您可以透過以下兩種不同方式建立素材資源群組，打造有效的放送廣告活動：
- 沒有任何素材資源的素材資源群組
- 包含「所有」必要素材資源的素材資源群組 (建議)
當您選擇從素材資源群組中排除素材資源時，Google 會自動使用您在已連結的 Merchant Center 帳戶中提供的素材資源製作廣告。不過，建議您提供可在所有廣告空間觸及的素材資源。 零售業專用最高成效廣告活動必須符合下列條件才能放送：
CampaignBudgetCampaign(已填入ShoppingSettings)AssetGroupAssetGroupListingGroupFilter
請注意，零售廣告活動中的 Campaign.shopping_settings 欄位必須填入。此外，每個 AssetGroup 中列出的 final_urls 必須與 Campaign.shopping_settings 中指定的 Merchant Center 帳戶 ID 相關聯的網址相符。最後，每個 AssetGroup 都必須有由一或多個 AssetGroupListingGroupFilter 資源組成的相關有效產品資訊群組樹狀結構。您至少必須建立一個節點樹狀結構，為指定的 Merchant Center 動態饋給中的所有產品進行計算。
這些資源可以分別建立，也能建立單一要求。不過，您必須先正確建立所有這些資源，廣告活動才能放送。
有效放送零售最高成效廣告活動的基本規定
零售廣告活動可使用標準最高成效廣告活動可用的所有選項，包括建立素材資源群組信號、廣告活動轉換目標，以及廣告活動條件。如果您在建立 AssetGroup 資源時選擇將資產新增至 AssetGroup，則 AssetGroup 會遵循資產的基本規定。換句話說，您可以不包含任何素材資源
或是所有必要的素材資源
零售業專用最高成效廣告活動搭配其他選項
無效狀態與無效要求
在 Google Ads API 中使用最高成效廣告活動時，出現無效狀態和無效要求有幾項重要差異。
- 無效的州/省
- 廣告活動的設定方式不符，因此不符合放送資格。舉例來說，您可以建立
advertising_channel_type為PERFORMANCE_MAX的獨立Campaign資源。雖然建立廣告活動的要求成功，但必須先在廣告活動中加入至少一個AssetGroup，才能放送廣告。如果請求成功，但廣告活動或素材資源群組並未放送，您可以使用CampaignPrimaryStatus、CampaignPrimaryStatusReason、AssetGroupPrimaryStatus和AssetGroupPrimaryStatusReason來判斷原因 (詳情請參閱疑難排解指南)。 - 要求無效
- 失敗的請求會導致廣告活動或資源進入無效狀態，舉例來說，如果您嘗試為非零售廣告活動建立
AssetGroup，但未加入最低必要素材資源，Google Ads API 就會擲回錯誤。因此，您必須在同一項要求中加入AssetGroup及其AssetGroupAsset資源。這也表示所有AssetGroupAsset資源都必須符合特定field_type的正確規格，以免整個要求失敗。
包含變更請求的群組作業
最高成效廣告活動由多項資源組成，您可以選擇在不重複要求或單一大量變更要求中建立個別資源。不過，標準最高成效廣告活動中的 AssetGroups 和關聯 AssetGroupAssets 必須在單一不可分割要求中建立 (如先前所述)。
您必須先成功建立本指南所述的所有必要資源，廣告活動才能符合放送資格。發出個別要求時，請在後續要求中使用參照資源的實際資源名稱。發出大量變更要求時，如果包含多個作業，則會使用以臨時 ID 組成的資源名稱。
作業順序
無論您是否使用大量 change 要求建立最高成效廣告活動，您都必須先訂購要求和作業，才能在建立資源前，先不參照任何資源。就大量修改要求而言，這代表作業的排序方式要以參照資源的方式，在參照資源的資源之前列出。
如果您選擇在建立 AssetGroup 及其 AssetGroupAsset 資源的同一個大量修改要求中建立資產資源，所有 AssetOperations 都應位於所有 AssetGroupAssetOperations 之前，如圖所示。
Google Ads 伺服器會將連續 AssetGroupAssetOperations 批次處理，並評估 AssetGroup 是否在群組的最後一項作業之後，符合最低素材資源需求。如果在要求中交替指定 AssetOperations 和 AssetGroupAssetOperations，API 伺服器會在第一個 AssetGroupAssetOperation 之後評估資產最低需求，並傳回錯誤，而不繼續要求中的其餘作業。因此，系統不會將要求中的任何素材資源加進您的 Google Ads 帳戶。此外，系統不會建立 AssetGroup 和任何相關聯的 AssetGroupAsset 資源。
更新素材資源群組
建立有效的 AssetGroup 後，您就無法發出後續要求，該要求會導致不再符合最低素材資源規定的無效狀態。這類要求都會擲回錯誤。舉例來說，如果您建立AssetGroup一個 (最低需求)MARKETING_IMAGE (最低需求)，則任何要求移除與該 MARKETING_IMAGE 相關 AssetGroupAsset 的要求都會傳回錯誤。
如果零售廣告活動建立的素材資源群組沒有相關聯的素材資源，就特別需要留意。後續透過建立 AssetGroupAsset 資源而將資產新增至 AssetGroup 的要求，只有在要求符合所有資產需求時才會成功。換句話說，素材資源無法逐步加入這些素材資源群組。