Prebid Server Premium Health Analytics
El informe de análisis de estado de Prebid Server Premium (PSP) permite a los usuarios analizar datos relacionados con las solicitudes de puja y las transacciones con sus asociados de demanda configurados. Esto es más útil para solucionar problemas conocidos e identificar proactivamente oportunidades de optimización.
Nota:
El panel se basa en datos de ejemplo multiplicados para calcular el volumen completo de la actividad de PSP. No está pensado para usarse para la entrega y la generación de informes de ingresos. El informe de prebid Server Premium Seller Analytics y otros informes de Monetización de Microsoft deben usarse para esos fines.
Período de tiempo
El report_interval campo de la solicitud JSON se puede establecer en uno de los siguientes:
- last_hour
- last_24_hours
- last_48_hours
- hoy
- yesterday
- last_2_days
- last_7_days
- last_14_days
- last_30_days
- month_to_date
- last_month
- month_to_yesterday
- quarter_to_date
- vida
El time_granularity valor de los datos es por hora. Para obtener instrucciones sobre cómo recuperar un informe, consulte el Servicio de informes o los ejemplos siguientes.
Período de retención de datos
El período de retención de datos para este informe es de 99 días.
Dimensions
| Column | Tipo | ¿Filtro? | Ejemplo | Descripción |
|---|---|---|---|---|
ad_size |
string | sí | 300x250 |
Las dimensiones de la ranura del anuncio. |
allowed_media_types_bitmap_name |
string | no | "Banner" |
Categoría de creatividad habilitada por el publicador en la ubicación Monetizar. Por ejemplo: banner, vídeo, nativo. |
application_id |
string | sí | "vizio.pluto" |
La aplicación específica que se usa en el dispositivo. |
bid_error_type |
Entero | sí | 21 |
Identificador de la categoría de error relacionada con la respuesta de la puja. Para obtener más detalles, consulte la tabla Tipos de error de solicitud de puja a continuación. |
bid_error_type_name |
string | no | "NO_BID_PRICE" |
Categoría de error relacionada con la respuesta de la puja. Para obtener más detalles, consulte la tabla Tipos de error de solicitud de puja a continuación. |
bid_reject_error_code |
string | sí | "31" |
Error específico generado a partir de la respuesta de puja del asociado de demanda. Consulte los códigos de error de la oferta para ver las descripciones y la posible resolución de cada valor. |
bidder_id |
Entero | sí | 443 |
El identificador del licitador (443). |
bidder_name |
string | no | Prebid Server |
Nombre del licitador (servidor prebid). |
browser_code_id |
Entero | sí | 5414 |
Identificador de la versión específica del explorador. |
browser_code_name |
string | no | "da-chrome-107.0" |
Nombre de la versión específica del explorador. |
call_type |
string | sí | /ut/v3/prebid |
Tipo de controlador que se usa para enviar la solicitud de puja a Monetizar "(por ejemplo, /ut/v3/prebid, openrtb2/prebid)". |
cookies_present |
booleano | sí | sí | Indica si una cookie estaba presente o no en la solicitud de puja. |
datacenter_id |
string | sí | "ams3" |
Identificador del centro de datos usado para enrutar la solicitud a asociados de demanda. |
day |
date | sí | "2018-02-01" |
El día de la subasta. |
demand_partner |
string | no | "PubMatic (PSP) (9645)" |
Cadena que consta del nombre y el identificador del asociado de demanda. |
demand_partner_id |
Entero | sí | 9645 |
Identificador del asociado al que se envió la solicitud y desde el que se recibió la respuesta (si la hubiera). |
demand_partner_name |
string | no | "PubMatic (PSP)" |
Nombre del asociado al que se envió la solicitud y desde el que se recibió la respuesta (si la hubiera). |
device_browser_id |
Entero | sí | 8 |
Identificador del explorador usado en el dispositivo. Por ejemplo, Chrome, Safari, etc. |
device_browser_name |
string | no | "Chrome (all versions)" |
Nombre del explorador usado en el dispositivo. Por ejemplo, Chrome, Safari, etc. |
device_os_extended_id |
Entero | sí | 137 |
Identificador de la versión específica del sistema operativo. Por ejemplo, iOS 16.0.0. |
device_os_extended_name |
string | no | "Windows 10" |
Nombre de la versión específica del sistema operativo. Por ejemplo, iOS 16.0.0. |
device_os_family |
string | no | "Android (2)" |
Cadena que consta del nombre y el identificador de la familia del sistema operativo del dispositivo. |
device_os_family_id |
Entero | sí | 2 |
Identificador del sistema operativo del dispositivo. Por ejemplo, Microsoft Windows, Apple iOS, etc. |
device_os_family_name |
string | no | "Android" |
Nombre del sistema operativo del dispositivo. Por ejemplo, Microsoft Windows, Apple iOS, etc. |
device_type_id |
Entero | sí | 1 |
La categoría del dispositivo: - 0 = Desconocido- 1 = equipos de escritorio & portátiles- 2 = teléfonos móviles- 3 = Tableta- 4 = tv- 5 = consolas de juegos- 6 = reproductores multimedia- 7 = set top box |
device_type_name |
string | sí | "mobile phones" |
Nombre de la categoría de dispositivo (equipos de escritorio & portátiles, teléfonos móviles, etc.). |
external_creative_id |
string | sí | 987654 |
Identificador externo asociado a la creatividad servida. |
geo_country |
string | sí | "US" |
El código del país en el que se sirvió la impresión. Por ejemplo, EE. UU. |
geo_country_name |
string | No | "United States" |
El nombre del país en el que sirvió la impresión. Por ejemplo, Estados Unidos. |
hour |
date | no | "2018-02-01-09:54" |
La hora de la subasta. |
inventory_url |
string | no | "myurl.com/(1234)" |
Dirección URL asignada del dominio detectado en la llamada de anuncio y el identificador entre paréntesis. |
inventory_url_id |
string | sí | 1234 |
Identificador de dirección URL asignado del dominio detectado en la llamada de anuncio. |
inventory_url_name |
string | sí | 1234 |
Dirección URL asignada del dominio detectado en la llamada de anuncio. |
media_type |
string | no | "Banner" |
Categoría de creatividad en impresiones con transacciones. Por ejemplo: banner, vídeo, nativo. |
media_type_id |
Entero | sí | 1 |
Identificador de la categoría de creatividad en impresiones con transacciones. |
month |
date | no | "2018-02" |
El mes de la subasta. |
placement_id |
Entero | sí | 456 |
Identificador de la ubicación a través de la que se originó la solicitud. |
placement_name |
string | no | "My Placement" |
Nombre de la ubicación a través de la que se originó la solicitud. |
psp_config_id |
Entero | sí | 10000 |
Identificador único de la configuración de PSP a través del servicio de configuración. Actualmente solo se pueden notificar en bid_responses_received, valid_bid_on_impsy imps_delivered. Se actualizará para cubrir otras métricas en el futuro. |
publisher_id |
Entero | sí | 789 |
Identificador del publicador en el que se originó la solicitud en el inventario. |
publisher_name |
string | no | "Neat Publisher Ltd" |
Nombre del publicador en el que se originó la solicitud en el inventario. |
sdk_version |
string | sí | "pbjs-5.20.3" |
Versión del kit de desarrollo de software presente en la aplicación. |
seller_member_id |
Entero | sí | 123 |
El identificador del miembro del vendedor. |
seller_member_name |
string | no | "Cool Seller Inc" |
Nombre del miembro del vendedor. |
site_id |
Entero | sí | 555 |
Identificador del sitio en el que se originó la solicitud. |
site_name |
string | no | "My Site" |
Nombre del sitio en el que se originó la solicitud. |
supply_type |
string | sí | "web" |
Categoría de inventario (web, web móvil o aplicación). La aplicación incluye CTV y móvil. |
uap_response_error_type_id |
string | sí | TIMEOUT |
Error específico generado a partir de la solicitud de puja. Consulte la tabla de tipos de error de solicitud de puja de solicitud de puja a continuación para obtener una descripción y una posible resolución de cada valor. |
Métricas
| Column | Tipo | Fórmula | Ejemplo | Descripción |
|---|---|---|---|---|
average_clear_price |
double | Consulte Descripción. | 1.00 |
La suma del precio de la oferta para las impresiones entregadas dividida por el número de solicitudes de puja enviadas. |
average_response_time |
double | bid_responses_received/bid_requests_sent. | 0.08 |
El número de respuestas de puja recibidas de los asociados de demanda dividido por el número de solicitudes de puja enviadas. |
bid_errors |
Entero | Consulte Descripción. | 149908040 |
Número de errores en las respuestas de la oferta de los asociados de demanda. |
bid_errors_rate |
double | bid_errors/bid_requests_sent | 0.04 |
El número de errores de puja dividido por el número de solicitudes de puja enviadas a los asociados de demanda. |
bid_request_error_rate |
double | bid_request_errors/bid_requests_sent | 0.05 |
El número de errores de solicitud de puja dividido por el número de solicitudes de puja enviadas a los asociados de demanda. |
bid_request_errors |
Entero | Consulte Descripción. | 200 |
Número de errores específicos generados a partir de las solicitudes de puja. Consulte la tabla de tipos de error de solicitud de puja a continuación para obtener una descripción y una posible resolución de cada valor. |
bid_requests_sent |
Entero | Consulte Descripción. | 3990674680 |
Número de solicitudes enviadas desde Prebid Server Premium a los asociados de demanda. |
bid_rejection_error_rate |
Entero | bid_rejection_errors/bid_responses_received | 0.06 |
El número de errores de rechazo de ofertas dividido por el número de respuestas de puja recibidas de los asociados de demanda. |
bid_rejection_errors |
Entero | Consulte Descripción. | 300 |
Número de errores específicos de la respuesta de puja del partner de demanda. Consulte los códigos de error de la oferta para obtener una descripción y una posible resolución de cada valor. |
bid_rate |
Entero | bid_responses_received/bid_requests_sent | 0.08 |
El número de respuestas de puja recibidas de los asociados de demanda dividido por el número de solicitudes de puja enviadas. |
bid_responses_received |
Entero | Consulte Descripción. | 381809500 |
Número de errores específicos de la respuesta de puja del partner de demanda. Consulte los códigos de error de la oferta para obtener una descripción y una posible resolución de cada valor. |
bids_submitted_to_ad_server |
Entero | Consulte Descripción. | 54021580 |
Número de solicitudes de anuncios que tenían una oferta válida de Prebid que no estaba sujeta a ningún rechazo adicional de Microsoft devuelto al servidor de anuncios. Este número se cuenta después del proceso de subasta de Microsoft que evalúa las ofertas recibidas de todos los orígenes. La reducción del volumen entre valid_bid_on_imps y esta métrica podría deberse a que no se cumplen los requisitos creativos, a que otros licitadores lo superen o a la opción de enviar solo la puja superior al servidor de anuncios. |
bidder_user_matched_requests |
Entero | Consulte Descripción. | 1849169240 |
Número de solicitudes en las que estaba presente un identificador de usuario. Nota: Actualmente, esta métrica solo incluye cookies para web y web móvil. |
imps_delivered |
Entero | Consulte Descripción. | 4804540 |
Número de impresiones entregadas correctamente y anuncios representados. Nota: Este informe se basa en datos de registro de ejemplo multiplicados para calcular el volumen completo de la actividad de PSP y no representa la entrega final. |
no_bid_rate |
double | no_bids/bid_requests_sent | 0.87 |
El número de veces que los partners de demanda no pujaron dividido por el número de solicitudes de puja enviadas a los asociados de demanda. |
no_bids |
Entero | Consulte Descripción. | 3461831640 |
El número de veces que los asociados de demanda no pujaron por una solicitud. Esto no incluye errores de puja. |
total_bid_price |
Entero | Consulte Descripción. | 171869242 |
Suma de los valores de puja recibidos de Demand Partners. |
total_buyer_spend |
double | Consulte Descripción. | 11234.88 |
El costo multimedia para los compradores de impresiones entregadas. Nota: Este informe se basa en datos de registro de ejemplo multiplicados para calcular el volumen completo de la actividad de PSP y no representa la entrega final. |
user_matched_requests_rate |
double | bidder_user_matched_requests/bid_requests_sent | 0.46 |
El número de solicitudes coincidentes del usuario divididas por el número de solicitudes de puja enviadas a los asociados de demanda. |
valid_bid_on_imps |
Entero | Consulte Descripción. | 378935000 |
El número de ofertas recibidas de los partners de demanda de PSP que no desencadenan errores, tienen un identificador creativo y tienen una oferta superior a 0 USD. Puede haber varias pujas contabilizadas para cada subasta cuando varios socios de demanda de PSP devuelvan ofertas. |
valid_bids_on_imp_rate |
double | valid_bid_on_imps/bid_responses_received | 0.09 |
El número de pujas válidas divididas por el número de solicitudes de puja enviadas a los asociados de demanda. |
win_rate |
double | imps_delivered/bid_responses_received | 0.01 |
Esta métrica solo debe usarse con la dimensión de asociado de demanda aplicada. Representa el porcentaje de impresiones entregadas por un asociado de demanda en relación con el total de respuestas de puja recibidas. El cálculo implica dividir el número de impresiones entregadas por el asociado de demanda por el número total de respuestas de puja recibidas. |
Tipos de error de solicitud de puja
| Código | Error | Descripción | Solución |
|---|---|---|---|
| 0 | NONE |
Sin error. | No se necesita ninguno. |
| 1 | INTERNAL |
Hay un error del lado servidor del asociado de demanda, como un código de estado 400. | El vendedor debe trabajar con Microsoft para recopilar un código de ejemplo específico para compartirlo con el partner de demanda para su investigación. |
| 2 | TIMEOUT |
Demand Partner no respondió dentro del límite de tiempo de espera. | Aumente la configuración de tiempo de espera para permitir un tiempo de respuesta más largo o póngase en contacto con el asociado de demanda para informarle de la restricción. Para obtener más información sobre los tiempos de espera, consulte Agregar o editar la configuración global de PSP. |
| 3 | CLIENT |
El adaptador de servidor prebid del asociado de demanda generó un error. | Para obtener cantidades significativas de este tipo de error, el vendedor debe ponerse en contacto con el soporte técnico de Microsoft para diagnosticar problemas examinando los registros internos de Microsoft. Un ejemplo de este error podría ser que la fuente de vídeo se ha enviado a un adaptador que no lo admite. |
| 4 | PARSE |
Demand Partner ha dado formato incorrecto a la respuesta de la puja. | El vendedor debe trabajar con Microsoft y el asociado de demanda para determinar y resolver el problema de formato específico. |
Nota:
Para ver los tipos de error de respuesta de puja, consulte Códigos de error de puja.
Ejemplos
Creación de una solicitud de informe con formato JSON
El archivo JSON debe incluir el report_type de "psp_health_analytics", así como las columnas (dimensiones y métricas) y report_interval que desea recuperar. También puede filtrar por dimensiones específicas, definir granularidad (, , ) y especificar en el "format" que se deben devolver los datos ("csv", "excel"o "html"). daymonthyear Para obtener una explicación completa de los campos que se pueden incluir en el archivo JSON, consulte Report Service.
$ cat psp_health_analytics
{"report":
{
"format": "csv",
"report_interval": "yesterday",
"columns": ["hour", "publisher_id","site_id","header_bidding_demand_partner", "imps", "seller_revenue", "view_rate"],
"report_type": "psp_health_analytics"
}
}
POST la solicitud al servicio de informes
POST la solicitud JSON para recuperar un identificador de informe.
$ curl -b cookies -c cookies -X post -d @psp_health_analytics "https://api.appnexus.com/report"
{
"response":{
"status":"OK",
"report_id":"97a181df6d77a8f3cd5a45eff4ea3dab"
}
}
GET estado del informe del servicio de informes
Realice una GET llamada con el identificador de informe para recuperar el estado del informe. Continúe realizando esta GET llamada hasta que execution_status sea "ready". A continuación, use el servicio de descarga de informes para guardar los datos del informe en un archivo, como se describe en el paso siguiente.
$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=97a181df6d77a8f3cd5a45eff4ea3dab'
{
"response": {
"status": "OK",
"report": {
"name": null,
"created_on": "2014-11-19 21:57:00",
"json_request": "{\"report\":{\"format\":\"csv\",\"report_interval\":\"yesterday\",\"row_per\":[\"publisher_id\"],\"columns\":[\"hour\", \"publisher_id\",\"site_id\",\"header_bidding_demand_partner\",\"imps\",\"seller_revenue\", \"view_rate\"],\"report_type\":\"psp_health_analytics\"
"url": "report-download?id=97a181df6d77a8f3cd5a45eff4ea3dab"
},
"execution_status": "ready"
}
}
GET los datos del informe del servicio de descarga de informes
Para descargar los datos del informe en un archivo, realice otra GET llamada con el identificador de informe, pero esta vez al servicio de descarga de informes . Puede encontrar el identificador de servicio e informe en el url campo de la respuesta a la llamada anterior GET . Al identificar el archivo en el que desea guardar, asegúrese de usar la extensión de archivo del formato de archivo que especificó en la inicial POST.
Nota:
Si se produce un error durante la descarga, el encabezado de respuesta incluirá un código de error HTTP y un mensaje. Use -i o -v en la llamada para exponer el encabezado de respuesta.
curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=97a181df6d77a8f3cd5a45eff4ea3dab' > /tmp/psp_health_analytics.csv
Nota:
Hay un límite de 100 000 filas por informe cuando se descargan como archivos XLSX y Excel.