Servicio demand partner
Demand Partner Service devuelve todos los asociados de demanda para el miembro del llamador. Permite al usuario crear un nuevo asociado de demanda y actualizar o eliminar un asociado de demanda existente.
En el contexto de PSP, los asociados de demanda, normalmente plataformas de suministro (SSP), como, crean adaptadores para el servidor de prebid que reciben e interpretan solicitudes de anuncios de pujas de encabezado. Los asociados de demanda realizan una subasta entre sus fuentes de demanda (normalmente plataformas de lado a la demanda)) para recopilar ofertas en esas solicitudes de anuncios y enviar las ofertas de vuelta a PSP, que mantiene otra subasta.
Para poder agregar un asociado de demanda a una configuración, debe habilitarse a través de este servicio o a través de la interfaz de usuario. Establecer un asociado de demanda para enabled: false pausar todas las solicitudes de puja a ese asociado en todas las configuraciones hasta que la configuración se restaure en true. Puede encontrar la lista de asociados de demanda compatibles con PSP aquí.
API REST
| Http (método) | Endpoint | Description |
|---|---|---|
GET |
https://api.appnexus.com/prebid/demand-partner |
Obtenga todos los asociados de demanda. |
POST |
https://api.appnexus.com/prebid/demand-partner |
Cree un nuevo asociado de demanda. |
PUT |
https://api.appnexus.com/prebid/demand-partner/{id} |
Actualice un asociado de demanda existente. |
PATCH |
https://api.appnexus.com/prebid/demand-partner/{id} |
Actualice una parte de un asociado de demanda existente. |
DELETE |
https://api.appnexus.com/prebid/demand-partner/{id} |
Elimine un asociado de demanda. |
GET
Obtenga todo o un asociado de demanda específico. Para recuperar un asociado de demanda específico, anexe el identificador de asociado de demanda como último componente de la ruta de acceso de la dirección URL. Devuelve una matriz JSON de objetos de asociados de demanda.
Respuesta
| Propiedad | Tipo | Descripción |
|---|---|---|
bid_cpm_adjustment |
integer | Valor multiplicador aplicado al precio de puja de CPM del partner de demanda para ajustar la forma en que las pujas compiten en la subasta. Esto no cambia la oferta real o el pago de ingresos, solo la clasificación de la oferta en la subasta. El valor predeterminado es 1,00. En este caso, todas las ofertas de los socios compiten por igual sin ajustes. El ajuste se puede usar para tener en cuenta las tarifas de los asociados o para la optimización. Si necesita ajustes de CPM en un nivel más granular que demand partner, consulte Creación de una regla de sesgo. |
deleted |
booleano | Esto indica que el objeto de asociado de demanda se ha eliminado del sistema. |
enabled |
booleano | Indica si el asociado de demanda está habilitado o deshabilitado. |
id |
integer | Identificador de asociado de demanda específico del miembro del autor de la llamada. |
last_modified |
string | Fecha en la que se modificó el objeto de asociado de demanda. |
last_modified_by |
string | El usuario que modificó por última vez el objeto de asociado de demanda. |
member_id |
integer | Identificador de miembro. |
name |
string | Nombre del asociado de demanda. |
pub_id_settings |
objeto | Las opciones pertinentes para los identificadores de usuario proporcionados por el publicador. Consulte la tabla de configuración de id. proporcionada por el publicador a continuación. |
Configuración del identificador proporcionado por el publicador
| Propiedad | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador único que representa el origen. |
source |
string | Cadena única que representa el origen. |
member_owner_id |
integer | Identificador único del miembro propietario del origen. |
status |
string | Indica si el origen está activo. Requiere la entrada de cadena de "active" o "inactive". |
Ejemplo de respuesta
[
{
"bid_cpm_adjustment": 2,
"deleted": false,
"enabled": true,
"id": 102,
"last_modified": "2019-09-13T17:39:36Z",
"last_modified_by":"user123",
"member_id": 9325,
"name": "adform",
"pub_id_settings": {
"sources": [
{
"id": 12345,
"source": "sourcename",
"member_owner_id": 9325,
"status": "active"
}
]
}
},
{
"bid_cpm_adjustment": 1,
"deleted": false,
"enabled": true,
"id": 65,
"last_modified": "2018-11-02T15:33:54Z",
"last_modified_by":"user123",
"member_id": 9325,
"name": "appnexus",
"pub_id_settings": null
},
{
"bid_cpm_adjustment": 1,
"deleted": false,
"enabled": true,
"id": 68,
"last_modified": "2018-11-02T18:32:03Z",
"last_modified_by":"user123",
"member_id": 9325,
"name": "openx",
"pub_id_settings": null
},
{
"bid_cpm_adjustment": 1,
"deleted": false,
"enabled": true,
"id": 69,
"last_modified": "2018-11-02T18:32:31Z",
"last_modified_by":"user123",
"member_id": 9325,
"name": "ix",
"pub_id_settings": null
}
]
POST
Cree un nuevo asociado de demanda.
Ejemplo de llamada mediante curl
curl -d @demand-partner.json -X POST 'https://api.appnexus.com/prebid/demand-partner'
| Propiedad | Tipo | Ámbito | Descripción |
|---|---|---|---|
bid_cpm_adjustment |
integer | Obligatorio | Ajuste de CPM de la oferta. |
enabled |
booleano | Obligatorio | Indica si el asociado de demanda está habilitado o deshabilitado. |
name |
string | Obligatorio | Nombre del asociado de demanda. |
pub_id_settings |
objeto | Obligatorio | Las opciones pertinentes para los identificadores de usuario proporcionados por el publicador. Consulte la tabla de configuración de id. proporcionada por el publicador anterior. |
JSON de ejemplo
{
"bid_cpm_adjustment": 1,
"enabled": true,
"name": "test-demand-partner",
"pub_id_settings": {
"sources": [
{
"id": 12345,
"source": "sourcename",
"member_owner_id": 9325,
"status": "active"
}
]
}
}
Respuesta
Una respuesta correcta devolverá el nuevo asociado de demanda como un objeto JSON.
{
"bid_cpm_adjustment": 1,
"deleted": false,
"enabled": true,
"id": 999,
"last_modified": "2020-02-25T18:32:31Z",
"last_modified_by":"user123",
"member_id": 9325,
"name": "test-demand-partner",
"pub_id_settings": {
"sources": [
{
"id": 12345,
"source": "sourcename",
"member_owner_id": 9325,
"status": "active"
}
]
}
}
PUT
Novedades un asociado de demanda de Prebid existente. Incluya el identificador como último componente de la ruta de acceso. Pase la información de actualización como JSON en el cuerpo de la solicitud.
Ejemplo de llamada mediante curl
curl https://api.appnexus.com/prebid/demand-partner/1234
Ejemplo de JSON
{
"id": 1234,
"name": "openx",
"enabled": 0,
"bid_cpm_adjustment": 1,
"pub_id_settings": null
}
Respuesta
Devuelve el objeto de asociado de demanda Prebid actualizado.
PATCH
Actualice parcialmente un asociado de demanda de Prebid existente. Incluya el identificador como último componente de la ruta de acceso. Pase la información de actualización como JSON en el cuerpo de la solicitud.
{
"enabled": 0,
"bid_cpm_adjustment": 1
}
Ejemplo de llamada mediante curl
curl https://api.appnexus.com/prebid/demand-partner/1234
Respuesta
Devuelve el objeto de asociado de demanda prebid actualizado.
DELETE
Elimine un asociado de demanda de Prebid existente. Incluya el identificador como último componente de la ruta de acceso.
Ejemplo de llamada mediante curl
curl https://api.appnexus.com/prebid/demand-partner/1234
Respuesta
La respuesta correcta del objeto de asociado de demanda Prebid se devuelve como un objeto JSON con la propiedad eliminada establecida en true. El asociado de prebid demand ya no estará disponible en el sistema. También se eliminarán los objetos secundarios.
Administración de orígenes de identidad
Nota:
- Cada origen de identificador debe tener permiso en el nivel de socio de microsoft, pujador (Prebid Server Premium, ID 443) y asociado de demanda para poder pasar correctamente las solicitudes a los asociados de demanda.
- Para obtener más información sobre el proceso de registro de identificadores y la administración de identificadores, consulte Identity Service API.
- En el futuro, la interfaz de usuario de Identity Management permitirá la administración holística de los permisos de identificador.
- Este servicio se encuentra actualmente en Alpha. Todavía está en desarrollo y puede estar sujeto a cambios sin previo aviso. Póngase en contacto con su representante de cuenta de Microsoft para habilitarse.