REST Resource: customBiddingAlgorithms

Risorsa: CustomBiddingAlgorithm

Un unico algoritmo di offerte personalizzate.

Rappresentazione JSON
{
  "name": string,
  "customBiddingAlgorithmId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "customBiddingAlgorithmType": enum (CustomBiddingAlgorithmType),
  "sharedAdvertiserIds": [
    string
  ],
  "modelDetails": [
    {
      object (CustomBiddingModelDetails)
    }
  ],

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

string

Solo output. Il nome della risorsa dell'algoritmo delle offerte personalizzate.

customBiddingAlgorithmId

string (int64 format)

Solo output. L'ID univoco dell'algoritmo delle offerte personalizzate. Assegnato dal sistema.

displayName

string

Obbligatorio. Il nome visualizzato dell'algoritmo delle offerte personalizzate.

Deve essere codificata in UTF-8 con una dimensione massima di 240 byte.

entityStatus

enum (EntityStatus)

Controlla se l'algoritmo delle offerte personalizzate può essere utilizzato o meno come strategia di offerta.

I valori accettati sono:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
customBiddingAlgorithmType

enum (CustomBiddingAlgorithmType)

Obbligatorio. Immutabile. Il tipo di algoritmo delle offerte personalizzate.

sharedAdvertiserIds[]

string (int64 format)

Gli ID degli inserzionisti che hanno accesso a questo algoritmo. Se advertiserId è impostato, questo campo sarà composto solo da quel valore.

Questo campo non verrà impostato se l'algoritmo owner è un partner e viene recuperato utilizzando un inserzionista accessor.

modelDetails[]

object (CustomBiddingModelDetails)

Solo output. I dettagli dei modelli di offerte personalizzate per ogni inserzionista che ha accesso.

Questo campo può includere i dettagli dell'inserzionista per cui è stata eseguita la query solo se l'algoritmo owner è un partner e viene recuperato utilizzando un inserzionista accessor.

Campo unione owner. Identifica l'entità DV360 proprietaria dell'algoritmo delle offerte personalizzate. Può essere un partner o un inserzionista. owner può essere solo uno dei seguenti:
partnerId

string (int64 format)

Immutabile. L'ID univoco del partner proprietario dell'algoritmo delle offerte personalizzate.

advertiserId

string (int64 format)

Immutabile. L'ID univoco dell'inserzionista proprietario dell'algoritmo delle offerte personalizzate.

CustomBiddingAlgorithmType

Possibili tipi di algoritmi di offerte personalizzate.

Enum
CUSTOM_BIDDING_ALGORITHM_TYPE_UNSPECIFIED Il tipo di algoritmo non è specificato o è sconosciuto in questa versione.
SCRIPT_BASED Algoritmo generato tramite i file di script delle offerte personalizzate caricati dal cliente.
ADS_DATA_HUB_BASED Algoritmo creato tramite il prodotto Ads Data Hub.
GOAL_BUILDER_BASED Algoritmo creato tramite il Generatore di obiettivi nell'interfaccia utente di DV3.

CustomBiddingModelDetails

I dettagli di un modello basato su un algoritmo delle offerte personalizzate per un singolo inserzionista condiviso.

Rappresentazione JSON
{
  "advertiserId": string,
  "readinessState": enum (ReadinessState),
  "suspensionState": enum (SuspensionState)
}
Campi
advertiserId

string (int64 format)

L'ID univoco dell'inserzionista pertinente.

readinessState

enum (ReadinessState)

Lo stato di idoneità del modello di offerte personalizzate.

suspensionState

enum (SuspensionState)

Solo output. Lo stato di sospensione del modello di offerte personalizzate.

ReadinessState

Possibili stati di idoneità del modello.

Enum
READINESS_STATE_UNSPECIFIED Stato non specificato o sconosciuto in questa versione.
READINESS_STATE_ACTIVE Il modello è addestrato e pronto per la pubblicazione.
READINESS_STATE_INSUFFICIENT_DATA Dati insufficienti per addestrare il modello di pubblicazione.
READINESS_STATE_TRAINING Il modello è in fase di addestramento e non è pronto per la pubblicazione.
READINESS_STATE_NO_VALID_SCRIPT Non è stato fornito uno script di offerte personalizzate valido con cui addestrare il modello. Questo stato verrà applicato solo agli algoritmi il cui customBiddingAlgorithmType è SCRIPT_BASED.

SuspensionState

Possibili stati di sospensione dei modelli di offerte personalizzate.

Enum
SUSPENSION_STATE_UNSPECIFIED Stato non specificato o sconosciuto in questa versione.
SUSPENSION_STATE_ENABLED Il modello è abilitato, utilizzato di recente, attualmente in uso o programmato per essere utilizzato. L'algoritmo assegna attivamente un punteggio alle impressioni per questo inserzionista.
SUSPENSION_STATE_DORMANT Il modello non è stato utilizzato di recente. Sebbene il modello continui a funzionare come ENABLED, se non viene utilizzato verrà sospeso.
SUSPENSION_STATE_SUSPENDED Il modello è sospeso dall'assegnazione del punteggio alle impressioni e non può essere pubblicato. Se l'algoritmo viene assegnato a un elemento pubblicitario di questo inserzionista o aggiornato in altro modo, tornerà allo stato ENABLED e richiederà del tempo per preparare nuovamente il modello di pubblicazione.

Metodi

create

Crea un nuovo algoritmo delle offerte personalizzate.

get

Ottiene un algoritmo di offerte personalizzate.

list

Elenca gli algoritmi di offerte personalizzate accessibili all'utente corrente e utilizzabili nelle strategie di offerta.

patch

Consente di aggiornare un algoritmo delle offerte personalizzate esistente.

uploadScript

Crea un oggetto di riferimento per lo script di offerte personalizzate per un file di script.