资源:DataSegment
为一段广告资源定义一个标识符,以便甄选方或媒体规划人员在交易或竞价包界面中进行定位。广告资源精选由精选方在外部平台上完成。-- Next ID: 9 --
| JSON 表示法 |
|---|
{ "name": string, "createTime": string, "updateTime": string, "state": enum ( |
| 字段 | |
|---|---|
name |
不可变。标识符。数据细分受众群的唯一标识符。账号 ID 对应于创建细分受众群的账号 ID。格式: |
createTime |
仅限输出。数据细分受众群的创建时间。 采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例: |
updateTime |
仅限输出。数据细分受众群的上次更新时间。 采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例: |
state |
仅限输出。数据细分受众群的状态。 |
| 当其他账号使用此数据细分受众群时,系统会收取费用。例如,当其他账号将此基于数据的细分受众群添加到交易或竞价包时。基于数据的细分受众群的费用类型一经设置便无法更改。以下是互斥字段的列表。在响应中,最多只能设置以下字段之一: | |
cpmFee |
可选。按每千次展示收取的固定费用。货币代码一经设置便无法更改。 |
millipercentOfMediaFee |
可选。该费用将按展示费用的百分比收取,以千分之一百分比表示。例如,1% 表示为 1000。 |
| 互斥字段结束。 | |
userListId |
可选。不可变。此数据细分受众群封装的用户名单的 ID。 拥有关联的数据合作伙伴账号的精选商可以创建数据细分受众群,其中包含关联的数据合作伙伴账号所拥有的用户名单。您可以使用 Data Manager API 上传和管理用户名单。将用户名单与数据细分受众群相关联后,您就可以根据自己创建的受众群体来定义细分广告资源。 |
州
仅限输出。使用 activate 和 deactivate 方法更改状态。
| 枚举 | |
|---|---|
STATE_UNSPECIFIED |
默认值。 |
ACTIVE |
基于数据的细分受众群处于启用状态。 |
INACTIVE |
基于数据的细分受众群未启用。 |
SUSPENDED |
该数据细分受众群已被暂停,无法启用。 |
方法 |
|
|---|---|
|
激活数据细分。 |
|
创建由所列管理者拥有的基于数据的细分受众群。 |
|
停用基于数据的细分受众群。 |
|
获取指定名称的数据细分。 |
|
列出甄选方拥有的基于数据的细分受众群。 |
|
更新数据细分受众群。 |