Servicio de configuración

Una vez que el inventario se ha integrado con Prebid Server Premium (PSP), se ha revisado la configuración entre socios y se han habilitado los socios de demanda , el inventario debe asignarse a los socios de demanda a través de las configuraciones de PSP. Estas asignaciones permiten a PSP enviar solicitudes de oferta con los parámetros de los socios de demanda para que los socios puedan identificar el inventario y representarlo mejor ante sus compradores, lo que aumenta el rendimiento y respeta la configuración del editor, como los pisos y la calidad de los anuncios.

• Cada configuración se dirige a una parte del inventario del editor en Monetize mediante una o más dimensiones, como ubicación, grupo con ubicación, editor, geografía, tipo de inventario o clave-valor.
• Cada configuración incluye uno o varios partners de demanda que el editor desea pujar por el inventario
• Cada socio de demanda especifica los parámetros requeridos y opcionales que desea recibir en su adaptador Prebid Server Go de código abierto, que se muestran en PSP. Estos permiten al socio hacer coincidir la solicitud de oferta con los objetos de su plataforma
• Los publicadores rellenan los parámetros del partner de demanda con valores asignados a objetos de la plataforma de cada partner, normalmente otra plataforma del lado de la oferta (SSP)

Requisitos de los partners de demanda

Todos los partners de demanda que el editor desee ofertar por el inventario definido en una configuración de PSP deben agregarse a la misma configuración. Antes de crear el primer conjunto de configuraciones, revise los requisitos con cada uno de los socios de demanda de PSP planificados para determinar una estrategia de asignación. Algunos socios extraen información dinámicamente de la solicitud de oferta (tamaño del anuncio, ubicación geográfica, idioma, etc.), mientras que otros pueden requerir asignaciones de parámetros independientes y, a su vez, configuraciones de PSP. Si un socio de demanda requiere una asignación muy granular a objetos en su plataforma, eso determinará cómo se asignan otros socios y cuántas configuraciones se requieren. Cuanto mejor pueda identificar el inventario un socio de demanda (ya sea a través de la solicitud de oferta o parámetros estáticos de Prebid), más información podrá proporcionar a sus compradores, lo que aumentará los ingresos de los editores.

Los parámetros del partner de demanda se pueden encontrar:

• En el servicio de configuración de PSP, como se detalla a continuación, o dentro de la propia interfaz de usuario .
• En el sitio de Prebid , donde se proporcionan detalles y contexto completos.
• En el servicio de esquema de partner de demanda de PSP.

La documentación siguiente describe cómo crear y administrar configuraciones a través de la API. Las configuraciones también se pueden administrar a través de la interfaz de usuario.

API de REST

GET

Devuelve todas las configuraciones de Prebid para el miembro del autor de la llamada. Los resultados se devuelven como JSON.

Parameters

Llamada de ejemplo con curl con argumentos de filtro de estado

curl --header "Content-Type: application/json" https://api.appnexus.com/prebid/config?status_filter=enabled

Ejemplo de llamada que usa curl para devolver una configuración específica

Anexe el id. de configuración como último componente de la dirección URL.

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

Respuestas

Una respuesta correcta devolverá un JSON que contiene la configuración entre socios del miembro y todas sus configuraciones de PSP. Incluir un específico prebidSettingsId en la cadena de consulta dará como resultado una respuesta que contenga solo esa configuración.

Configuración de los partners de demanda

Propiedades de configuración

Propiedades de metadatos de destino

Exigir las propiedades de configuración de los asociados

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. Esto se define en el servicio de configuración entre socios.

Perfil

El profile objeto contiene los atributos de segmentación de inventario usados para hacer coincidir las solicitudes de puja con las configuraciones de PSP.

El perfil es:

• Se genera automáticamente al usar la interfaz de usuario de PSP, o bien
• Creado a partir de la entrada del usuario a través de la psp-campaign-objects API.

Para actualizar un perfil, use la psp-campaign-objects API. El servicio de configuración devuelve el objeto solo en GET las psp_profile respuestas.

Paginación

El número de respuestas se puede limitar pasando el num_elements argumento. El elemento que se va a empezar a ver se puede establecer a través del start_element argumento.

Ejemplo de llamada para limitar a quince resultados e iniciar los resultados en el décimo elemento

Los elementos devueltos se indexarán del 10º al vigésimo quinto.

GET https://api.appnexus.com/prebid/config?num_element=15&start_element=10

Ejemplo de respuesta

{
  "id": 450,
  "member_id": 13859,
  "bidder_timeout_ms": 500,
  "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
      }
    ]
  },
  "deleted": 0,
  "last_modified_by": "user123",
  "last_modified": "2024-08-21T16:37:24.000Z",
  "demand_partner_settings": {
    "appnexus": {
      "id": 2045,
      "bid_cpm_adjustment": 0.7,
      "enabled": 1
    },
    "openx": {
      "id": 2065,
      "bid_cpm_adjustment": 1,
      "enabled": 0
    },
    "ix": {
      "id": 2106,
      "bid_cpm_adjustment": 0.9,
      "enabled": 1
    },
    "adform": {
      "id": 2110,
      "bid_cpm_adjustment": 1,
      "enabled": 1
    }
  },
  "total_configs": 2,
  "configs": [
    {
      "id": 87053,
      "member_id": 13859,
      "name": "ConfigName1",
      "targeting_level_code": 4,
      "targeting_id": 25172737,
      "enabled": 1,
      "targeting_metadata": {
        "priority": 10
      },
      "deleted": 0,
      "last_modified_by": "user123",
      "last_modified": "2024-07-17T18:17:56.000Z",
      "demand_partner_config_params": [
        {
          "id": 619584,
          "member_id": 13859,
          "prebid_settings_id": 87053,
          "name": "ix",
          "params": {
            "size": null,
            "siteId": "yyy.com"
          },
          "enabled": 1,
          "deleted": 0,
          "last_modified_by": "user123",
          "last_modified": "2024-07-17T18:36:40.000Z"
        }
      ],
      "psp_profile": {
        "id": 147870841,
        "description": "",
        "country_action": "include",
        "supply_type_action": "include",
        "advertiser_id": 11125655,
        "created_on": "2025-10-23 18:02:50",
        "country_targets": [
          {
            "id": 59,
            "name": "Germany",
            "code": "DE",
            "active": true
          },
          {
            "id": 233,
            "name": "United States",
            "code": "US",
            "active": true
          }
        ],
        "supply_type_targets": [
          "mobile_app",
          "mobile_web",
          "web"
        ],
        "ad_type_targets": [
          {
            "id": 2,
            "name": "video"
          }
        ],
        "placement_targets": [
          {
            "id": 36707024,
            "action": "include",
            "name": "Placement Name 1",
            "deleted": 0,
            "site_id": 7908985,
            "site_name": "Placement Group 1",
            "publisher_id": 2545613,
            "publisher_name": "Publisher 1"
          }
        ]
      }
    },
    {
      "id": 87784,
      "member_id": 13859,
      "name": "ConfigName2",
      "targeting_level_code": 4,
      "targeting_id": 25175861,
      "enabled": 1,
      "targeting_metadata": {
        "priority": 10
      },
      "deleted": 0,
      "last_modified_by": "user123",
      "last_modified": "2024-07-31T21:34:34.000Z",
      "demand_partner_config_params": [
        {
          "id": 619080,
          "member_id": 13859,
          "prebid_settings_id": 87784,
          "name": "openx",
          "params": {
            "unit": "3456",
            "platform": null,
            "delDomain": "abc.com",
            "customFloor": null,
            "customParams": null
          },
          "enabled": 0,
          "deleted": 0,
          "last_modified_by": "user123",
          "last_modified": "2024-08-21T21:10:28.000Z"
        },
        {
          "id": 619081,
          "member_id": 13859,
          "prebid_settings_id": 87784,
          "name": "ix",
          "params": {
            "size": null,
            "siteId": "abc.com"
          },
          "enabled": 1,
          "deleted": 0,
          "last_modified_by": "user123",
          "last_modified": "2024-07-17T18:36:06.000Z"
        },
        {
          "id": 625915,
          "member_id": 13859,
          "prebid_settings_id": 87784,
          "name": "adform",
          "params": {
            "inv": null,
            "mid": "1414158",
            "mname": null,
            "priceType": null
          },
          "enabled": 1,
          "deleted": 0,
          "last_modified_by": "user123",
          "last_modified": "2024-07-17T18:36:09.000Z"
        }
      ],
      "psp_profile": {
        "id": 147870841,
        "description": "",
        "country_action": "include",
        "supply_type_action": "include",
        "advertiser_id": 11125655,
        "created_on": "2025-10-23 18:02:50",
        "country_targets": [
          {
            "id": 59,
            "name": "Germany",
            "code": "DE",
            "active": true
          },
          {
            "id": 233,
            "name": "United States",
            "code": "US",
            "active": true
          }
        ],
        "supply_type_targets": [
          "mobile_app",
          "mobile_web",
          "web"
        ],
        "ad_type_targets": [
          {
            "id": 2,
            "name": "video"
          }
        ],
        "placement_targets": [
          {
            "id": 36707024,
            "action": "include",
            "name": "Placement Name 2",
            "deleted": 0,
            "site_id": 7908985,
            "site_name": "Placement Group 2",
            "publisher_id": 2545613,
            "publisher_name": "Publisher 2"
          }
        ]
      }
    }
  ]
}
       

POST

Habilita la creación de un nuevo objeto de configuración. El demand_partner_config_params.enabled campo no debe incluirse en ninguna solicitud a este servicio. El valor se hereda del estado del asociado en el servicio de asociado de demanda.

Ejemplo de llamada con curl

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

POST: Parámetros

POST: Exigir las propiedades de configuración de los asociados

POST: Propiedades de metadatos de destino

Ejemplo de solicitud JSON

{
    "name": "ConfigName1",
    "targeting_id": 22378872,
    "enabled": 0,
    "targeting_metadata": {
        "priority": 20
    },
    "demand_partner_config_params": [
        {
            "id": 1718542,
            "member_id": 13859,
            "name": "appnexus",
            "params": {
                "placement_id": 123456
            }
        }
    ]
}
            

Respuesta

Una respuesta correcta devolverá el nuevo objeto de configuración.

POST: Ejemplo de respuesta JSON

{
    "id": 196038,
    "member_id": 13859,
    "name": "ConfigName1",
    "targeting_level_code": 4,
    "targeting_id": 22378872,
    "enabled": 1,
    "targeting_metadata": {
        "priority": 20
    },
    "deleted": 0,
    "last_modified_by": "user123",
    "last_modified": "2024-08-22T21:24:40.000Z",
    "demand_partner_config_params": [
        {
            "id": 1718542,
            "member_id": 13859,
            "prebid_settings_id": 196038,
            "name": "appnexus",
            "params": {
                "placement_id": 123456
            },
            "enabled": 1,
            "deleted": 0,
            "last_modified_by": "user123",
            "last_modified": "2024-08-22T21:24:40.000Z"
        }
    ]
}
                

PUT

Sobrescritura de una configuración de Prebid existente. Inclúyalo prebidSettingsId como último componente de la ruta de acceso URL. Pase la información de actualización como JSON en el cuerpo de la solicitud.

El demand_partner_config_params.enabled campo no debe incluirse en ninguna solicitud a este servicio. El valor se hereda del estado del asociado en el servicio de asociado de demanda.

PUT: Ejemplo de llamada con curl

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

PUT: Ejemplo de solicitud JSON

{
    "name": "ConfigName1",
    "targeting_id": 22378872,
    "enabled": 0,
    "targeting_metadata": {
        "priority": 20
    },
    "demand_partner_config_params": [
        {
            "id": 1718542,
            "member_id": 13859,
            "prebid_settings_id": 196038,
            "name": "appnexus",
            "params": {
                "placement_id": 123456
            }
        }
    ]
}

PUT: Respuesta

Devuelve un objeto de configuración Prebid.

PATCH

Actualizar parcialmente una configuración de Prebid existente. Incluya el prebidSettingsId como último componente de la ruta de acceso. Pase la información de actualización como JSON en el cuerpo de la solicitud. La solicitud debe incluir un objeto de nivel config superior que contenga los demás elementos que se van a actualizar.

El demand_partner_config_params.enabled campo no debe incluirse en ninguna solicitud a este servicio. El valor se hereda del estado del asociado en el servicio de asociado de demanda.

PATCH: Ejemplo de llamada con curl

curl -d @config-update.json -X PATCH --header "Content-Type: application/json https://api.appnexus.com/prebid/config/{prebidSettingsId}

PATCH: Ejemplo de solicitud JSON

{
    "config": {
        "enabled": 0
    }
}

PATCH: Respuesta

Devuelve un objeto de configuración Prebid.

DELETE

Eliminar una configuración de Prebid existente. Incluya el prebidSettingsId como último componente de la ruta de acceso.

ELIMINAR: Ejemplo de llamada con curl

curl -X DELETE https://api.appnexus.com/prebid/config/{prebidSettingsId}

ELIMINAR: Respuesta

Si se realiza correctamente, la configuración indicada se devolverá como un objeto JSON con la propiedad eliminada establecida en 1. Ya no estará disponible en el sistema. También se eliminarán todos los subobjetos.

Temas relacionados

• Servicio de objetos de campaña de PSP
• Servicio de esquema del partner a petición
• Servicio de asociado de demanda
• Servicio de parámetros de partner de demanda de Prebid
• Servicio de tamaños de anuncios
• Servicio de tipo de medio
• Servicio de configuración entre asociados
• Crear una nueva configuración de PSP
• Integraciones de partners de demanda de Prebid Server Premium
• Problemas comunes y procedimientos recomendados