本指南將詳細說明建構與更新最高成效廣告活動結構要求的複雜步驟。這在設計整合作業時是相當實用的資源。本指南將說明修改最高成效廣告活動的要求方式,並可為最高成效廣告活動疑難排解指南和最高成效廣告活動批次處理指南提供相關資源。
建立最高成效廣告活動
在 Google Ads API 中,最高成效廣告活動實體會以多種獨特資源的形式表示。
標準最高成效廣告活動
標準最高成效廣告活動需要一定數量的資源才能放送。
請注意,建立 AssetGroup
和 AssetGroupAsset
實體的作業必須在單一要求中納入,且 AssetGroupAsset
資源必須合併以符合所有最低素材資源規定和規格。請參閱零售廣告活動一文,瞭解兩者的差異。要求建立 AssetGroup
但不含所有必要的 AssetGroupAsset
實體會導致錯誤。詳情請參閱無效的狀態與無效要求。
若要建立最高成效廣告活動的要求結構,您可以採用不同的方法。決定作業和結構要求分組的方式,主要取決於您的目標和基礎架構。
- 在建立
AssetGroup
和AssetGroupAsset
資源之前,請在不同的要求中建立CampaignBudget
、Campaign
和Asset
資源。 - 將這些資源全部加入單一變動請求。
雖然您可以在先前的個別要求中建立 CampaignBudget
、Campaign
和 Asset
資源,但必須一併建立 AssetGroup
和 AssetGroupAsset
資源,最高成效廣告活動才能放送。
有效放送最高成效廣告活動的基本規定
您可以建立如圖所示的其他資源,進一步自訂最高成效廣告活動。
您可以在建立 AssetGroup
和 AssetGroupAsset
資源的相同要求中加入建立 AssetGroupSignal
資源的作業。或者,您也可以在建立 AssetGroup
後,根據個別要求建立 AssetGroupSignal
實體。
最高成效廣告活動搭配其他選項
零售業專用最高成效廣告活動
零售廣告活動的特別之處在於,您可以透過下列兩種方式建立素材資源群組,進而放送有效的廣告活動:
- 沒有任何素材資源的素材資源群組
- 包含「所有」必要素材資源的素材資源群組 (建議)
從素材資源群組排除素材資源時,Google 會自動使用已連結的 Merchant Center 帳戶中提供的素材資源來製作廣告。不過,我們建議您提供素材資源,以便在所有廣告空間觸及使用者。 零售業專用最高成效廣告活動至少需要一組資源才能放送。
CampaignBudget
Campaign
(填入的ShoppingSettings
)AssetGroup
AssetGroupListingGroupFilter
請務必注意,零售廣告活動中必須填入 Campaign.shopping_settings
欄位。此外,每個 AssetGroup
中列出的 final_urls
都必須與 Campaign.shopping_settings
中指定的 Merchant Center 帳戶 ID 相關聯。最後,每個 AssetGroup
都必須具備相關聯且有效的產品資訊群組樹狀結構,該樹狀結構由一或多個 AssetGroupListingGroupFilter
資源組成。您至少要建立單一節點樹狀結構,以涵蓋指定的 Merchant Center 動態饋給中所有產品。
每項資源都可單獨建立,或是在單一要求中建立。不過,必須等到所有資源都建立正確後,廣告活動才能放送。
有效放送零售最高成效廣告活動的基本規定
零售廣告活動可採用標準最高成效廣告活動可用的所有選項,包括建立素材資源群組信號、廣告活動轉換目標和廣告活動條件。如果您在建立 AssetGroup
資源時選擇在 AssetGroup
中新增資產,您的 AssetGroup
就必須符合最低的素材資源需求。也就是說,您可以不包含任何資產或所有必要的素材資源。
零售業專用最高成效廣告活動,有額外選項
狀態無效與無效請求
在 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
必須透過單一不可分割的要求建立。
您必須成功建立本指南所提及的所有必要資源,廣告活動才符合放送廣告的資格。發出個別要求時,請在後續要求中使用參照資源的實際資源名稱。發出內含多項作業的大量 Mutate 要求時,會使用臨時 ID 構成的資源名稱。
作業順序
無論您是否使用大量 變更 要求建立最高成效廣告活動,請務必先將要求和作業排序,確保資源在建立前一律不會參照資源。如果是大量變更要求,這表示在參照資源的資源之前,會按照參照方式排序作業。
如果您選擇在建立 AssetGroup
及其 AssetGroupAsset
資源的相同大量變更要求中建立資產資源,所有 AssetOperations
都應放在所有 AssetGroupAssetOperations
的前面,如圖所示。
Google Ads 伺服器會連續批次處理 AssetGroupAssetOperations
,並評估 AssetGroup
是否符合該群組最後一項作業的最低素材資源需求。如果您在要求中切換使用 AssetOperations
和 AssetGroupAssetOperations
,API 伺服器會在第一個 AssetGroupAssetOperation
之後評估最低素材資源需求,並傳回錯誤,不繼續要求中的其餘作業。因此,要求中的所有素材資源都不會新增至您的 Google Ads 帳戶。此外,AssetGroup
和任何相關聯的 AssetGroupAsset
資源都不會建立。
更新素材資源群組
建立有效的 AssetGroup
後,您就無法發出後續要求,避免產生不符合最低素材資源需求的無效狀態。任何這類要求都會擲回錯誤。舉例來說,如果您建立含有單一 MARKETING_IMAGE
(最低需求) 的 AssetGroup
,則任何與 MARKETING_IMAGE
相關聯的 AssetGroupAsset
移除要求都會傳回錯誤。
如果是在零售廣告活動不含任何相關素材資源的情況下建立的素材資源群組,這一點尤其重要。如果後續透過建立 AssetGroupAsset
資源的方式將資產新增至 AssetGroup
,那麼只有在要求符合所有素材資源規定時,後續要求才會成功。換句話說,您無法逐步將素材資源加進這些素材資源群組。