- Ressource: CustomBiddingAlgorithm
- CustomBiddingAlgorithmType
- CustomBiddingModelDetails
- ReadinessState
- SuspensionState
- Méthodes
Ressource: CustomBiddingAlgorithm
Un seul algorithme d'enchères personnalisées.
Représentation JSON |
---|
{ "name": string, "customBiddingAlgorithmId": string, "displayName": string, "entityStatus": enum ( |
Champs | |
---|---|
name |
Uniquement en sortie. Nom de ressource de l'algorithme d'enchères personnalisées. |
customBiddingAlgorithmId |
Uniquement en sortie. ID unique de l'algorithme d'enchères personnalisées. Attribué par le système. |
displayName |
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 |
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 :
|
customBiddingAlgorithmType |
Obligatoire. Immuable. Type d'algorithme d'enchères personnalisées. |
sharedAdvertiserIds[] |
Identifiants des annonceurs qui ont accès à cet algorithme. Si Ce champ ne sera pas défini si l'algorithme |
modelDetails[] |
Uniquement en sortie. Détails des modèles d'enchères personnalisées pour chaque annonceur y ayant accès. Ce champ ne peut inclure les détails de l'annonceur interrogé que si l'algorithme |
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 |
Immuable. ID unique du partenaire auquel appartient l'algorithme d'enchères personnalisées. |
advertiserId |
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 |
RULE_BASED |
Algorithme basé sur des règles définies. Ces règles sont définies dans l'API à l'aide de l'objet Ce type d'algorithme n'est disponible que pour les clients ajoutés à la liste d'autorisation. Les autres clients tentant d'utiliser ce type recevront un message d'erreur. |
CustomBiddingModelDetails
Détails d'un modèle d'algorithme d'enchères personnalisées pour un seul annonceur partagé.
Représentation JSON |
---|
{ "advertiserId": string, "readinessState": enum ( |
Champs | |
---|---|
advertiserId |
Identifiant unique de l'annonceur concerné. |
readinessState |
État de préparation du modèle d'enchères personnalisées. |
suspensionState |
Uniquement en sortie. État de suspension 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 est SCRIPT_BASED . |
READINESS_STATE_EVALUATION_FAILURE |
Un script valide a été fourni, mais l'évaluation a échoué. Cela s'applique aux scripts qui n'ont pas pu être évalués dans le temps imparti. |
SuspensionState
États de suspension possibles des modèles d'enchères personnalisées.
Enums | |
---|---|
SUSPENSION_STATE_UNSPECIFIED |
L'État n'est pas spécifié ou est inconnu dans cette version. |
SUSPENSION_STATE_ENABLED |
Le modèle est activé (utilisé récemment, actuellement utilisé ou planifié pour son utilisation). L'algorithme évalue activement les impressions pour cet annonceur. |
SUSPENSION_STATE_DORMANT |
Le modèle n'a pas été utilisé récemment. Bien que le modèle agisse toujours en tant que ENABLED , il finira par être suspendu s'il n'est pas utilisé. |
SUSPENSION_STATE_SUSPENDED |
Le modèle est suspendu et ne peut plus être diffusé. Si l'algorithme est attribué à un élément de campagne de cet annonceur ou s'il est mis à jour d'une autre manière, il repassera à l'état ENABLED , et nécessitera du temps pour préparer à nouveau le modèle de diffusion. |
Méthodes |
|
---|---|
|
Crée un algorithme d'enchères personnalisées. |
|
Permet d'obtenir un algorithme d'enchères personnalisées. |
|
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. |
|
Met à jour un algorithme d'enchères personnalisées existant. |
|
Crée un objet de référence de règles pour un fichier AlgorithmRules . |
|
Crée un objet de référence de script d'enchères personnalisées pour un fichier de script. |