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)

要排除的用户名单细分。