Recurso: DataSegment
Define um identificador para um segmento de inventário que pode ser segmentado por curadores ou planejadores de mídia na interface de transações ou pacotes de leilão. A curadoria do inventário é feita por curadores em plataformas externas. -- Next ID: 9 --
| Representação JSON |
|---|
{ "name": string, "createTime": string, "updateTime": string, "state": enum ( |
| Campos | |
|---|---|
name |
Imutável. Identificador. O identificador exclusivo do segmento de dados. O ID da conta corresponde ao ID da conta que criou o segmento. Formato: |
createTime |
Apenas saída. Hora em que o segmento de dados foi criado. Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: |
updateTime |
Apenas saída. Hora em que o segmento de dados foi atualizado pela última vez. Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: |
state |
Apenas saída. O estado do segmento de dados. |
| A taxa será cobrada quando outras contas usarem esse segmento de dados. Por exemplo, quando outras contas adicionam esse segmento de dados a uma transação ou um pacote de leilão. Não é possível mudar o tipo de taxa do segmento de dados depois que ele é definido. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta: | |
cpmFee |
Opcional. Uma taxa fixa cobrada por mil impressões. Depois de definido, o código da moeda não pode ser alterado. |
millipercentOfMediaFee |
Opcional. A taxa será cobrada como uma porcentagem do custo de impressão, representada em milésimos de porcentagem. Por exemplo, 1% é representado como 1000. |
| Fim dos campos mutuamente exclusivos. | |
userListId |
Opcional. Imutável. O ID da lista de usuários incluída neste segmento de dados. Os curadores com uma conta de parceiro de dados vinculada podem criar um segmento de dados que envolve uma lista de usuários de propriedade da conta de parceiro de dados vinculada. É possível fazer upload e gerenciar listas de usuários usando a API Data Manager. Ao vincular uma lista de usuários a um segmento de dados, você pode definir um segmento de inventário com base em um público-alvo que você criar. |
Estado
Apenas saída. Use os métodos de ativação e desativação para mudar o estado.
| Tipos enumerados | |
|---|---|
STATE_UNSPECIFIED |
Valor padrão. |
ACTIVE |
O segmento de dados está ativo. |
INACTIVE |
O segmento de dados está inativo. |
SUSPENDED |
O segmento de dados está suspenso e não pode ser ativado. |
Métodos |
|
|---|---|
|
Ativa um segmento de dados. |
|
Cria um segmento de dados de propriedade do curador listado. |
|
Desativa um segmento de dados. |
|
Recebe um segmento de dados pelo nome. |
|
Lista os segmentos de dados que pertencem a um curador. |
|
Atualiza um segmento de dados. |