建立及管理目標對象

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

建立目標對象

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

• 目標對象區隔
  • 使用者名單區隔
  • 興趣相似目標對象或潛在買家區隔
  • 人生大事區隔
  • 詳細客層區隔
  • 自訂目標對象區隔 (CustomAudienceSegment)
• 年齡：AgeDimension
• 性別：GenderDimension
• 家庭收入：HouseholdIncomeDimension
• 家長狀態：ParentalStatusDimension

檢查 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 新增目標對象廣告群組條件，以指定目標對象或提供目標對象信號。您可以使用 AdGroupCriterion.audience 的 AudienceInfo 條件，在廣告群組層級指定目標對象，方法是將 AudienceInfo.audience 欄位 (ad_group_criterion.audience.audience) 設為目標對象資源名稱。

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

在AdGroup中啟用指定目標對象

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

這樣一來，您就能在目標對象中加入AdGroupCriterion。如果這個值未設為 true，後續指定目標對象的要求就會失敗。

建立 AdGroupCriterion

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

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

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

最佳做法

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

常見錯誤

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