建立及管理目標對象

Audience 是可重複使用的一組特定區隔、指定客層和排除條件。最高成效、需求開發和應用程式廣告活動都支援指定目標對象。如要直接在多媒體、搜尋、影片、飯店或標準購物廣告活動中指定目標對象區隔，請前往「目標對象區隔」。

建立目標對象

使用 AudienceService 建立及更新目標對象。每個 Audience 都必須有專屬名稱。這個可重複使用的目標對象可結合多個目標對象維度：

檢查 audience_id 的 MutateAudienceResult

使用 AudienceService.MutateAudiences 建立目標對象時，每個作業都會傳回 MutateAudienceResult。您可以檢查 MutateAudienceResult，方法是剖析傳回的 resource_name，或在 response_content_type 設為 MUTABLE_RESOURCE 時檢查可變動的 audience 物件，藉此取得 audience_id：

# Inspect MutateAudienceResult to get audience_id
for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = resource_name.split("/")[-1]
    print(f"Created audience with resource_name '{resource_name}' and audience_id '{audience_id}'.")

    # If response_content_type is MUTABLE_RESOURCE, you can access result.audience.id directly:
    if result.audience and result.audience.id:
        print(f"Audience ID from mutable resource: {result.audience.id}")

您可以使用 AudienceInfo 條件，在廣告群組層級指定目標對象，方法是在 AdGroupCriterion 上將 audience 欄位設為目標對象資源名稱。

擷取目標對象

與其他資源一樣，您可以使用 GoogleAdsService.SearchStream 擷取目標對象的屬性。

SELECT
  audience.id,
  audience.resource_name,
  audience.name,
  audience.status,
  audience.description,
  audience.dimensions,
  audience.exclusion_dimension
FROM audience

指定目標對象

視廣告活動類型而定，指定目標對象的方式有很多種。

素材資源群組信號

最高成效廣告活動會使用 AssetGroupSignal指定目標對象。請參閱素材資源群組指南，瞭解如何使用素材資源群組信號指定目標對象。

廣告群組條件

需求開發和應用程式廣告活動支援使用 AdGroupCriterion 新增目標對象廣告群組條件，指定目標對象或提供目標對象信號。

設定指定目標對象的步驟如下：

在 AdGroup

建立廣告群組時，您必須在 AdGroup 中將 use_audience_grouped 設為 true，啟用目標對象指定目標。

這可讓您新增 AdGroupCriterion 和目標對象。如果這個值未設為 true，後續指定目標對象的要求就會失敗。

建立 AdGroupCriterion

建立 AdGroupCriterion，並將 audience 欄位設為本指南先前建立的目標對象資源名稱。

選用：在廣告活動中啟用目標對象指定目標

建立廣告活動時，您可以選擇設定 use_audience_grouped 為 true。啟用這項設定後，如果您嘗試在廣告活動層級新增會排除區隔和客層的條件，系統就會顯示錯誤訊息。

最佳做法

  • 使用目標對象建立目標對象輪廓。目標對象最適合用於最高成效、需求開發和應用程式廣告活動，您可以在這些廣告活動中疊加多個區隔和受眾特徵條件，指定特定目標對象。
  • 使用目標對象區隔直接指定目標。如要指定多媒體、搜尋、影片、飯店和標準購物廣告活動，或只指定單一區隔 (例如再行銷名單)，請使用「目標對象區隔」，而非「目標對象」。

常見錯誤

建立或更新 Audience 時，Google Ads API 會驗證要求，如果驗證失敗，則會從 AudienceError 列舉傳回錯誤。

AudienceError
AUDIENCE_SEGMENT_NOT_FOUND
摘要 找不到要求中的目標對象區隔。
常見原因 參照不存在或無法存取的區隔 ID。
如何處理 建立或更新目標對象前，請確認所有區隔 ID 都存在且可存取。
預防秘訣 請先驗證區隔 ID，再將其納入目標對象。
DIMENSION_INVALID
摘要 目標對象維度無效。
常見原因 包括 exclusion_dimension 中的 detailed_demographic。
如何處理 僅針對 exclusion_dimension 中的排除條件使用 user_list。
預防秘訣 建立或更新目標對象時，請確保 exclusion_dimension 中只使用 user_list。
DUPLICATE_AUDIENCE_SEGMENT
摘要 目標對象包含重複的區隔。
常見原因 將同一個區隔多次加入同一個目標對象。
如何處理 從目標對象定義中移除重複區隔。
預防秘訣 確認目標對象中的所有區隔皆不重複。
NAME_ALREADY_IN_USE
摘要 目標對象名稱已有人使用。
常見原因 嘗試建立多個同名目標對象。
如何處理 建立目標對象時，請使用不重複的名稱。
預防秘訣 建立新的目標對象前，請先檢查是否有現有的目標對象名稱。
TOO_MANY_DIMENSIONS_OF_SAME_TYPE
摘要 目標對象包含太多相同類型的維度。
常見原因 在一個目標對象中加入相同類型的多個維度 (例如多個年齡維度)。
如何處理 請確認目標對象定義只包含每種維度各一項。
預防秘訣 檢查目標對象定義，確保未納入重複的維度類型。
TOO_MANY_SEGMENTS
摘要 目標對象包含的區隔過多。
常見原因 目標對象中的區隔數量超出上限。
如何處理 減少目標對象定義中的區隔數量。
預防秘訣 請參閱說明文件，瞭解每個目標對象的區隔數量限制。
上一頁
總覽
下一頁
開始使用目標對象區隔