Recurso: DataSegment
Define un identificador para un segmento de inventario al que pueden segmentar los selectores o los planificadores de medios en la IU de acuerdos o paquetes de subasta. La selección del inventario la realizan los selectores en plataformas externas. -- ID siguiente: 9 --
| Representación JSON |
|---|
{ "name": string, "createTime": string, "updateTime": string, "state": enum ( |
| Campos | |
|---|---|
name |
Inmutable. Es el identificador. Es el identificador único del segmento de datos. El ID de cuenta corresponde al ID de la cuenta que creó el segmento. Formato: |
createTime |
Solo salida. Es la hora en la que se creó el segmento de datos. Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
updateTime |
Solo salida. Es la hora en la que se actualizó el segmento de datos por última vez. Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
state |
Solo salida. Es el estado del segmento de datos. |
| Se cobrará una tarifa cuando otras cuentas usen este segmento de datos. Por ejemplo, cuando otras cuentas agregan este segmento de datos a un acuerdo o paquete de subasta. Una vez establecido, no se puede cambiar el tipo de tarifa del segmento de datos. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta: | |
cpmFee |
Opcional. Es una tarifa fija que se cobra por cada mil impresiones. Una vez establecido, el código de moneda no se puede cambiar. |
millipercentOfMediaFee |
Opcional. La tarifa se cobrará como un porcentaje del costo de la impresión, representado en milésimas de porcentaje. Por ejemplo, el 1% se representa como 1000. |
| Fin de los campos mutuamente excluyentes. | |
userListId |
Opcional. Inmutable. Es el ID de la lista de usuarios que une este segmento de datos. Los selectores de contenido con una cuenta de socio de datos vinculada pueden crear un segmento de datos que incluya una lista de usuarios que pertenezca a la cuenta de socio de datos vinculada. Las listas de usuarios se pueden subir y administrar con la API de Data Manager. Vincular una lista de usuarios a un segmento de datos te permite definir un segmento de inventario que se base en un público que crees. |
Estado
Solo salida. Usa los métodos activate y deactivate para cambiar el estado.
| Enums | |
|---|---|
STATE_UNSPECIFIED |
Valor predeterminado |
ACTIVE |
El segmento de datos está activo. |
INACTIVE |
El segmento de datos está inactivo. |
SUSPENDED |
El segmento de datos está suspendido y no se puede activar. |
Métodos |
|
|---|---|
|
Activa un segmento de datos. |
|
Crea un segmento de datos que pertenece al administrador de datos indicado. |
|
Desactiva un segmento de datos. |
|
Obtiene un segmento de datos según su nombre. |
|
Enumera los segmentos de datos que pertenecen a un selector. |
|
Actualiza un segmento de datos. |