Servicio de configuración

Una vez que se ha integrado el inventario con Prebid Server Premium (PSP), se ha revisado la configuración entre asociados y se han habilitado los asociados de demanda , el inventario debe asignarse a los asociados de demanda a través de configuraciones de PSP. Estas asignaciones permiten a PSP enviar solicitudes de puja con los parámetros de los asociados de demanda para que los asociados puedan identificar el inventario y representarlo mejor a 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 tiene como destino una parte del inventario del publicador en Monetizar mediante una o varias dimensiones, como la ubicación, el grupo de selección de ubicación, el publicador, la geografía, el tipo de inventario o el valor de clave.
• Cada configuración incluye uno o más asociados de demanda a los que el publicador quiere pujar en el inventario.
• Cada asociado de demanda especifica los parámetros obligatorios y opcionales que desea recibir en su adaptador de Prebid Server Go de código abierto, que se exponen en PSP. Permiten que el asociado coincida con la solicitud de puja con los objetos de su plataforma.
• Los publicadores rellenan parámetros de asociados de demanda con valores asignados a objetos de la plataforma de cada asociado, normalmente otra plataforma del lado de la oferta (SSP)

Requisitos de asociados de demanda

Todos los asociados de demanda que el publicador desea pujar 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 asociados de demanda de PSP planeados para determinar una estrategia de asignación. Algunos asociados extraen información dinámicamente de la solicitud de puja (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 asociado de demanda requiere una asignación muy pormenorizada a los objetos de su plataforma, esto determinará cómo se asignan otros asociados y cuántas configuraciones son necesarias. Cuanto mejor pueda identificar el inventario un partner de demanda (ya sea a través de la solicitud de puja o de los parámetros estáticos de preinserción), más información puede proporcionar a sus compradores, lo que aumenta los ingresos del publicador.

Se pueden encontrar parámetros de asociados de demanda:

• 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 , que proporciona el contexto completo y los detalles.
• En el servicio de esquema de asociados de demanda de PSP.

En la documentación siguiente se 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 llamador. Los resultados se devuelven como JSON.

Parameters

Llamada de ejemplo mediante curl con argumentos de filtro de estado

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

Llamada de ejemplo mediante curl para devolver una configuración específica

Anexe el identificador de configuración como el ú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á JSON que contiene la configuración entre asociados del miembro y todas sus configuraciones de PSP. Incluir un elemento específico prebidSettingsId en la cadena de consulta dará lugar a una respuesta que contenga solo esa configuración.

Configuración del asociado de demanda

Propiedades de configuración

Propiedades de metadatos de destino

Propiedades de configuración de asociados de demanda

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

Paginación

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

Llamada de ejemplo 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"
                }
            ]
        },
        {
            "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"
                }
            ]
        }
    ]
}
       

POST

Habilita la creación de un nuevo objeto configurations. 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 mediante curl

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

POST: Parámetros

POST: Propiedades de configuración de asociados de demanda

POST: Propiedades de metadatos de destino

Solicitud JSON de ejemplo

{
    "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: Respuesta JSON de ejemplo

{
    "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

Sobrescriba una configuración de Prebid existente. Incluya como prebidSettingsId el último componente de la ruta de acceso de la dirección 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: llamada de ejemplo mediante curl

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

PUT: solicitud JSON de ejemplo

{
    "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

Actualice parcialmente una configuración de Prebid existente. Incluya como prebidSettingsId ú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: llamada de ejemplo mediante curl

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

PATCH: solicitud JSON de ejemplo

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

PATCH: respuesta

Devuelve un objeto de configuración Prebid.

DELETE

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

DELETE: llamada de ejemplo mediante curl

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

DELETE: respuesta

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

Temas relacionados

• Servicio objetos de campaña de PSP
• Servicio de esquema de asociados de demanda
• Demand Partner Service
• Servicio Prebid Demand Partner Params
• Servicio de tamaños de anuncios
• Servicio de tipo multimedia
• Servicio de configuración entre asociados
• Creación de una nueva configuración de PSP
• Prebid Server Premium Demand Partner Integrations
• Problemas comunes y procedimientos recomendados