Compartir a través de

Servicio de configuración entre asociados

  • Artículo

El servicio de configuración entre asociados permite la recuperación y edición de la configuración de todo el miembro de un miembro en Prebid Server Premium (PSP). Contienen tiempos de espera globales del licitador, detalles de granularidad del precio de las ofertas y configuración de moneda. La configuración entre asociados es la configuración global en la interfaz de usuario.

API de REST

Http (método) Endpoint Description
GET https://api.appnexus.com/prebid/cross-partner-settings Obtenga toda la configuración entre asociados para el miembro del llamador.
POST https://api.appnexus.com/prebid/cross-partner-settings Cree una nueva configuración entre asociados. Pase la configuración entre asociados como JSON en el cuerpo de la solicitud.
PUT https://api.appnexus.com/prebid/cross-partner-settings Actualice una configuración entre asociados existente. Pase la configuración actualizada entre asociados como JSON en el cuerpo de la solicitud.
PATCH https://api.appnexus.com/prebid/cross-partner-settings Actualice una parte de una configuración entre asociados existente. Pase la configuración actualizada entre asociados como JSON en el cuerpo de la solicitud.

GET

Recupere toda la configuración global de PSP para el miembro.

Respuesta

Una respuesta correcta devolverá JSON que contiene la configuración de todo el miembro.

Propiedad Tipo Descripción
bidder_timeout_ms integer El tiempo máximo, en milisegundos, que los asociados de Prebid Server Premium y otros licitadores de nuestro marketplace reciben para responder.
deleted booleano Indica si se ha eliminado la configuración entre asociados.
id integer Identificador único del objeto de configuración entre asociados.
last_modified string La última fecha de modificación del objeto de configuración entre asociados.
last_modified_by string El usuario que modificó por última vez el objeto de configuración entre asociados.
member_id integer Identificador único del miembro al que pertenece el objeto de configuración entre asociados.
price_granularity objeto Define los cubos de precios de CPM en los que se agruparán las pujas de los asociados de demanda en el servidor de anuncios. Consulte la tabla de granularidad de precios siguiente.

Nota:

La jerarquía de tiempo de espera completo en orden de mayor a menor prioridad es:

  1. Valor de tiempo de espera de la subasta de depuración (2000 ms) [si debug=1/true].
  2. Valor de solicitud auction_timeout_ms de anuncio establecido por el publicador.
    1. Para AMP, consulte la guía aquí.
    2. Para Android, consulte las instrucciones aquí.
    3. Para iOS, consulte las instrucciones aquí.
  3. Valor de nivel auction_timeout_ms de ubicación. Póngase en contacto con su representante de Microsoft para establecer este valor.
  4. Valor de tiempo de espera de configuración global de PSP (entre asociados) establecido por el publicador. Consulte las instrucciones aquí.
  5. Valor de nivel default_auction_timeout_ms de miembro para el centro de datos determinado. Póngase en contacto con su representante de Microsoft para establecer este valor.
  6. Valor de nivel default_auction_timeout_ms de miembro. Póngase en contacto con su representante de Microsoft para establecer este valor.
  7. Centro de datos de Microsoft/valor predeterminado global (150 ms).

Granularidad del precio

La granularidad del precio define los cubos de precios de CPM en los que se agruparán las pujas de asociados de demanda en el servidor de anuncios. Para obtener más información, consulte la documentación de Prebid.

Propiedad Tipo Descripción
label string El tipo de escala tal como se define en la documentación de Prebid (baja, media, alta, automática, densa, personalizada).
ranges matriz Objeto contenedor que describe el intervalo de granularidad de precios.
ranges.max integer Longitud máxima del intervalo.
ranges.increment float Cantidad que se va a incrementar a través del intervalo.
precision integer Número de posiciones decimales para redondear el precio. Dos es el valor predeterminado, por lo que un precio de 2,1234 se redondearía a dos posiciones decimales, 2,12.
currency_code string Cadena que contiene el código de moneda deseado para los cálculos del cubo de precios. Debe formar parte de la lista de monedas aprobada por Microsoft.

Ejemplo de respuesta

{
   "id":5,
   "member_id":13859,
   "bidder_timeout_ms":250,
   "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",
   "last_modified_by":"user123",
   "deleted":false
}

POST

Cree una nueva configuración entre asociados.

POST ejemplo de llamada mediante curl

curl https://api.appnexus.com/prebid/cross-partner-settings

POST JSON de ejemplo

{
   "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:Parámetros

Propiedad Tipo Ámbito Descripción
bidder_timeout_ms integer Obligatorio El tiempo máximo, en milisegundos, que los asociados de Prebid Server Premium y otros licitadores de nuestro marketplace reciben para responder.
price_granularity objeto Obligatorio La configuración de granularidad del precio. Para obtener más información sobre este objeto, consulte la tabla de granularidad de precios siguiente.

POST: granularidad del precio

La granularidad del precio define los cubos de precios de CPM en los que se agruparán las pujas de asociados de demanda en el servidor de anuncios. Para obtener más información, consulte la documentación de Prebid.

Propiedad Tipo Ámbito Descripción
label matriz Obligatorio El tipo de escala tal como se define en la documentación de Prebid (baja, media, alta, automática, densa, personalizada).
ranges matriz Obligatorio Objeto contenedor que describe el intervalo de granularidad de precios.
ranges.max integer Obligatorio Longitud máxima del intervalo.
ranges.increment float Obligatorio Cantidad que se va a incrementar a través del intervalo.
precision integer Obligatorio Número de posiciones decimales para redondear el precio. Dos es el valor predeterminado, por lo que un precio de 2,1234 se redondearía a dos posiciones decimales, 2,12.
currency_code string Obligatorio Cadena que contiene el código de moneda deseado para los cálculos del cubo de precios. Debe formar parte de la lista de monedas aprobada por Microsoft.

PUT

Sobrescribe una configuración entre asociados existente. Pase la información como JSON en el cuerpo de la solicitud.

Ejemplo de llamada mediante curl

curl https://api.appnexus.com/prebid/cross-partner-settings

JSON de ejemplo

{
  "id": 450,
  "bidder_timeout_ms": 400,
  "price_granularity": {
    "label": "Auto",
    "currency_code": "USD",
    "precision": 2,
    "ranges": [
      {
        "max": 5,
        "increment": 0.05
      },
      {
        "max": 10,
        "increment": 0.1
      },
      {
        "max": 20,
        "increment": 0.5
      }
    ]
  }
}

Respuesta

Devuelve el objeto de asociado de demanda Prebid actualizado.

PATCH

Novedades una configuración entre asociados existente. Pase la información como JSON en el cuerpo de la solicitud.

Ejemplo de llamada mediante curl

curl https://api.appnexus.com/prebid/cross-partner-settings

JSON de ejemplo

{
  "bidder_timeout_ms": 500
}

Respuesta

Devuelve el objeto de asociado de demanda prebid actualizado.