Service Prebid Demand Partner Params

Le service Prebid Demand Partner Params Permet aux utilisateurs d’afficher, d’ajouter, de supprimer, d’activer et de désactiver des partenaires spécifiques sur des configurations PSP. Les configurations sont gérées via le service de configuration. Un partenaire à la demande doit être activé dans le service paramètres inter-partenaires avant de pouvoir être ajouté à des configurations dans le service params et avant de pouvoir recevoir des demandes d’enchères via Prebid Server Premium (PSP). Toute tentative d’ajout d’un partenaire qui n’est pas présent dans les paramètres cross-partner entraîne une erreur.

Remarque

Bien qu’un partenaire puisse être désactivé via ce service au niveau de la configuration, toute modification future apportée au partenaire dans le service de paramètres inter-partenaires remplacera les configurations individuelles et activera/désactivera le partenaire sur toutes les configurations. Vous trouverez plus d’informations sur les paramètres pris en charge par chaque partenaire dans le service de schéma du partenaire demand.

API REST

HTTP, méthode Endpoint Description
GET https://api.appnexus.com/prebid/prebid-demand-partner-params Obtenez toutes les configurations de partenaire de demande Prebid.
GET - https://api.appnexus.com/prebid/prebid-demand-partner-params?prebid_settings_id={prebid_settings_id}
- https://api.appnexus.com/prebid/prebid-demand-partner-params?prebid_settings_id={prebid_settings_id}& member_id={member_id}		 Obtenez tous les partenaires de demande Prebid pour un paramètre Prebid spécifique.
GET https://api.appnexus.com/prebid/prebid-demand-partner-params/{prebidDemandPartnerParamId} Obtenez une configuration de partenaire de demande Prebid spécifique. Incluez comme prebidSettingsId dernier composant de chemin d’URL.
POST https://api.appnexus.com/prebid/prebid-demand-partner-params Créez de nouveaux paramètres de partenaire de demande. Pour obtenir un exemple et une réponse cURL, consultez POST la section ci-dessous.
PUT https://api.appnexus.com/prebid/prebid-demand-partner-params/{prebidDemandPartnerParamId} Mettez à jour une configuration de partenaire de demande Prebid existante.
DELETE https://api.appnexus.com/prebid/prebid-demand-partner-params/{prebidDemandPartnerParamId} Supprimez une configuration de partenaire de demande Prebid spécifique. Incluez comme prebidSettingsId dernier composant de chemin d’URL.

GET

Retourne tous les paramètres de configuration du partenaire de demande Prebid ou un paramètre spécifique pour le membre de l’appelant. Pour une configuration partenaire de demande Prebid spécifique, incluez comme prebidSettingsId dernier composant de chemin d’URL. Les résultats sont retournés au format JSON.

Exemple d’appel utilisant cURL pour retourner une configuration spécifique

Ajoutez l’ID de configuration comme dernier composant de l’URL.

curl --header "Content-Type: application/json" https://api.appnexus.com/prebid/prebid-demand-partner-params/{prebidSettingsId}

Retourner tous les paramètres de configuration du partenaire Prebid Demand pour un paramètre de prébid spécifique

GET https://api.appnexus.com/prebid/prebid-demand-partner-params?prebid_settings_id={prebid_settings_id}
 
//or 

GET https://api.appnexus.com/prebid/prebid-demand-partner-params?prebid_settings_id={prebid_settings_id}&member_id={member_id}

Réponse

Une réponse réussie retourne un json contenant toutes les configurations Prebid pour le membre ou la configuration Prebid demandée.

Propriété Type Description
deleted valeur booléenne Indique si l’objet params de ce partenaire a été supprimé.
enabled valeur booléenne Indique si les paramètres partenaires de demande prebid sont activés ou désactivés.
id entier ID de l’appelant.
last_modified string Date de modification la plus récente des paramètres de configuration du partenaire de demande.
last_modified_by string Personne qui a apporté les dernières modifications aux paramètres partenaires de demande.
member_id entier ID de membre de l’appelant.
name objet Nom du partenaire de demande.
params objet Objet contenant les paramètres pris en charge par le partenaire et les valeurs mappées. Les paramètres pris en charge sont disponibles ici.
prebid_settings_id entier ID de l’objet de paramètre Prebid.

Exemple de réponse

[
   {
      "id":104,
      "prebid_settings_id":30,
      "name":"improvedigital",
      "member_id":7293,
      "params":{
         "size":null,
         "keyValues":null,
         "placementId":567594,
         "publisherId":null,
         "placementKey":null
      },
      "enabled":true,
      "deleted":false,
      "last_modified_by":"test123",
      "last_modified":"2019-09-03T22:48:58.135Z"
   }
]

POST

Active la création d’un nouvel objet Prebid Demand Partner Param.

Exemple d’appel utilisant cURL

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

Paramètres

Nom Type Portée Description
name string Obligatoire Nom du partenaire de demande Prebid.
enabled valeur booléenne Obligatoire Indique si les paramètres partenaires de demande prebid sont activés ou désactivés.
member_id entier Obligatoire ID de membre de l’appelant.
params objet Obligatoire Objet contenant les paramètres pris en charge par le partenaire et les valeurs mappées. Les paramètres pris en charge sont disponibles ici.
prebid_settings_id entier Obligatoire The prebid_settings ID.

POST: Exemple de réponse

[
   {
      "id":3333333,
      "prebid_settings_id":222222,
      "name":"appnexus",
      "member_id":11111,
      "params":{
         "placement_id":123456
      },
      "enabled":true,
      "deleted":false,
      "last_modified_by":"user@domain.com",
      "last_modified":"2023-05-01T18:23:09.045Z"
   }
]

PUT

Met à jour un paramètre partenaire de demande Prebid existant. Incluez comme prebidDemandPartnerParamId dernier composant du chemin d’URL. Transmettez les informations de mise à jour au format JSON dans le corps de la demande.

PUT: Exemple d’appel à l’aide de cURL

curl -d @config-update.json -X PUT --header "Content-Type: application/json https://api.appnexus.com/prebid/prebid-demand-partner-params/{prebidDemandPartnerParamId}

PUT:Réponse

Retourne un objet param de partenaire de demande Prebid.

DELETE

Supprimez un paramètre partenaire de demande Prebid existant. Incluez comme prebidSettingsId dernier composant du chemin d’accès.

DELETE: Exemple d’appel à l’aide de cURL

curl -X DELETE https://api.appnexus.com/prebid/prebid-demand-partner-params/{prebidDemandPartnerParamId}

DELETE:Réponse

En cas de réussite, l’objet param de partenaire de demande Prebid est retourné en tant qu’objet JSON avec la propriété supprimée définie sur true. Les paramètres partenaires de demande Prebid ne seront plus disponibles dans le système. Tous les sous-objets seront également supprimés.

  • Last updated on