- Recurso: Custom BiddingAlgorithm
- CustomBiddingAlgorithmType
- CustomBiddingModelDetails
- ReadinessState
- SuspensionState
- Métodos
Recurso: CustomLancesAlgorithm
Um único algoritmo de lances personalizados.
Representação JSON |
---|
{ "name": string, "customBiddingAlgorithmId": string, "displayName": string, "entityStatus": enum ( |
Campos | |
---|---|
name |
Apenas saída. O nome do recurso do algoritmo de lances personalizados. |
customBiddingAlgorithmId |
Apenas saída. O ID exclusivo do algoritmo de lances personalizados. Atribuído pelo sistema. |
displayName |
Obrigatório. O nome de exibição do algoritmo de lances personalizados. Precisa ser codificado em UTF-8 com tamanho máximo de 240 bytes. |
entityStatus |
Controla se o algoritmo de lances personalizados pode ou não ser usado como estratégia de lances. Os valores aceitos são:
|
customBiddingAlgorithmType |
Obrigatório. Imutável. É o tipo de algoritmo de lances personalizados. |
sharedAdvertiserIds[] |
Os IDs dos anunciantes que têm acesso a esse algoritmo. Se Este campo não será definido se o algoritmo |
modelDetails[] |
Apenas saída. Os detalhes dos modelos de lances personalizados de cada anunciante com acesso. Esse campo só vai incluir os detalhes do anunciante consultado se o algoritmo |
Campo de união owner . Identifica a entidade do DV360 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 |
Imutável. O ID exclusivo do parceiro proprietário do algoritmo de lances personalizados. |
advertiserId |
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 usando arquivos de script de lances personalizados enviados pelo cliente. |
ADS_DATA_HUB_BASED |
Algoritmo criado com o produto do Ads Data Hub. |
GOAL_BUILDER_BASED |
Algoritmo criado com o Criador de metas na interface do DV3. |
CustomBiddingModelDetails
Os detalhes de um modelo de algoritmo de lances personalizados para um único anunciante compartilhado.
Representação JSON |
---|
{ "advertiserId": string, "readinessState": enum ( |
Campos | |
---|---|
advertiserId |
O ID exclusivo do anunciante relevante. |
readinessState |
O estado de prontidão do modelo de lances personalizados. |
suspensionState |
Apenas saída. O estado de suspensão do modelo de lances personalizados. |
ReadinessState
Possíveis estados de prontidão do modelo.
Enums | |
---|---|
READINESS_STATE_UNSPECIFIED |
O estado não foi especificado ou é desconhecido nesta versão. |
READINESS_STATE_ACTIVE |
O modelo está treinado e pronto para exibiçã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 ser exibido. |
READINESS_STATE_NO_VALID_SCRIPT |
Não foi fornecido um script de lances personalizados válido para treinar o modelo. Esse estado só vai ser aplicado a algoritmos em que a seja SCRIPT_BASED . |
SuspensionState
Possíveis estados de suspensão dos modelos de lances personalizados.
Enums | |
---|---|
SUSPENSION_STATE_UNSPECIFIED |
O estado não foi especificado ou é desconhecido nesta versão. |
SUSPENSION_STATE_ENABLED |
O modelo está ativado, seja usado recentemente, usado no momento ou programado para uso. O algoritmo está pontuando ativamente as impressões desse anunciante. |
SUSPENSION_STATE_DORMANT |
O modelo não foi usado recentemente. Embora o modelo ainda atue como ENABLED , ele será suspenso se não for usado. |
SUSPENSION_STATE_SUSPENDED |
O modelo foi suspenso da pontuação de impressões e não pode ser veiculado. Se o algoritmo for atribuído a um item de linha nesse anunciante ou for atualizado de outra forma, ele voltará ao estado ENABLED e exigirá tempo para preparar o modelo de veiculação novamente. |
Métodos |
|
---|---|
|
Cria um novo algoritmo de lances personalizados. |
|
Recebe um algoritmo de lances personalizados. |
|
Lista algoritmos de lances personalizados que podem ser acessados pelo usuário atual e usados em estratégias de lances. |
|
Atualiza um algoritmo de lances personalizados atual. |
|
Cria um objeto de referência de script de lances personalizados para um arquivo de script. |