Audience

目標對像是有效的指定目標選項，可讓您針對不同的區隔屬性 (例如詳細客層和興趣相似目標對象)，建立代表目標區隔部分的目標對象。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "status": enum (AudienceStatus),
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  },
  "scope": enum (AudienceScope),
  "assetGroup": string,
  "name": string
}
欄位
resourceName

string

不可變動。目標對象的資源名稱。目標對象名稱的格式如下：

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

僅供輸出。目標對象的 ID。
status

enum (AudienceStatus)

僅供輸出。這個目標對象的狀態，指出目標對像是否已啟用或已移除。
description

string

此目標對象的說明。
dimensions[]

object (AudienceDimension)

表示目標對象組成的正維度。
exclusionDimension

object (AudienceExclusionDimension)

指定目標對象組成的排除維度。
scope

enum (AudienceScope)

定義這個目標對象的適用範圍。預設的範圍是 CUSTOMER。可以使用 ASSET_GROUP 的範圍建立目標對象，供單一 AssetGroup 使用。範圍可以從 ASSET_GROUP 變更為 CUSTOMER，而不是從 CUSTOMER 變更為 ASSET_GROUP。
assetGroup

string

不可變動。這個目標對象位於哪個素材資源群組。只有在範圍為 ASSET_GROUP 時，才必須設定。建立後即無法變更。如果設為「ASSET_GROUP」範圍的目標對像升級為「CUSTOMER」範圍，系統會自動清除這個欄位。
name

string

目標對象的名稱。帳戶中的所有目標對象皆不得重複。長度下限為 1，長度上限是 255。如果範圍未設定或設為 CUSTOMER，就必須填寫此欄位。如果範圍為「ASSET_GROUP」，就無法設定或更新。

AudienceStatus

列舉包括可能的目標對象狀態類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
ENABLED 已啟用狀態 - 目標對像已啟用，可以指定。
REMOVED 已移除狀態 - 目標對像已移除，因此無法用於指定目標。

AudienceDimension

指定使用者目標對象的正面維度。

JSON 表示法 
{

  // Union field dimension can be only one of the following:
  "age": {
    object (AgeDimension)
  },
  "gender": {
    object (GenderDimension)
  },
  "householdIncome": {
    object (HouseholdIncomeDimension)
  },
  "parentalStatus": {
    object (ParentalStatusDimension)
  },
  "audienceSegments": {
    object (AudienceSegmentDimension)
  }
  // End of list of possible types for union field dimension.
}
欄位
聯集欄位 dimension。指定屬於目標對象使用者的維度。dimension 只能是下列其中一項：
age

object (AgeDimension)

按年齡指定使用者的維度。
gender

object (GenderDimension)

按性別指定使用者的維度。
householdIncome

object (HouseholdIncomeDimension)

按家庭收入指定使用者的維度。
parentalStatus

object (ParentalStatusDimension)

按家長狀態指定使用者的維度。
audienceSegments

object (AudienceSegmentDimension)

根據使用者在其他目標對象區隔中的成員資格來指定使用者的維度。

AgeDimension

按年齡指定使用者的維度。

JSON 表示法 
{
  "ageRanges": [
    {
      object (AgeSegment)
    }
  ],
  "includeUndetermined": boolean
}
欄位
ageRanges[]

object (AgeSegment)

要納入維度的連續年齡層。
includeUndetermined

boolean

納入年齡無法判斷的使用者。

AgeSegment

連續的年齡層。

JSON 表示法 
{
  "minAge": integer,
  "maxAge": integer
}
欄位
minAge

integer

要納入的最低年齡。必須指定年齡下限，且年滿 18 歲。允許的值為 18、25、35、45、55 和 65。
maxAge

integer

可納入的年齡上限。不需指定存在時間上限。如有指定，maxAge 必須大於 minAge，允許的值為 24、34、44、54 和 64。

GenderDimension

按性別指定使用者的維度。

JSON 表示法 
{
  "genders": [
    enum (GenderType)
  ],
  "includeUndetermined": boolean
}
欄位
genders[]

enum (GenderType)

納入性別客層區隔。
includeUndetermined

boolean

納入性別無法判斷的使用者。

HouseholdIncomeDimension

按家庭收入指定使用者的維度。

JSON 表示法 
{
  "incomeRanges": [
    enum (IncomeRangeType)
  ],
  "includeUndetermined": boolean
}
欄位
incomeRanges[]

enum (IncomeRangeType)

納入家庭收入客層區隔。
includeUndetermined

boolean

納入家庭收入無法確定的使用者。

ParentalStatusDimension

按家長狀態指定使用者的維度。

JSON 表示法 
{
  "parentalStatuses": [
    enum (ParentalStatusType)
  ],
  "includeUndetermined": boolean
}
欄位
parentalStatuses[]

enum (ParentalStatusType)

已納入家長狀態客層區隔。
includeUndetermined

boolean

納入家長狀態不明的使用者。

AudienceSegmentDimension

根據使用者在其他目標對象區隔中的成員資格來指定使用者的維度。

JSON 表示法 
{
  "segments": [
    {
      object (AudienceSegment)
    }
  ]
}
欄位
segments[]

object (AudienceSegment)

納入的目標對象區隔。系統會納入屬於至少一個區隔的使用者。

AudienceSegment

正面目標對象區隔。

JSON 表示法 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  },
  "userInterest": {
    object (UserInterestSegment)
  },
  "lifeEvent": {
    object (LifeEventSegment)
  },
  "detailedDemographic": {
    object (DetailedDemographicSegment)
  },
  "customAudience": {
    object (CustomAudienceSegment)
  }
  // End of list of possible types for union field segment.
}
欄位
聯集欄位 segment。正面區隔。segment 只能是下列其中一項：
userList

object (UserListSegment)

使用者名單區隔。
userInterest

object (UserInterestSegment)

興趣相似目標對像或潛在買家區隔。
lifeEvent

object (LifeEventSegment)

直播活動目標對象區隔。
detailedDemographic

object (DetailedDemographicSegment)

詳細客層區隔。
customAudience

object (CustomAudienceSegment)

自訂目標對象區隔。

UserListSegment

使用者名單區隔。類似目標對像功能將於 2023 年 5 月停用。如要瞭解其他選項，請參閱 https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html。

JSON 表示法 
{
  "userList": string
}
欄位
userList

string

使用者名單資源。

UserInterestSegment

使用者興趣區隔。

JSON 表示法 
{
  "userInterestCategory": string
}
欄位
userInterestCategory

string

使用者興趣資源。

LifeEventSegment

現場活動區隔。

JSON 表示法 
{
  "lifeEvent": string
}
欄位
lifeEvent

string

人生大事資源。

DetailedDemographicSegment

詳細客層區隔。

JSON 表示法 
{
  "detailedDemographic": string
}
欄位
detailedDemographic

string

詳細客層資源。

CustomAudienceSegment

自訂目標對象區隔。

JSON 表示法 
{
  "customAudience": string
}
欄位
customAudience

string

自訂目標對象資源。

AudienceExclusionDimension

指定排除維度，指定要從目標對像中排除的使用者。

JSON 表示法 
{
  "exclusions": [
    {
      object (ExclusionSegment)
    }
  ]
}
欄位
exclusions[]

object (ExclusionSegment)

要排除的目標對象區隔。

ExclusionSegment

要從目標對像中排除的目標對象區隔。

JSON 表示法 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  }
  // End of list of possible types for union field segment.
}
欄位
聯集欄位 segment。要排除的區隔。segment 只能是下列其中一項：
userList

object (UserListSegment)

要排除的使用者名單區隔。

AudienceScope

列舉包含可能的目標對象範圍值。

列舉
UNSPECIFIED 尚未指定範圍。
UNKNOWN 這個版本無法得知接收到的值。
CUSTOMER 這個目標對像是在客戶層級設定。
ASSET_GROUP 目標對象範圍限定在特定 AssetGroup 底下。