REST Resource: customBiddingAlgorithms

Recurso: CustomBiddingAlgorithm

Um único algoritmo de lances personalizados.

Representação JSON 
{
  "name": string,
  "customBiddingAlgorithmId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "customBiddingAlgorithmType": enum (CustomBiddingAlgorithmType),
  "sharedAdvertiserIds": [
    string
  ],
  "modelReadiness": [
    {
      object (CustomBiddingModelReadinessState)
    }
  ],
  "customBiddingAlgorithmState": enum (State),

  // 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

Apenas saída. O nome do recurso do algoritmo de lances personalizados.
customBiddingAlgorithmId

string (int64 format)

Apenas saída. O ID exclusivo do algoritmo de lances personalizados. Atribuído pelo sistema.
displayName

string

Obrigatório. O nome de exibição do algoritmo de lances personalizados.

Precisa ser codificado em UTF-8 com um tamanho máximo de 240 bytes.
entityStatus

enum (EntityStatus)

Controla se o algoritmo de lances personalizados pode ou não ser usado como estratégia de lances.

Os valores aceitos são:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
customBiddingAlgorithmType

enum (CustomBiddingAlgorithmType)

Obrigatório. Imutável. O tipo de algoritmo de lances personalizados.
sharedAdvertiserIds[]

string (int64 format)

Os IDs dos anunciantes que têm acesso a este algoritmo. Se advertiserId estiver definido, esse campo consistirá apenas nesse valor.

Este campo não será definido se o algoritmo owner for um parceiro e estiver sendo recuperado usando um anunciante accessor.
modelReadiness[]

object (CustomBiddingModelReadinessState)

Apenas saída. O estado de prontidão do modelo de lances personalizados para cada anunciante que tem acesso.

Esse campo só poderá incluir o estado do anunciante consultado se o algoritmo owner for um parceiro e estiver sendo recuperado usando um anunciante accessor.
customBiddingAlgorithmState

enum (State)

Apenas saída. O status do algoritmo de lances personalizados.
Campo de união owner. Identifica a entidade do DV360 que é proprietária do algoritmo de lances personalizados. Pode ser um parceiro ou um anunciante. owner pode ser apenas de um dos tipos a seguir:
partnerId

string (int64 format)

Imutável. O ID exclusivo do parceiro que é proprietário do algoritmo de lances personalizados.
advertiserId

string (int64 format)

Imutável. O ID exclusivo do anunciante proprietário do algoritmo de lances personalizados.

CustomBiddingAlgorithmType

Tipos possíveis de algoritmos de lances personalizados.

Enums
CUSTOM_BIDDING_ALGORITHM_TYPE_UNSPECIFIED O tipo de algoritmo não foi especificado ou é desconhecido nesta versão.
SCRIPT_BASED Algoritmo gerado por arquivos de script de lances personalizados enviados pelo cliente.
ADS_DATA_HUB_BASED Algoritmo criado pelo Ads Data Hub.
GOAL_BUILDER_BASED Algoritmo criado por meio do Criador de metas na interface do DV3.

CustomBiddingModelReadinessState

O estado de prontidão do modelo do algoritmo de lances personalizados para um único anunciante compartilhado.

Representação JSON 
{
  "advertiserId": string,
  "readinessState": enum (ReadinessState)
}
Campos
advertiserId

string (int64 format)

O ID exclusivo do anunciante relevante.
readinessState

enum (ReadinessState)

O estado de prontidão do modelo de lances personalizados.

ReadinessState

Estados possíveis de prontidão do modelo.

Enums
READINESS_STATE_UNSPECIFIED O estado não é especificado ou é desconhecido nesta versão.
READINESS_STATE_ACTIVE O modelo está treinado e pronto para disponibilização.
READINESS_STATE_INSUFFICIENT_DATA Não há dados suficientes para treinar o modelo de exibição.
READINESS_STATE_TRAINING O modelo está em treinamento e não está pronto para disponibilização.
READINESS_STATE_NO_VALID_SCRIPT Não foi fornecido um script válido de lances personalizados para treinar o modelo. Esse estado só é aplicado a algoritmos cujo customBiddingAlgorithmType é SCRIPT_BASED.

Estado

Estados possíveis dos algoritmos de lances personalizados.

Enums
STATE_UNSPECIFIED O estado não é especificado ou é desconhecido nesta versão.
ENABLED O algoritmo está ativado, sendo usado recentemente, usado no momento ou programado para uso. O algoritmo está pontuando as impressões ativamente.
DORMANT O algoritmo não foi usado recentemente. Embora o algoritmo ainda atue como ENABLED, ele será suspenso se não for usado.
SUSPENDED O algoritmo usa a pontuação de impressões e não tem um modelo de veiculação treinado. Se o algoritmo for atribuído a um item de linha ou atualizado de alguma forma, ele voltará para o estado ENABLED e precisará de tempo para preparar o modelo de veiculação novamente.

Métodos

create

 Cria um novo algoritmo de lances personalizados.

get

 Recebe um algoritmo de lances personalizados.

list

 Lista algoritmos de lances personalizados acessíveis ao usuário atual e que podem ser usados em estratégias de lances.

patch

 Atualiza um algoritmo de lances personalizados existente.

uploadScript

 Cria um objeto de referência do script de lances personalizados para um arquivo de script.