REST Resource: customBiddingAlgorithms

Ressource: CustomBiddingAlgorithm

Un seul algorithme d'enchères personnalisées.

Représentation 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.
}
Champs
name

string

Uniquement en sortie. Nom de ressource de l'algorithme d'enchères personnalisées.
customBiddingAlgorithmId

string (int64 format)

Uniquement en sortie. ID unique de l'algorithme d'enchères personnalisées. Attribué par le système.
displayName

string

Obligatoire. Nom à afficher de l'algorithme d'enchères personnalisées.

Doit être encodé au format UTF-8 avec une taille maximale de 240 octets.
entityStatus

enum (EntityStatus)

Détermine si l'algorithme d'enchères personnalisées peut être utilisé ou non en tant que stratégie d'enchères.

Les valeurs acceptées sont les suivantes :

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
customBiddingAlgorithmType

enum (CustomBiddingAlgorithmType)

Obligatoire. Immuable. Type d'algorithme d'enchères personnalisées.
sharedAdvertiserIds[]

string (int64 format)

Identifiants des annonceurs qui ont accès à cet algorithme. Si advertiserId est défini, ce champ ne contiendra que cette valeur.

Ce champ ne sera pas défini si l'algorithme owner est un partenaire et qu'il est récupéré à l'aide d'un annonceur accessor.
modelReadiness[]

object (CustomBiddingModelReadinessState)

Uniquement en sortie. État de préparation du modèle d'enchères personnalisées pour chaque annonceur y ayant accès.

Ce champ ne peut inclure l'état de l'annonceur interrogé que si l'algorithme owner est un partenaire et qu'il est récupéré à l'aide d'un annonceur accessor.
customBiddingAlgorithmState

enum (State)

Uniquement en sortie. État de l'algorithme d'enchères personnalisées.
Champ d'union owner. Identifie l'entité DV360 qui possède l'algorithme d'enchères personnalisées. Il peut s'agir d'un partenaire ou d'un annonceur. owner ne peut être qu'un des éléments suivants :
partnerId

string (int64 format)

Immuable. ID unique du partenaire auquel appartient l'algorithme d'enchères personnalisées.
advertiserId

string (int64 format)

Immuable. ID unique de l'annonceur auquel appartient l'algorithme d'enchères personnalisées.

CustomBiddingAlgorithmType

Types possibles d'algorithmes d'enchères personnalisées.

Enums
CUSTOM_BIDDING_ALGORITHM_TYPE_UNSPECIFIED Le type d'algorithme n'est pas spécifié ou est inconnu dans cette version.
SCRIPT_BASED Algorithme généré à l'aide de fichiers de script d'enchères personnalisées importés par le client.
ADS_DATA_HUB_BASED Algorithme créé via le produit Ads Data Hub.
GOAL_BUILDER_BASED Algorithme créé via l'outil de création d'objectifs dans l'interface utilisateur de DV3

CustomBiddingModelReadinessState

État de préparation du modèle de l'algorithme d'enchères personnalisées pour un seul annonceur partagé.

Représentation JSON 
{
  "advertiserId": string,
  "readinessState": enum (ReadinessState)
}
Champs
advertiserId

string (int64 format)

Identifiant unique de l'annonceur concerné.
readinessState

enum (ReadinessState)

État de préparation du modèle d'enchères personnalisées.

ReadinessState

États possibles de préparation du modèle.

Enums
READINESS_STATE_UNSPECIFIED L'État n'est pas spécifié ou est inconnu dans cette version.
READINESS_STATE_ACTIVE Le modèle est entraîné et prêt à être utilisé.
READINESS_STATE_INSUFFICIENT_DATA Les données sont insuffisantes pour entraîner le modèle d'inférence.
READINESS_STATE_TRAINING Le modèle est en cours d'entraînement et n'est pas prêt pour l'inférence.
READINESS_STATE_NO_VALID_SCRIPT Aucun script d'enchères personnalisées valide n'a été fourni pour entraîner le modèle. Cet état ne sera appliqué qu'aux algorithmes dont la valeur customBiddingAlgorithmType est SCRIPT_BASED.

État

États possibles des algorithmes d'enchères personnalisées.

Enums
STATE_UNSPECIFIED L'État n'est pas spécifié ou est inconnu dans cette version.
ENABLED L'algorithme est activé, qu'il s'agisse d'un algorithme utilisé récemment, actuellement utilisé ou dont l'utilisation est planifiée. L'algorithme évalue activement les impressions.
DORMANT L'algorithme n'a pas été utilisé récemment. Bien que l'algorithme agisse toujours comme ENABLED, il finira par être suspendu s'il n'est pas utilisé.
SUSPENDED L'algorithme est utilisé pour évaluer les impressions et aucun modèle de diffusion n'est entraîné. Si l'algorithme est attribué à un élément de campagne ou s'il est mis à jour d'une autre manière, il repassera à l'état ENABLED, et aura besoin de temps pour préparer à nouveau le modèle de diffusion.

Méthodes

create

 Crée un algorithme d'enchères personnalisées.

get

 Permet d'obtenir un algorithme d'enchères personnalisées.

list

 Liste les algorithmes d'enchères personnalisées qui sont accessibles à l'utilisateur actuel et qui peuvent être utilisés dans des stratégies d'enchères.

patch

 Met à jour un algorithme d'enchères personnalisées existant.

uploadScript

 Crée un objet de référence de script d'enchères personnalisées pour un fichier de script.