Servicio de configuración entre socios

El servicio de configuración entre socios permite recuperar y editar la configuración de todo el miembro para un miembro en Prebid Server Premium (PSP). Contienen tiempos de espera de pujadores globales, detalles de granularidad de precios para las pujas y configuración de moneda. La configuración entre socios es una configuración global en la interfaz de usuario.

API de REST

Método HTTP Endpoint Description
GET https://api.appnexus.com/prebid/cross-partner-settings Obtenga toda la configuración entre socios del miembro del autor de la llamada.
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 Actualizar una configuración existente entre asociados. Pase la configuración actualizada entre asociados como JSON en el cuerpo de la solicitud.
PATCH https://api.appnexus.com/prebid/cross-partner-settings Actualizar una parte de una configuración existente entre asociados. Pase la configuración actualizada entre asociados como JSON en el cuerpo de la solicitud.

GET

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

Respuesta

Una respuesta correcta devolverá un 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 socios de Prebid Server Premium y otros postores en nuestro mercado tienen para responder.
deleted integer Indica si se ha eliminado la configuración entre asociados. Los valores permitidos son:
0 = activo,
1 = eliminado
id integer Identificador único para el objeto de configuración entre asociados.
last_modified string Fecha de la última 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 socios.
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 partners de demanda en el servidor de anuncios. Consulte la tabla de granularidad de precios a continuación.

Nota:

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

  1. Valor de tiempo de espera de la subasta de depuración (2000ms) [if debug=1/true].
  2. Valor de solicitud auction_timeout_ms de anuncio establecido por el editor.
    1. Para AMP, consulta la guía aquí.
    2. Para Android, consulte la guía 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. Configuración global de PSP (entre asociados) Valor de tiempo de espera 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 a 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 CPM en los que se agruparán las pujas de los partners 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 definida 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 La longitud máxima del rango.
ranges.increment float La cantidad que se va a incrementar a través del intervalo.
precision integer El 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 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":0
}

POST

Cree una nueva configuración entre asociados.

POST Ejemplo de llamada con CURL

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

POST ejemplo JSON

{
   "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 socios de Prebid Server Premium y otros postores en nuestro mercado tienen para responder.
price_granularity objeto Obligatorio La configuración de granularidad del precio. Para obtener más detalles sobre este objeto, consulte la tabla de granularidad de precios a continuación.

POST: Granularidad del precio

La granularidad del precio define los cubos de precios CPM en los que se agruparán las pujas de los partners 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 definida 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 La longitud máxima del rango.
ranges.increment float Obligatorio La cantidad que se va a incrementar a través del intervalo.
precision integer Obligatorio El 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 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 existente entre asociados. Pase la información como JSON en el cuerpo de la solicitud.

Ejemplo de llamada con 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 de una configuración existente entre asociados. Pase la información como JSON en el cuerpo de la solicitud.

Ejemplo de llamada con 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.

  • Last updated on