REST Resource: curators.dataSegments

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 (State),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "cpmFee": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
  "userListId": string
}
Campos
name

string

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: curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}

createTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

state

enum (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

object (Money)

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

string (int64 format)

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

string

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

activate

Activa un segmento de datos.

create

Crea un segmento de datos que pertenece al administrador de datos indicado.

deactivate

Desactiva un segmento de datos.

get

Obtiene un segmento de datos según su nombre.

list

Enumera los segmentos de datos que pertenecen a un selector.

patch

Actualiza un segmento de datos.