- 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
用户名单细分。
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 |
受众群体位于特定素材资源组之下。 |