Servicio de partner de demanda

El servicio de asociado de demanda devuelve todos los asociados de demanda del miembro de la persona que llama. Permite al usuario crear un nuevo asociado de demanda y actualizar o eliminar un asociado de demanda existente.

En el contexto de PSP, los socios de demanda, generalmente plataformas del lado de la oferta (SSP) como, crean adaptadores para Prebid Server que reciben e interpretan solicitudes de anuncios de ofertas de encabezado. Los socios de demanda llevan a cabo una subasta entre sus fuentes de demanda (normalmente, plataformas del lado de la demanda [DSP]) para recopilar las pujas de esas solicitudes de anuncios y enviarlas de vuelta a PSP, que realiza otra subasta.

Antes de que se pueda agregar un partner de demanda a una configuración, debe habilitarse a través de este servicio o a través de la interfaz de usuario. Al establecer un partner de demanda en enabled: 0 pausa todas las solicitudes de puja dirigidas a ese partner en todas las configuraciones hasta que la configuración se restaure a 1. La lista de socios de demanda compatibles con PSP se puede encontrar aquí.

API de REST

Método HTTP Endpoint Description
GET https://api.appnexus.com/prebid/demand-partner Obtenga todos los partners de demanda.
POST https://api.appnexus.com/prebid/demand-partner Crear un nuevo partner de demanda.
PUT https://api.appnexus.com/prebid/demand-partner/{id} Actualizar un partner de demanda existente.
PATCH https://api.appnexus.com/prebid/demand-partner/{id} Actualizar una parte de un partner de demanda existente.
DELETE https://api.appnexus.com/prebid/demand-partner/{id} Eliminar un partner de demanda.

GET

Obtenga todo o un partner de demanda específico. Para recuperar un partner de demanda específico, anexe el id. del asociado de demanda como último componente de la ruta de acceso de la dirección URL. Devuelve una matriz JSON de objetos asociados a la demanda.

Respuesta

Propiedad Tipo Descripción
bid_cpm_adjustment integer Un valor multiplicador aplicado al precio de oferta de CPM del socio de demanda para ajustar cómo compiten las ofertas en la subasta. Esto no cambia la oferta real ni el pago de ingresos, solo la clasificación de la oferta en la subasta. El valor predeterminado es 1,00. En este caso, las ofertas de todos los socios compiten por igual sin ajustes. El ajuste se puede utilizar para tener en cuenta las tarifas de los socios o para la optimización. Si necesita ajustes de CPM a un nivel más granular que el de Demand Partner, consulte Crear una regla de sesgo.
deleted integer Esto indica que el objeto de asociado de demanda se ha eliminado del sistema. Los valores permitidos son:
0 = activo,
1 = eliminado
enabled integer Indica si el asociado de demanda está habilitado o deshabilitado. Los valores permitidos son:
0 = deshabilitado,
1 = habilitado
id integer El ID del socio de demanda específico del miembro de la persona que llama.
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 El id. del miembro.
name string El nombre del asociado de demanda.
pub_id_settings objeto Las opciones relevantes para los identificadores de usuario proporcionados por el editor. Consulte la tabla de configuración de identificador proporcionada por el editor a continuación.

Configuración de id. proporcionada 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": 0,
        "enabled": 1,
        "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": 0,
        "enabled": 1,
        "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": 0,
        "enabled": 1,
        "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": 0,
        "enabled": 1,
        "id": 69,
        "last_modified": "2018-11-02T18:32:31Z",
        "last_modified_by":"user123",
        "member_id": 9325,
        "name": "ix",
        "pub_id_settings": null
    }
]

POST

Crear un nuevo partner de demanda.

Ejemplo de llamada con 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 El ajuste de CPM de la oferta.
enabled integer Obligatorio Indica si el asociado de demanda está habilitado o deshabilitado. Los valores permitidos son:
0 = deshabilitado,
1 = habilitado
name string Obligatorio El nombre del asociado de demanda.
pub_id_settings objeto Obligatorio Las opciones relevantes para los identificadores de usuario proporcionados por el editor. Consulte la tabla de configuración de id. proporcionada por el editor anterior.

JSON de ejemplo

{
    "bid_cpm_adjustment": 1,
    "enabled": 1,
    "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": 0,
    "enabled": 1,
    "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 de un partner 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 con 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

Actualizar parcialmente un partner 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 con curl

curl https://api.appnexus.com/prebid/demand-partner/1234

Respuesta

Devuelve el objeto de asociado de demanda Prebid actualizado.

DELETE

Eliminar un partner de demanda de Prebid existente. Incluya el identificador como último componente de la ruta de acceso.

Ejemplo de llamada con curl

curl https://api.appnexus.com/prebid/demand-partner/1234

Respuesta

La respuesta correcta del objeto asociado de demanda Prebid se devuelve como un objeto JSON con la propiedad eliminada establecida en true. El partner de demanda de Prebid dejará de estar disponible en el sistema. También se eliminarán los subobjetos.

Administrar orígenes de identidad

Nota:

  • Cada origen de identificador debe tener permiso en el nivel de miembro de Microsoft, ofertante (Prebid Server Premium, ID 443) y asociado de demanda para pasar correctamente las solicitudes a socios de demanda.
  • Para obtener más información sobre el proceso de registro de identificadores y la administración de identificadores, revise la API de servicio de identidad.
  • En el futuro, la interfaz de usuario de administración de identidades permitirá una administración holística de los permisos de identificador.
  • Actualmente, este servicio está en fase alfa. Todavía está en desarrollo y puede estar sujeto a cambios sin previo aviso. Póngase en contacto con el representante de la cuenta de Microsoft para habilitarlo.
  • Last updated on