REST Resource: customBiddingAlgorithms

Recurso: CustomBiddingAlgorithm

Es un solo algoritmo de ofertas personalizadas.

Representación JSON 
{
  "name": string,
  "customBiddingAlgorithmId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "customBiddingAlgorithmType": enum (CustomBiddingAlgorithmType),
  "sharedAdvertiserIds": [
    string
  ],
  "modelDetails": [
    {
      object (CustomBiddingModelDetails)
    }
  ],
  "thirdPartyOptimizationPartner": enum (ThirdPartyOptimizationPartnerType),

  // Union field owner can be only one of the following:
  "partnerId": string,
  "advertiserId": string
  // End of list of possible types for union field owner.
}
Campos
name

string

Solo salida. Es el nombre del recurso del algoritmo de ofertas personalizadas.
customBiddingAlgorithmId

string (int64 format)

Solo salida. Es el ID único del algoritmo de ofertas personalizadas. El sistema lo asigna.
displayName

string

Es obligatorio. Es el nombre visible del algoritmo de ofertas personalizadas.

Debe estar codificado en UTF-8 con un tamaño máximo de 240 bytes.
entityStatus

enum (EntityStatus)

Controla si el algoritmo de ofertas personalizadas se puede usar como estrategia de ofertas.

Valores aceptados:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
customBiddingAlgorithmType

enum (CustomBiddingAlgorithmType)

Es obligatorio. Inmutable. Es el tipo de algoritmo de ofertas personalizadas.
sharedAdvertiserIds[]

string (int64 format)

Son los IDs de los anunciantes que tienen acceso a este algoritmo. Si se establece advertiserId, este campo solo contendrá ese valor.

Este campo no se establecerá si el algoritmo owner es un socio y se recupera con un anunciante accessor.
modelDetails[]

object (CustomBiddingModelDetails)

Solo salida. Son los detalles de los modelos de ofertas personalizadas para cada anunciante que tiene acceso.

Este campo solo puede incluir los detalles del anunciante consultado si el algoritmo owner es un socio y se recupera con un anunciante accessor.
thirdPartyOptimizationPartner

enum (ThirdPartyOptimizationPartnerType)

Opcional. Inmutable. Designa al socio de optimización externo que administra este algoritmo.
Campo de unión owner. Identifica la entidad de DV360 que posee el algoritmo de ofertas personalizadas. Puede ser un socio o un anunciante. Las direcciones (owner) solo pueden ser una de las siguientes opciones:
partnerId

string (int64 format)

Inmutable. Es el ID único del socio propietario del algoritmo de ofertas personalizadas.
advertiserId

string (int64 format)

Inmutable. Es el ID único del anunciante propietario del algoritmo de ofertas personalizadas.

CustomBiddingAlgorithmType

Son los tipos posibles de algoritmos de ofertas personalizadas.

Enumeraciones
CUSTOM_BIDDING_ALGORITHM_TYPE_UNSPECIFIED El tipo de algoritmo no se especificó o es desconocido en esta versión.
SCRIPT_BASED Es un algoritmo que se genera a través de archivos de secuencias de comandos de ofertas personalizadas que suben los clientes.
RULE_BASED

Algoritmo basado en reglas definidas. Estas reglas se definen en la API con el objeto AlgorithmRules.

Este tipo de algoritmo solo está disponible para los clientes incluidos en la lista de entidades permitidas. Los demás clientes que intenten usar este tipo recibirán un error.

CustomBiddingModelDetails

Son los detalles de un modelo de algoritmo de ofertas personalizadas para un solo anunciante compartido.

Representación JSON 
{
  "advertiserId": string,
  "readinessState": enum (ReadinessState),
  "suspensionState": enum (SuspensionState)
}
Campos
advertiserId

string (int64 format)

Es el ID único del anunciante pertinente.
readinessState

enum (ReadinessState)

Es el estado de preparación del modelo de ofertas personalizadas.
suspensionState

enum (SuspensionState)

Solo salida. Es el estado de suspensión del modelo de ofertas personalizadas.

ReadinessState

Son los estados posibles de preparación del modelo.

Enumeraciones
READINESS_STATE_UNSPECIFIED El estado no se especifica o se desconoce en esta versión.
READINESS_STATE_ACTIVE El modelo está entrenado y listo para la entrega.
READINESS_STATE_INSUFFICIENT_DATA No hay suficientes datos para entrenar el modelo de publicación.
READINESS_STATE_TRAINING El modelo se está entrenando y no está listo para la entrega.
READINESS_STATE_NO_VALID_SCRIPT No se proporcionó una secuencia de comandos de ofertas personalizadas válida para entrenar el modelo. Este estado solo se aplicará a los algoritmos cuyo customBiddingAlgorithmType sea SCRIPT_BASED.
READINESS_STATE_EVALUATION_FAILURE Se proporcionó un guion válido, pero no pasó la evaluación. Esto se aplica a las secuencias de comandos que no se pudieron evaluar en el tiempo asignado.

SuspensionState

Son los posibles estados de suspensión de los modelos de ofertas personalizadas.

Enumeraciones
SUSPENSION_STATE_UNSPECIFIED El estado no se especifica o se desconoce en esta versión.
SUSPENSION_STATE_ENABLED El modelo está habilitado, ya sea porque se usó recientemente, se está usando o se programó para usarse. El algoritmo está calificando activamente las impresiones para este anunciante.
SUSPENSION_STATE_DORMANT El modelo no se usó recientemente. Aunque el modelo sigue actuando como ENABLED, se suspenderá si no se usa.
SUSPENSION_STATE_SUSPENDED El modelo se suspendió para calificar las impresiones y no se puede publicar. Si el algoritmo se asigna a una línea de pedido de este anunciante o se actualiza de alguna otra manera, volverá al estado ENABLED y requerirá tiempo para preparar el modelo de publicación nuevamente.

ThirdPartyOptimizationPartnerType

Son los tipos posibles de socios de optimización externos.

Enumeraciones
UNKNOWN El valor del tipo no se especificó o es desconocido en esta versión.
SCIBIDS Es un proveedor externo de servicios de ciencia de datos con el que los socios o anunciantes de DV3 pueden asociarse.
ADELAIDE Es un proveedor de servicios de medición de la atención externo con el que se pueden asociar los socios o anunciantes de DV3.

Métodos

create

 Crea un algoritmo de ofertas personalizadas nuevo.

get

 Obtiene un algoritmo de ofertas personalizadas.

list

 Enumera los algoritmos de ofertas personalizadas a los que puede acceder el usuario actual y que se pueden usar en las estrategias de ofertas.

patch

 Actualiza un algoritmo de ofertas personalizadas existente.

uploadRules

 Crea un objeto de referencia de reglas para un archivo AlgorithmRules.

uploadScript

 Crea un objeto de referencia de secuencia de comandos de ofertas personalizadas para un archivo de secuencia de comandos.