Compartir a través de

Servicio Prebid Demand Partner Params

  • Artículo

El servicio Prebid Demand Partner Params permite a los usuarios ver, agregar, quitar, habilitar y deshabilitar asociados específicos en configuraciones de PSP. Las configuraciones se administran a través del servicio de configuración. Un asociado de demanda debe estar habilitado en el Servicio de configuración entre asociados para poder agregarlo a cualquier configuración del servicio params y antes de que pueda recibir solicitudes de puja a través de Prebid Server Premium (PSP). Si se intenta agregar un asociado que no está presente en la configuración entre asociados, se producirá un error.

Nota:

Aunque un asociado se puede deshabilitar a través de este servicio en el nivel de configuración, cualquier cambio futuro en el asociado en el servicio de configuración entre asociados invalidará las configuraciones individuales y habilitará o deshabilitará el asociado en todas las configuraciones. Puede encontrar detalles sobre los parámetros admitidos por cada asociado en el servicio de esquema de partner de demanda.

API de REST

Http (método) Endpoint Description
GET - https://api.appnexus.com/prebid/prebid-demand-partner-params?prebid_settings_id={prebid_settings_id} Obtenga todos los parámetros del asociado de demanda de prebid para una configuración específica de Prebid.
GET https://api.appnexus.com/prebid/prebid-demand-partner-params/{prebidDemandPartnerParamId} Obtenga un parámetro específico del asociado de demanda de Prebid. Incluya como param ID el último componente de ruta de acceso de dirección URL.
POST https://api.appnexus.com/prebid/prebid-demand-partner-params Cree nuevos parámetros de asociados de demanda. Para ver el ejemplo y la respuesta de cURL, consulte POST la sección siguiente.
PUT https://api.appnexus.com/prebid/prebid-demand-partner-params/{prebidDemandPartnerParamId} Actualice un parámetro específico del asociado de demanda de Prebid. Incluya como param ID el último componente de la ruta de acceso de la dirección URL.
DELETE https://api.appnexus.com/prebid/prebid-demand-partner-params/{prebidDemandPartnerParamId} Elimine un parámetro específico del asociado de demanda de Prebid. Incluya como param ID el último componente de ruta de acceso de dirección URL.

GET

Devuelve todos o un conjunto específico de parámetros de asociados de demanda dentro de una configuración de PSP. Incluya ( prebid_settings_id configuración) o el identificador de los parámetros como último componente de la dirección URL.

Llamada de ejemplo mediante cURL para devolver un parámetro específico


curl --header "Content-Type: application/json" https://api.appnexus.com/prebid/prebid-demand-partner-params/{prebidDemandPartnerParamId}

Llamada de ejemplo mediante cURL para devolver todos los parámetros de una configuración específica


curl --header "Content-Type: application/json" https://api.appnexus.com/prebid/prebid-demand-partner-params?prebid_settings_id={prebid_settings_id}

Respuesta

Una respuesta correcta devolverá todos los parámetros de la configuración de Prebid solicitada o un parámetro solicitado específico.

Propiedad Tipo Descripción
deleted booleano Indica si se ha eliminado el objeto params de este asociado.
enabled booleano Indica si los parámetros del asociado de demanda de prebid están habilitados o deshabilitados.
id integer Identificador único del conjunto de parámetros asociados al asociado de demanda en la configuración de PSP.
last_modified string La fecha de modificación más reciente de los parámetros de configuración del asociado de demanda.
last_modified_by string La persona que realizó las últimas modificaciones en los parámetros de asociados de demanda.
member_id integer Identificador de miembro del llamador.
name objeto Nombre del asociado de demanda.
params objeto Objeto que contiene los parámetros admitidos por el asociado y los valores asignados. Los parámetros admitidos se pueden encontrar aquí.
prebid_settings_id integer Identificador único de la configuración de PSP.

Ejemplo de respuesta

[
  {
    "id": 1718542,
    "member_id": 13859,
    "prebid_settings_id": 196038,
    "name": "appnexus",
    "params": {
      "placement_id": 123456
    },
    "enabled": 0,
    "deleted": 0,
    "last_modified_by": "user123",
    "last_modified": "2024-08-22T21:45:05.000Z"
  }
]

POST

Permite la creación de un nuevo objeto Prebid Demand Partner Param.

Llamada de ejemplo mediante cURL

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

Solicitud JSON de ejemplo

{
    "prebid_settings_id": 196038,
    "member_id": 13859,
    "name": "adform",
    "params": {
        "inv": null,
        "mid": "11111111",
        "mname": null,
        "priceType": null
    },
    "enabled": 1
}

Parameters

Nombre Tipo Ámbito Descripción
name string Obligatorio Nombre del asociado de demanda de Prebid.
enabled booleano Obligatorio Indica si los parámetros del asociado de demanda de prebid están habilitados o deshabilitados.
member_id integer Obligatorio Identificador del miembro asociado a la configuración.
params objeto Obligatorio Objeto que contiene los parámetros admitidos por el asociado y los valores asignados. Los parámetros admitidos se pueden encontrar aquí.
prebid_settings_id integer Obligatorio Identificador único de la configuración de PSP.

POST: respuesta de ejemplo

[
  {
    "id": 1718543,
    "member_id": 13859,
    "prebid_settings_id": 196038,
    "name": "adform",
    "params": {
      "inv": null,
      "mid": "11111111",
      "mname": null,
      "priceType": null
    },
    "enabled": 1,
    "deleted": 0,
    "last_modified_by": "user123",
    "last_modified": "2024-08-22T22:40:21.000Z"
  }
]

PUT

Sobrescribe un parámetro de asociado de demanda prebid existente. Incluya como prebidDemandPartnerParamId 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.

PUT: llamada de ejemplo mediante cURL

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

Solicitud JSON de ejemplo

{
    "member_id": 13859,
    "prebid_settings_id": 196038,
    "name": "adform",
    "params": {
        "inv": null,
        "mid": "11111111",
        "mname": null,
        "priceType": null
    },
    "enabled": 0
}

PUT:Respuesta

Devuelve un objeto de parámetro de asociado de demanda Prebid.

DELETE

Elimine un parámetro de asociado de demanda 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/prebid-demand-partner-params/{prebidDemandPartnerParamId}

DELETE:Respuesta

Si se ejecuta correctamente, el objeto de parámetro prebid demand partner se devuelve como un objeto JSON con la propiedad eliminada establecida en true. Los parámetros de asociados de demanda prebid ya no estarán disponibles en el sistema. También se eliminarán los objetos secundarios.