Service Paramètres inter-partenaires

Le service de paramètres inter-partenaires permet de récupérer et de modifier les paramètres à l’échelle du membre d’un membre dans PSP. Ils contiennent des délais d’expiration des soumissionnaires mondiaux, des détails de granularité des prix pour les offres et des paramètres de devise. Les paramètres inter-partenaires sont des paramètres globaux dans l’interface utilisateur.

API REST

HTTP, méthode Endpoint Description
GET https://api.appnexus.com/prebid/cross-partner-settings?member_id=9385 Obtenez tous les paramètres inter-partenaires pour le membre de l’appelant.
POST https://api.appnexus.com/prebid/cross-partner-settings Create un nouveau paramètre inter-partenaires. Transmettez les paramètres inter-partenaires au format JSON dans le corps de la demande.
PUT https://api.appnexus.com/prebid/cross-partner-settings Mettre à jour un paramètre inter-partenaires existant. Transmettez les paramètres de partenaires croisés mis à jour au format JSON dans le corps de la demande.
PATCH https://api.appnexus.com/prebid/cross-partner-settings Mettez à jour une partie d’un paramètre inter-partenaires existant. Transmettez les paramètres de partenaires croisés mis à jour au format JSON dans le corps de la demande.

GET

Obtenez tous les paramètres inter-partenaires. Pour que la demande soit valide, les données de session utilisateur doivent être incluses.

Paramètres

Nom Type Portée Description
member_id entier Obligatoire ID de membre auquel les paramètres inter-partenaires seront associés.

Exemple d’appel utilisant curl

curl data = ([
   {
      "username":"aedwards_1",
      "user_id":"1",
      "user_type":"admin",
      "entity_id":7293,
      "initial_user_id":null,
      "initial_user_name":null,
      "access_control":{
         "member_configured":null,
         "groups":{
            "roles":[
               123
            ],
            "teams":[
               232,
               12,
               32
            ]
         }
      }
   }
])

'https://api.appnexus.com/prebid/cross-partner-settings?member_id=9385'

Données de session

Nom Type Portée Description
username string Obligatoire Nom de l’utilisateur qui effectue la demande.
user_id entier Obligatoire ID de l’utilisateur qui effectue la demande.
user_type chaîne Obligatoire Type d’utilisateur qui effectue la demande. Par exemple : "admin".
entity_id entier Obligatoire ID de l’entité de l’utilisateur.
initial_user_id entier Obligatoire
initial_user_name chaîne Obligatoire
access_control objet Obligatoire
access_control.member_configured Obligatoire
access_control.groups objet Obligatoire
access_control.groups.roles tableau Obligatoire
access_control.groups.teams tableau Obligatoire

Réponse

Une réponse réussie retourne un json contenant les paramètres inter-partenaires pour le membre passé.

Champ Type Description
bidder_timeout_ms entier Temps maximal, en millisecondes, que les partenaires Prebid Server Premium et les autres soumissionnaires de notre Place de marché sont donnés pour répondre.
deleted valeur booléenne Indique si le paramètre inter-partenaires a été supprimé.
id entier Identificateur unique de l’objet de paramètre inter-partenaires.
last_modified string Date de la dernière modification de l’objet de paramètre inter-partenaires.
member_id entier Identificateur unique du membre auquel appartient l’objet de paramètre inter-partenaires.
price_granularity objet Consultez le tableau de granularité des prix ci-dessous.

Remarque

La hiérarchie des délais d’expiration complets dans l’ordre de priorité la plus élevée à la priorité la plus basse est la suivante :

  1. Debug Auction timeout value (2000ms) [if debug=1/true].
  2. Valeur de demande auction_timeout_ms d’annonce définie par l’éditeur.
    1. Pour AMP, consultez les conseils ici.
    2. Pour Android, consultez les conseils ici.
    3. Pour iOS, consultez les conseils ici.
  3. Valeur au niveau du placement auction_timeout_ms . Contactez votre représentant Xandr pour définir cette valeur.
  4. Valeur de délai d’expiration des paramètres globaux PSP (partenaires croisés) définie par l’éditeur. Consultez les conseils ici.
  5. Valeur de niveau default_auction_timeout_ms membre pour le centre de données donné. Contactez votre représentant Xandr pour définir cette valeur.
  6. Valeur au niveau default_auction_timeout_ms du membre. Contactez votre représentant Xandr pour définir cette valeur.
  7. Centre de données Xandr/valeur par défaut globale (150 ms).

Granularité des prix

La granularité des prix définit les compartiments de prix CPM dans lesquels les offres des partenaires de demande seront regroupées. Pour plus d’informations, consultez la documentation Prebid.

Propriété Type Description
label string Valeur acceptée pour la granularité des prix. Consultez la documentation Prebid.
ranges tableau Objet conteneur décrivant la plage de granularité des prix.
ranges.max entier Longueur maximale de la plage.
ranges.increment float Quantité à incrémenter au sein de la plage.
precision entier Nombre de décimales pour arrondir le prix. Deux étant la valeur par défaut, un prix de 2,1234 est arrondi à deux décimales, 2,12.
currency_code string Chaîne contenant le code monétaire souhaité pour les calculs de compartiment de prix. Doit faire partie de la liste des devises approuvées par Xandr.

Exemple de réponse

{
   "id":5,
   "member_id":7293,
   "bidder_timeout_ms":0,
   "price_granularity":{
      "label":"Dense",
      "ranges":[
         {
            "max":3,
            "increment":0.01
         },
         {
            "max":8,
            "increment":0.05
         },
         {
            "max":20,
            "increment":0.5
         }
      ],
      "currency_code":"USD",
      "precision":2
   },
   "last_modified":"2019-10-31T17:37:50Z",
   "deleted":false
}

POST

Create un nouveau paramètre inter-partenaires.

POST: Exemple d’appel à l’aide de curl

{
   "id":123,
   "member_id":13859,
   "bidder_timeout_ms":995,
   "price_granularity":{
      "label":"Dense",
      "ranges":[
         {
            "max":3,
            "increment":0.01
         },
         {
            "max":8,
            "increment":0.05
         },
         {
            "max":20,
            "increment":0.5
         }
      ],
      "precision":2,
      "currency_code":"USD"
   }
}

POST:Paramètres

Nom Type Portée Description
bidder_timeout_ms entier Obligatoire Temps maximal, en millisecondes, que les partenaires Prebid Server Premium et les autres soumissionnaires de notre Place de marché sont donnés pour répondre.
member_id entier Obligatoire ID de membre auquel les paramètres inter-partenaires seront associés.
price_granularity objet Obligatoire Paramètres de granularité des prix. Pour plus d’informations sur cet objet, consultez le tableau de granularité des prix ci-dessous.

POST: Granularité des prix

La granularité des prix définit les compartiments de prix CPM dans lesquels les offres des partenaires de demande seront regroupées. Pour plus d’informations, consultez la documentation Prebid.

Propriété Type Portée Description
ranges tableau Obligatoire Objet conteneur décrivant la plage de granularité des prix.
ranges.max entier Obligatoire Longueur maximale de la plage.
ranges.increment float Obligatoire Quantité à incrémenter au sein de la plage.
precision entier Obligatoire Nombre de décimales pour arrondir le prix. Deux étant la valeur par défaut, un prix de 2,1234 est arrondi à deux décimales, 2,12.
currency_code string Obligatoire Chaîne contenant le code monétaire souhaité pour les calculs de compartiment de prix. Doit faire partie de la liste des devises approuvées par Xandr.

POST:Exemple

{
   "username":"aedwards_1",
   "user_id":"1",
   "user_type":"admin",
   "entity_id":7293,
   "initial_user_id":null,
   "initial_user_name":null,
   "access_control":{
      "member_configured":null,
      "groups":{
         "roles":[
            123
         ],
         "teams":[
            232,
            12,
            32
         ]
      }
   }
}
  • Last updated on