Audience

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

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

string

無法變更。目標對象的資源名稱。目標對象名稱格式如下：

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

string (int64 format)

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

enum (AudienceStatus)

僅供輸出。此目標對象的狀態。表示目標對像已啟用還是已移除。
name

string

必要欄位。目標對象的名稱。所有目標對象的名稱不得重複。長度下限為 1，長度上限為 255 個字元。
description

string

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

object (AudienceDimension)

指定目標對象組成資料的正值維度。
exclusionDimension

object (AudienceExclusionDimension)

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

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)

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