Service Ad Server principal

Le service serveur ad principal retourne tous les serveurs publicitaires principaux pour le membre de l’appelant. Il permet la création, la mise à jour et la suppression des serveurs publicitaires principaux.

Le serveur publicitaire principal prend la décision finale des annonces qui seront affichées dans l’inventaire des éditeurs. Dans le contexte de PSP, les partenaires demandent, généralement des plateformes côté offre (SSP) comme, créent des adaptateurs pour Prebid Server qui reçoivent et interprètent les demandes d’en-tête d’enchères. Les partenaires de demande organisent une enchère parmi leurs sources de demande (généralement des plateformes côté demande (DSP)) pour collecter des offres sur ces demandes de publicité et renvoyer les enchères à PSP, qui organise une autre enchère. Xandr organise une autre enchère parmi ses sources de demande, y compris les offres des partenaires de demande PSP. Si Microsoft Monetize n’est pas le serveur publicitaire principal, les résultats de cette enchère sont transmis au serveur publicitaire principal (externe).

API REST

HTTP, méthode	Endpoint	Description
GET	https://api.appnexus.com/prebid/primary-adserver	Obtenez tous les serveurs publicitaires principaux.
POST	https://api.appnexus.com/prebid/primary-adserver	Create un nouveau serveur publicitaire principal.
PUT	https://api.appnexus.com/prebid/primary-adserver/{id}	Mettre à jour un serveur publicitaire principal existant.
DELETE	https://api.appnexus.com/prebid/primary-adserver/{id}	Supprimer un serveur publicitaire principal existant.

GET

Retourne les serveurs publicitaires principaux.

Exemple d’appel utilisant cURL :

curl --header "Content-Type: application/json" https://api.appnexus.com/prebid/primary-adserver

Réponse

Une réponse réussie retourne un tableau JSON d’objets de serveur publicitaire.

Propriété	Type	Description
id	entier	Identificateur unique de l’objet serveur publicitaire.
name	string	Nom du serveur publicitaire.

Exemple de réponse

[
   {
      "id":1,
      "name":"freewheel"
   },
   {
      "id":2,
      "name":"google ad manager"
   }
]            
            

POST

Active la création d’un serveur publicitaire.

Exemple d’appel utilisant cURL :

curl -d @adserver.json -X POST --header "Content-Type: application/json" 'https://api.appnexus.com/prebid/adserver'

Paramètres

Nom	Type	Portée	Description
name	string	Obligatoire	Nom de la configuration.

Exemple de fichier JSON :

{
   "name":"adserver-example-name"
}            
            

POST:Réponse

En cas de réussite, l’objet de serveur publicitaire créé est retourné.

PUT

Active la mise à jour d’un objet de serveur publicitaire existant. Ajoutez l’ID du serveur publicitaire comme dernier composant de chemin d’accès de l’URL.

Exemple d’appel utilisant cURL :

curl -d @adserver-update.json -X PUT --header "Content-Type: application/json" 'https://api.appnexus.com/prebid/adserver/{id}'

PUT:Paramètres

Nom	Type	Portée	Description
name	string	Obligatoire	Nom du serveur publicitaire.

Exemple de fichier JSON :

{
   "name":"adserver-example-new-name"
}            
            

PUT:Réponse

En cas de réponse réussie, l’objet serveur publicitaire mis à jour est retourné.

DELETE

Active la suppression de tout ou d’un objet de serveur publicitaire existant. Ajoutez l’ID du serveur publicitaire comme dernier composant de chemin d’accès de l’URL.

Exemple d’appel utilisant cURL pour supprimer tous les objets de serveur publicitaire :

curl  -X DELETE --header "Content-Type: application/json" 'https://api.appnexus.com/prebid/adserver'

Exemple d’appel utilisant cURL pour supprimer un objet de serveur publicitaire existant :

curl  -X DELETE --header "Content-Type: application/json" 'https://api.appnexus.com/prebid/adserver/{id}'

DELETE:Réponse

Objet de notification de suppression réussi.