Prebid Server Premium Seller Analytics
El informe de Prebid Server Premium Seller Analytics contiene información de rendimiento sobre los asociados de demanda Prebid Server Premium (PSP) configurados. Con este informe, puede hacer lo siguiente:
- Realice un seguimiento de los ingresos mediante el encabezado del partner de demanda del licitador, el publicador o la región geográfica.
- Realice un seguimiento de la elevación en el inventario que ha abierto a la demanda de pujas de encabezado.
- Supervise el estado y la eficiencia de los asociados y ubicaciones de Prebid Server Premium.
Para obtener información sobre otros informes a través de la API, consulte Report Service. Para obtener información sobre el acceso a los datos a través de la interfaz de usuario, consulte la Guía de informes para el informe de Análisis de vendedores premium de Microsoft Monetize y Prebid Server.
Período de tiempo
El report_interval campo de la solicitud JSON se puede establecer en uno de los siguientes:
- last_hour
- last_48_hours
- hoy
- yesterday
- last_7_days
- month_to_date
- quarter_to_date
- last_month
- Vida
- month_to_yesterday
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 30 días.
Dimensions
| Column | Tipo | ¿Filtro? | Ejemplo | Descripción |
|---|---|---|---|---|
hour |
date | no | "2018-02-01-09:54" |
La hora de la subasta. |
month |
date | no | "2018-02" |
El mes de la subasta. |
day |
date | sí | "2018-02-01" |
El día de la subasta. |
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. |
tag_id |
Entero | sí | 456 |
Identificador de la etiqueta de selección de ubicación. |
publisher_id |
Entero | sí | 789 |
Identificador del publicador. |
publisher_name |
string | no | "Neat Publisher Ltd" |
Nombre del publicador. |
publisher |
string | no | "Neat Publisher Ltd (789)" |
Cadena que consta del nombre del publicador y el identificador del publicador. |
size |
string | sí | 300x250 |
Ancho y alto de la posición asociada a la impresión. |
geo_country |
string | sí | "US" |
Abreviatura de país. |
geo_country_name |
string | no | "United States" |
Nombre del país geográfico. |
site_id |
Entero | sí | 555 |
Identificador del sitio. Para obtener más información, consulte El servicio de sitio. |
site_name |
string | no | "My Site" |
Nombre del sitio. Para obtener más información, consulte El servicio de sitio. |
site |
string | no | "My Site (555)" |
Cadena que contiene el nombre y el identificador del sitio. Para obtener más información, consulte El servicio de sitio. |
tag_name |
string | no | "My Placement" |
Nombre de la etiqueta asociada a la impresión. |
header_bidding_demand_partner_id |
Entero | no | 9645 |
Identificador del asociado de demanda asociado a la ubicación. |
header_bidding_demand_partner_name |
string | no | "PubMatic (PSP)" |
Asociado de demanda asociado a la ubicación. |
header_bidding_demand_partner |
string | no | "PubMatic (PSP) (9645)" |
El nombre y el identificador del asociado de demanda asociado a la ubicación. |
included_header_bidding_demand |
Entero | sí | 654 |
La demanda incluida de asociados de demanda que no son de Xandr. |
Métricas
| Column | Tipo | Ejemplo | Fórmula | Description |
|---|---|---|---|---|
imps |
Entero | 34534 |
Duendes | Número total de impresiones (incluidos los valores predeterminados). |
seller_revenue |
Dinero | 999.99 |
total de ingresos del vendedor | Los ingresos del vendedor en la transacción, representados como una cantidad en dólares. |
seller_ecpm |
Dinero | 1.00 |
Consulte Descripción | Los ingresos del vendedor en la oferta, representados en eCPM. |
view_measured_imps |
Entero | 1500 |
Consulte Descripción | Número total de impresiones que se midieron para la visibilidad. |
view_rate |
double | 87.00 |
imps_viewed/view_measured_imps | Porcentaje de impresiones que se pudieron ver del número total de impresiones medidas para la visibilidad. |
view_measurement_rate |
Entero | 91.00 |
view_measured_imps/imps | Porcentaje de impresiones medidas para la visibilidad del número total de impresiones. |
imps_viewed |
Entero | 1100 |
Consulte Descripción | Número de impresiones visibles para la ubicación. |
ad_requests |
Entero | 1200 |
Consulte Descripción | Número de solicitudes de anuncios asociadas a la ubicación. |
fill_rate |
double | 85.00 |
Impresiones guardadas + impresiones revendidas / número total de impresiones | Porcentaje de solicitudes de anuncios que se llenaron con demanda. (Impresiones guardadas y impresiones revendidas / número total de impresiones). |
Ejemplos
Create solicitud de informe con formato JSON
El archivo JSON debe incluir el report_type de "prebid_server_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 prebid_server_analytics
{"report":
{
"format": "csv",
"report_interval": "yesterday",
"columns": ["hour", "publisher_id","site_id"," "header_bidding_demand_partner", "imps", "seller_revenue", "view_rate"],
"report_type": "prebid_server_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 @prebid_server_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\":\"prebid_server_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/prebid_server_analytics.csv
Nota:
Hay un límite de 100 000 filas por informe cuando se descargan como archivos XLSX y Excel.