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。