結構要求

本指南將詳述建構要求的許多複雜細節 並更新最高成效廣告活動這在您設計時 以及整合的服務本指南將說明修改最高成效廣告活動的要求方式 廣告活動並加以處理，可以是最高成效廣告活動 疑難排解指南，以及 最高成效廣告活動批次處理指南：

建立最高成效廣告活動

在 Google Ads API 中，最高成效廣告活動實體會顯示為 組合不同獨特的資源

標準最高成效廣告活動

標準最高成效廣告活動需要一定數量的資源才能順利上手 放送。

• 廣告活動預算
• 廣告活動
• 素材資源群組
• 素材資源群組素材資源
• 素材資源

請注意，建立 AssetGroup 和 AssetGroupAsset 實體必須納入單一要求中，且 必須合併 AssetGroupAsset 項資源，以符合所有最低需求 需求和規格； 看看 零售廣告活動：建立要求 如果 AssetGroup 不含所有必要的 AssetGroupAsset 實體，就會產生 錯誤；看 狀態無效與無效請求 瞭解背景資訊。

如要建構要求以建立要求，您可以採取不同的做法 最高成效廣告活動。決定如何把作業分組 主要取決於目標和基礎架構

• 分別建立 CampaignBudget、Campaign 和 Asset 資源 才會建立 AssetGroup 和 AssetGroupAsset 資源。
• 將這些資源全部加入單一變動請求。

雖然您可以成功建立 CampaignBudget、Campaign 和 Asset ，最高成效廣告活動就不會 放送到 AssetGroup 和 AssetGroupAsset 資源之前

有效放送最高成效廣告活動的基本規定

如要進一步自訂最高成效廣告活動，您可以建立額外的 如圖表所示

• 素材資源群組信號
• 廣告活動轉換目標
• 廣告活動條件

您可以加入作業，在相同位置建立 AssetGroupSignal 資源 要求建立 AssetGroup 和 AssetGroupAsset 資源。 或者，您也可以在個別要求中建立 AssetGroupSignal 實體 建立 AssetGroup 之後。

最高成效廣告活動搭配其他選項

零售業專用最高成效廣告活動

零售廣告活動的特色在於 建立素材資源群組，進而有效放送 廣告活動：

• 沒有任何素材資源的素材資源群組
• 包含「所有」必要素材資源的素材資源群組 (建議)

如果您選擇從素材資源群組中排除素材資源，Google 會自動使用 中提供的素材資源 已連結的 Merchant Center 帳戶 廣告。不過，我們建議你提供素材資源，以便透過所有廣告空間觸及使用者。 零售業專用最高成效廣告活動適用的最低組合 才能使用目前的資源

• CampaignBudget
• Campaign (填入的 ShoppingSettings)
• AssetGroup
• AssetGroupListingGroupFilter

請務必注意，Campaign.shopping_settings 欄位必須是 填入零售廣告活動的資料此外，每個參數中列出的 final_urls AssetGroup 必須與 Merchant Center 帳戶 ID 相關聯的網址相符 在 Campaign.shopping_settings 中指定的值。最後，每個 AssetGroup 都必須 具備相關且有效的產品資訊群組樹狀結構，由一或多個 AssetGroupListingGroupFilter 資源。您至少必須建立一項 節點樹狀圖，將指定 Merchant Center 動態饋給中的所有產品納入考量。

您可以單獨建立資源，也可以利用單一要求建立這些資源。 不過，必須等到上述所有資源後，廣告活動才能放送 正確建立而成

有效放送零售最高成效廣告活動的基本規定

零售廣告活動可使用所有標準可用的選項 最高成效廣告活動，包括建立素材資源群組信號、廣告活動 轉換目標和廣告活動條件如果選擇在應用程式內 AssetGroup建立 AssetGroup 資源時，您的AssetGroup是 違反最低素材資源規定也就是說，您可以 不含任何素材資源或所有必要的素材資源。

零售業專用最高成效廣告活動，有額外選項

狀態無效與無效請求

在 Google Ads API 中使用最高成效廣告活動時， 無效狀態和無效請求之間重要差異的重要差異。

州/省錯誤

廣告活動因設定方式而無法放送。適用對象 舉例來說，您可以建立獨立的 Campaign 資源， 第 advertising_channel_type 個，共 PERFORMANCE_MAX 個。雖然建立請求 廣告活動成功 AssetGroup至廣告活動。如果您的請求成功，但廣告活動 素材資源群組無法放送。您可以使用CampaignPrimaryStatus CampaignPrimaryStatusReason、AssetGroupPrimaryStatus和 AssetGroupPrimaryStatusReason 會決定原因，詳情請參閱 疑難排解 指南。

要求無效

失敗請求失敗，因為廣告活動或 將資源新增至無效狀態舉例來說，如果您在 請嘗試為非零售廣告活動建立AssetGroup，但不要加入 符合最低門檻的素材資源。這是 請務必在訂閱清單中AssetGroup及其AssetGroupAsset資源 相同要求這也表示您所有的 AssetGroupAsset 資源都必須 符合指定 field_type 的正確規格，以免 以及要求失敗

使用變動請求將作業分組

最高成效廣告活動包含多項資源 可選擇分別在個別要求或單一要求 大量變更要求。不過，AssetGroups 和 標準最高成效廣告活動的相關聯AssetGroupAssets必須 如先前所述，在單一不可拆分要求中同時建立

除非您成功建立所有的 所需資源如要單獨核發 在後續要求中，使用參照資源的實際資源名稱 要求。發出包含多個作業的大量 變更 請求時，請使用 使用臨時 ID 組成的資源名稱。

作業順序

無論是否透過大量變更要求建立最高成效廣告活動 廣告活動，就必須將請求和作業訂單 建立前先參照資源如果是大量變更 意即以參照方式將作業排序 就會在參照資源的資源之前列出。

如果您選擇在同一個大量 變更 要求中建立素材資源資源 建立 AssetGroup 及其 AssetGroupAsset 資源 AssetOperations 應在所有 AssetGroupAssetOperations 之前，如下所示： 如圖表所示

Google Ads 伺服器連續批次處理 AssetGroupAssetOperations 並評估AssetGroup是否符合基本的素材資源規定 群組中最後一個作業如果在 AssetOperations 之間交替使用 和 AssetGroupAssetOperations 時，API 伺服器會評估 第一個AssetGroupAssetOperation和 傳回錯誤，而不會繼續 請求。因此，要求中的所有資產都不會新增至您的 Google Ads 帳戶。此外，AssetGroup 或任何相關聯的 將會建立 AssetGroupAsset 項資源。

更新素材資源群組

建立有效的 AssetGroup 後，就無法發出後續要求 否則會導致素材資源數量達最低要求無效 則有助於判斷標準任何這類要求都會擲回錯誤。舉例來說，如果您在 建立包含單一 MARKETING_IMAGE 的 AssetGroup (最低需求)，任何移除 AssetGroupAsset 的要求 與 MARKETING_IMAGE 相關聯的會傳回錯誤。

如果是零售廣告活動中的素材資源群組，這一點尤其重要 (不具任何相關資產) 建立而成後續將要求將資產新增至 AssetGroup，也就是說，建立 AssetGroupAsset 資源時，只有 要求符合所有素材資源規定換句話說，在建立廣告單元時 循序漸進地使用這些素材資源群組