建立及管理目標對象

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

建立目標對象

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

檢查 MutateAudienceResult 的 audience_id

使用 AudienceService.MutateAudiences 建立目標對象時，每項作業都會傳回 MutateAudienceResult。您可以檢查 MutateAudienceResult，剖析傳回的 resource_name 即可取得 audience_id，並在 response_content_type 設為 MUTABLE_RESOURCE 時，檢查傳回的 audience 物件中可變動的欄位 (例如 name)：

# Configure the request to return the mutable resource in the response.
request = googleads_client.get_type("MutateAudiencesRequest")
request.customer_id = customer_id
request.operations = [operation]
request.response_content_type = (
    googleads_client.enums.ResponseContentTypeEnum.MUTABLE_RESOURCE
)

response = audience_service.mutate_audiences(request=request)

for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = audience_service.parse_audience_path(resource_name)[
        "audience_id"
    ]
    print(f"Created audience '{resource_name}' with ID '{audience_id}'.")

    # Access mutable fields on result.audience when MUTABLE_RESOURCE is requested.
    if result.audience.resource_name:
        print(f"Audience name from mutable resource: {result.audience.name}")

擷取目標對象

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

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

指定目標對象

視廣告活動類型而定，您可以透過多種方式指定目標對象。

素材資源群組信號

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

廣告群組條件

需求開發和應用程式廣告活動支援使用 AdGroupCriterion 新增目標對象廣告群組條件，指定目標對象或提供目標對象信號。您可以在廣告群組層級使用 AudienceInfo 條件，透過設定 AdGroupCriterion.audience 欄位 (ad_group_criterion.audience.audience) 為目標對象資源名稱，指定目標對象。AudienceInfo.audience

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

在 AdGroup 中啟用目標對象指定目標

您必須在建立廣告群組時，將 AdGroup 中的 use_audience_grouped 設為 true，才能啟用指定目標對象。廣告群組建立後，就無法變更這項設定。

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

建立 AdGroupCriterion

建立 AdGroupCriterion，並將 AdGroupCriterion.audience 上的 AudienceInfo.audience 欄位設為在「建立目標對象」中建立的目標對象資源名稱。

選用：在 Campaign 中啟用指定目標對象

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

最佳做法

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

常見錯誤

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

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