結構要求

本指南將詳細說明建立及更新最高成效廣告活動時，如何建構複雜的要求。在設計整合時，這項資源會很有幫助。本指南說明如何處理最高成效廣告活動的變更要求，並可做為最高成效疑難排解指南和最高成效批次處理指南的輔助資源。

建立最高成效廣告活動

在 Google Ads API 中，最高成效廣告活動實體是由多項不重複資源組合而成。

標準最高成效廣告活動

標準最高成效廣告活動需要一組最低限度的資源才能放送。

如果廣告活動已啟用品牌宣傳指南，則建立 Campaign 和必要 CampaignAsset 資源的操作必須包含在單一要求中，且 CampaignAsset 資源必須符合最低素材資源規定和規格。

請注意，建立 AssetGroup 和 AssetGroupAsset 實體的操作必須一併包含在單一要求中，且 AssetGroupAsset 資源必須合併，才能符合所有最低素材資源規定和規格；請參閱零售廣告活動的差異。如果要求建立 AssetGroup，但未提供所有必要的 AssetGroupAsset 實體，就會發生錯誤。詳情請參閱「無效狀態與無效要求」。

建立最高成效廣告活動時，有多種要求結構選項。如何將作業分組及建構要求，主要取決於您的目標和基礎架構。

  • 在建立 AssetGroup 和 AssetGroupAsset 資源之前，請先在個別要求中建立 CampaignBudget、Campaign、Asset 和 CampaignAsset 資源。(如果廣告活動已啟用品牌宣傳指南，則 Campaign 和必要的 CampaignAsset 資源必須一併包含在單一要求中)
  • 在單一變更要求中加入所有資源。

雖然您可以在先前的個別要求中成功建立 CampaignBudget、Campaign、Asset 和 CampaignAsset 資源，但必須一併建立 AssetGroup 和 AssetGroupAsset 資源，最高成效廣告活動才能放送。

最高成效廣告活動有效放送的最低要求

圖片

如要進一步自訂最高成效廣告活動，請按照圖表所示建立其他資源。

您可以在建立 AssetGroup 和 AssetGroupAsset 資源的同一要求中，加入建立 AssetGroupSignal 資源的操作。或者，您也可以在建立 AssetGroup 後，透過個別要求建立 AssetGroupSignal 實體。

最高成效廣告活動 (含額外選項)

圖片

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

零售廣告活動的獨特之處，在於有兩種不同的方式可建立素材資源群組，進而建立有效的廣告活動：

  • 沒有自訂素材資源 (或只有 HTML5 MEDIA_BUNDLE 素材資源) 的素材資源群組
  • 包含所有必要素材資源的素材資源群組 (建議)

如果選擇從素材資源群組中排除素材資源，Google 會自動使用連結的 Merchant Center 帳戶中提供的素材資源來建立廣告。不過，建議您提供素材資源，以便觸及所有廣告空間。最高成效零售廣告活動至少需要下列資源，才能放送：

  • CampaignBudget
  • Campaign (已填入 ShoppingSetting)
  • AssetGroup
  • AssetGroupListingGroupFilter

零售廣告活動必須填寫 Campaign.shopping_setting 欄位。此外，AssetGroup 中列出的任何 final_urls 都必須與 Campaign.shopping_setting 中指定的 Merchant Center 帳戶 ID 相關聯的網站網域相符。最後，每個 AssetGroup 都必須有相關聯的有效產品商家資訊群組樹狀結構，由一或多個 AssetGroupListingGroupFilter 資源組成。您至少必須建立一個節點樹狀結構，才能涵蓋指定 Merchant Center 動態饋給中的所有產品。

您可以分別建立這些資源，也可以在單一要求中建立。不過，必須正確建立所有資源，廣告活動才能放送。

最高成效零售廣告活動有效放送的最低要求

圖片

最高成效零售廣告活動可使用標準最高成效廣告活動的所有選項，包括建立素材資源群組信號、廣告活動轉換目標和廣告活動條件。建立 AssetGroup 資源時，如果選擇在 AssetGroup 中新增自訂素材資源 (HTML5 MEDIA_BUNDLE 素材資源除外)，要求必須符合所有最低素材資源規定 (如果已啟用品牌宣傳指南，則包括廣告活動層級品牌資產)。換句話說，請勿加入任何自訂素材資源，或加入所有必要素材資源。

含額外選項的最高成效零售廣告活動

圖片

無效狀態與無效要求

在 Google Ads API 中使用最高成效廣告活動時，請務必區分無效狀態和無效要求。

州/省錯誤
廣告活動設定有誤，因此不符合放送資格。舉例來說，您可以建立獨立的 Campaign 資源，並將 advertising_channel_type 設為 PERFORMANCE_MAX。雖然廣告活動建立要求成功，但您必須在廣告活動中加入至少一個 AssetGroup，才能放送廣告。如果要求成功，但廣告活動或素材資源群組未放送，您可以使用 CampaignPrimaryStatus、CampaignPrimaryStatusReason、AssetGroupPrimaryStatus 和 AssetGroupPrimaryStatusReason 判斷原因，詳情請參閱疑難排解指南。
無效的要求
要求會導致廣告活動或資源進入無效狀態，因此無法成功。舉例來說，如果您嘗試為非零售廣告活動 (在地生活服務最高成效廣告活動除外) 建立 AssetGroup，但未加入最低必要素材資源，Google Ads API 就會擲回錯誤。因此，您必須在同一個要求中加入 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 後，您無法發出後續要求，導致素材資源群組低於素材資源最低要求。這類要求會擲回錯誤。舉例來說，如果您建立的 AssetGroup 只有一個 MARKETING_IMAGE (最低要求)，則要求僅移除該 MARKETING_IMAGE AssetGroupAsset 會傳回錯誤。不過，在最高成效零售廣告活動中，您可以透過單一要求移除所有自訂 AssetGroupAsset 連結，改回使用 Google Merchant Center 自動產生的素材資源。AssetGroup

如果最高成效零售廣告活動中的素材資源群組，在建立時未連結任何自訂素材資源，則後續要求連結自訂素材資源 (HTML5 MEDIA_BUNDLE 素材資源除外) 時，必須確保 AssetGroup 上至少設定一個 final_urls (如果原本省略，請先填入)，且必須在單一原子要求中提供所有最低必要素材資源 (如果已啟用品牌宣傳指南，則包括廣告活動層級品牌資產)。請勿單獨連結選用廣告素材資源 (例如 YOUTUBE_VIDEO)，或在不同要求中逐步新增廣告素材資源。如果只連結選用的自訂素材資源，素材資源群組會處於不支援狀態，無法在 Google Ads 使用者介面中編輯。詳情請參閱「將素材資源群組連結至最高成效零售廣告活動中的素材資源」。

上一頁
廣告活動條件報表
下一頁
批次處理