- JSON 表示法
- AudienceStatus
- AudienceDimension
- AgeDimension
- AgeSegment
- GenderDimension
- HouseholdIncomeDimension
- ParentalStatusDimension
- AudienceSegmentDimension
- AudienceSegment
- UserListSegment
- UserInterestSegment
- LifeEventSegment
- DetailedDemographicSegment
- CustomAudienceSegment
- AudienceExclusionDimension
- ExclusionSegment
- AudienceScope
“受众群体”是一个有效的定位选项,可让您使用各种不同的细分受众群属性(例如详细受众特征和兴趣相似的受众群体),以创建代表目标细分受众群各个部分的受众群体。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "status": enum ( |
字段 | |
---|---|
resourceName |
不可变。受众群体的资源名称。受众群体名称的格式如下:
|
id |
仅供输出。受众群体的 ID。 |
status |
仅供输出。此受众群体的状态。指明相应受众群体是已启用还是已移除。 |
description |
此受众群体的说明。 |
dimensions[] |
指定受众群体构成的正维度。 |
exclusionDimension |
指定受众群体构成的负维度。 |
scope |
定义此受众群体可以使用的范围。默认情况下,范围为 CUSTOMER。可以创建范围为 ASSET_GROUP 的受众群体,供单个 assetGroup 使用。范围可以从“ASSET_GROUP”更改为“CUSTOMER”,但不能从“CUSTOMER”更改为“ASSET_GROUP”。 |
assetGroup |
不可变。此受众群体所属的素材资源组。当且仅当范围为 ASSET_GROUP 时,才必须设置此字段。创建后不可变。如果范围为 ASSET_GROUP 的受众群体升级为 CUSTOMER 范围,则此字段将自动清除。 |
name |
受众群体的名称。该名称在帐号内的所有受众群体中应该是唯一的。长度下限必须为 1,长度上限为 255。如果范围未设置或设为 CUSTOMER,则必须提供此值。当范围为“ASSET_GROUP”时,无法设置或更新范围。 |
AudienceStatus
包含可能的受众群体状态类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
ENABLED |
“已启用”状态 - 受众群体已启用,可以进行定位。 |
REMOVED |
“已移除”状态 - 受众群体已被移除,无法用于定位。 |
AudienceDimension
指定用户受众群体的正维度。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 dimension 。指定属于受众群体的用户的维度。dimension 只能是下列其中一项: |
|
age |
按年龄指定用户的维度。 |
gender |
按性别指定用户的维度。 |
householdIncome |
按家庭收入指定用户的维度。 |
parentalStatus |
按生育情况指定用户的维度。 |
audienceSegments |
按用户在其他细分受众群中的成员资格指定用户的维度。 |
AgeDimension
按年龄指定用户的维度。
JSON 表示法 |
---|
{
"ageRanges": [
{
object ( |
字段 | |
---|---|
ageRanges[] |
要在维度中包含的连续年龄段。 |
includeUndetermined |
包含尚未确定年龄的用户。 |
AgeSegment
连续的年龄段。
JSON 表示法 |
---|
{ "minAge": integer, "maxAge": integer } |
字段 | |
---|---|
minAge |
可包含的最低年龄。必须指定最低年龄,且必须至少为 18 岁。允许的值包括 18、25、35、45、55 和 65。 |
maxAge |
要包含的年龄上限。无需指定最长存在时间。如果指定,maxAge 必须大于 minAge,允许的值包括 24、34、44、54 和 64。 |
GenderDimension
按性别指定用户的维度。
JSON 表示法 |
---|
{
"genders": [
enum ( |
字段 | |
---|---|
genders[] |
包含的性别受众特征细分受众群。 |
includeUndetermined |
包含性别未确定的用户。 |
HouseholdIncomeDimension
按家庭收入指定用户的维度。
JSON 表示法 |
---|
{
"incomeRanges": [
enum ( |
字段 | |
---|---|
incomeRanges[] |
包含的家庭收入受众特征细分受众群。 |
includeUndetermined |
包含未确定家庭收入的用户。 |
ParentalStatusDimension
按生育情况指定用户的维度。
JSON 表示法 |
---|
{
"parentalStatuses": [
enum ( |
字段 | |
---|---|
parentalStatuses[] |
已包含生育情况受众特征细分受众群。 |
includeUndetermined |
包含育儿状况未确定的用户。 |
AudienceSegmentDimension
按用户在其他细分受众群中的成员资格指定用户的维度。
JSON 表示法 |
---|
{
"segments": [
{
object ( |
字段 | |
---|---|
segments[] |
包含的细分受众群。如果用户属于至少一个细分,就会将其包含在内。 |
AudienceSegment
肯定的细分受众群。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 segment 。肯定细分受众群。segment 只能是下列其中一项: |
|
userList |
用户名单细分。 |
userInterest |
兴趣相似的细分受众群或有购买意向的细分受众群。 |
lifeEvent |
直播活动细分受众群。 |
detailedDemographic |
符合某种详细受众特征的细分受众群。 |
customAudience |
自定义细分受众群。 |
UserListSegment
用户名单细分。类似受众群体将于 2023 年 5 月停用。有关其他选项,请参阅 https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html。
JSON 表示法 |
---|
{ "userList": string } |
字段 | |
---|---|
userList |
用户列表资源。 |
UserInterestSegment
用户兴趣细分。
JSON 表示法 |
---|
{ "userInterestCategory": string } |
字段 | |
---|---|
userInterestCategory |
用户兴趣资源。 |
LifeEventSegment
直播活动片段。
JSON 表示法 |
---|
{ "lifeEvent": string } |
字段 | |
---|---|
lifeEvent |
人生大事资源。 |
DetailedDemographicSegment
符合某种详细受众特征的细分受众群。
JSON 表示法 |
---|
{ "detailedDemographic": string } |
字段 | |
---|---|
detailedDemographic |
详细受众特征资源。 |
CustomAudienceSegment
自定义细分受众群。
JSON 表示法 |
---|
{ "customAudience": string } |
字段 | |
---|---|
customAudience |
自定义受众群体资源。 |
AudienceExclusionDimension
用于指定要从受众群体中排除的用户的否定维度。
JSON 表示法 |
---|
{
"exclusions": [
{
object ( |
字段 | |
---|---|
exclusions[] |
要排除的细分受众群。 |
ExclusionSegment
要从受众群体中排除的细分受众群。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 segment 。要排除的细分受众群。segment 只能是下列其中一项: |
|
userList |
要排除的用户名单细分。 |
AudienceScope
包含可能的受众群体范围值的枚举。
枚举 | |
---|---|
UNSPECIFIED |
尚未指定范围。 |
UNKNOWN |
此版本中未知接收的值。 |
CUSTOMER |
此受众群体的范围限定在客户级别。 |
ASSET_GROUP |
此受众群体的范围限定为特定 AssetGroup。 |