API de plataforma digital: informe de errores de puja del vendedor
El Informe de errores de puja de vendedor le ayuda a obtener información sobre la demanda rechazada a través de un conjunto seleccionado aleatoriamente del 5 % de los errores registrados en la plataforma AppNexus. El recuento de errores se ha multiplicado por 100 para tener en cuenta el muestreo del 5 %.
Use este informe para solucionar problemas de configuración de venta y de compra que dan lugar a errores de subasta, lo que bloquea el gasto. El objetivo es ayudarle a eliminar el error en el futuro. Puede encontrar información sobre el propietario, la causa y la resolución recomendada para cada error en Códigos de error de puja.
Para obtener instrucciones sobre cómo recuperar un informe, consulte Report Service o el ejemplo siguiente.
Período de tiempo
El report_interval campo de la solicitud JSON se puede establecer en uno de los siguientes:
- last_hour
- yesterday
- last_24_hours
- last_2_days
- last_7_days
- last_30_days
Para ejecutar un informe para un período de tiempo personalizado, establezca los campos y end_date en la start_date solicitud de informe. Para obtener más información sobre estos campos, vea Report Service.
Período de retención de datos
El período de retención de datos para este informe es de 403 días.
Dimensions
| Column | Tipo | ¿Filtro? | Ejemplo | Descripción |
|---|---|---|---|---|
hour |
time | No | "2010-02-01 06:00:00" |
La hora de la subasta. |
day |
time | No | "2010-02-01" |
El día de la subasta. |
error_id |
Entero | Sí | 101 |
Error específico que se produjo y se registró en ImpBus (vínculos al mensaje de error) |
error_message |
varchar | No | “Creative brand banned by member's ad profile” |
Un mensaje de error genérico que describe el error que se produjo (vincula al identificador de error) |
ad_profile_id |
Entero | Sí | 1432 |
El identificador del perfil de anuncio del miembro del vendedor afectado por el error. |
bidder_name |
Entero | No | "DBM" |
El proveedor de tecnología que representa a un miembro comprador y se ve afectado por el error. |
bidder_id |
string | Sí | 101 |
Identificador asociado al licitador |
brand_name |
string | No | "Ace Hardware" |
Marca registrada en el sistema AppNexus y asociada a la creatividad que se ve afectada por el error. |
brand_id |
Entero | Sí | 3 |
Identificador de la marca asociada a la creatividad. |
buyer_member_name |
string | No | "My Network" |
El miembro comprador afectado por el error. |
buyer_member_id |
Entero | Sí | 123 |
Identificador del miembro comprador. |
creative_category_name |
string | No | “Beauty” |
Clasificación asignada tanto a las marcas como a las creatividades afectadas por el error. |
creative_category_id |
Int | Yes | 784 |
Identificador de la categoría creativa. |
creative_id |
Entero | Yes | 554 |
Identificador creativo asociado al miembro comprador que se ve afectado por el error. |
creative_size |
string | No | "728x90" |
Tamaño de la creatividad afectada por el error. |
deal_id |
Entero | Sí | 2345 |
El identificador de la oferta afectada por el error (si Deal ID = 0 no se ha implicado ninguna transacción). |
language_name |
string | No | "English" |
Nombre del idioma. |
language_id |
Entero | Yes | 1 |
Identificador del idioma. |
placement_name |
string | No | "My placement" |
Ubicación del miembro del vendedor asociado al error. |
placement_id |
Entero | Yes | 7890 |
Identificador de la ubicación. |
publisher_name |
string | No | "Skype" |
Publicador afectado por el error. |
publisher_id |
Entero | Sí | 321 |
Identificador del publicador. |
technical_attribute_name |
string | No | "Flash" |
La característica de la creatividad, como si se trata de una imagen, flash, vídeo, es ampliable, etc., que se ve afectada por el error. |
technical_attribute_ID |
Entero | Sí | 350 |
Identificador del atributo técnico. |
Métricas
| Column | Tipo | Ejemplo | Fórmula | Descripción |
|---|---|---|---|---|
error_count |
Entero | 2340 |
sum(error_count)*100 | Cantidad de errores registrados en la plataforma AppNexus durante el período de tiempo seleccionado (un conjunto seleccionado aleatoriamente del 5 % de los errores multiplicado por 100 para tener en cuenta el muestreo). |
blocked_bid_cpm |
double | 5.68 |
sum(blocked_bid_value) / sum (error_count) | Precio de la puja bloqueada. |
Ejemplo
Creación de una solicitud de informe con formato JSON
El archivo JSON debe incluir , report_type"seller_bid_error_report"así como ( columns dimensiones y métricas) y report_interval que desea recuperar. También puede filtrar las dimensiones específicas, definir la granularidad (year, month, day) y especificar el objeto en el "format" que se deben devolver los datos (csv, excelo html). Para obtener una explicación completa de los campos que se pueden incluir en el archivo JSON, consulte Report Service.
$ cat seller_bid_error
{
"report":
{
"report_type":"seller_bid_error_report",
"columns":[
"hour",
"bidder",
"buyer_member",
"error_count"
],
"report_interval":"last_48_hours",
"format":"csv"
}
}
POST la solicitud al servicio de informes
$ curl -b cookies -c cookies -X POST -d @seller_bid_error 'https://api.appnexus.com/report'
{
"response":{
"status":"OK",
"report_id":"097f59fc3ab7d02c5d60db42081d9b69"
}
}
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=097f59fc3ab7d02c5d60db42081d9b69'
{
"response":{
"status":"OK",
"report":{
"name":null,
"created_on":"2010-05-25 19:19:53",
"json_request":"{\"report\":{\"report_type\":\"seller_bid_error_report\",\"columns\":[\"hour\",\"bidder\",
\"buyer_member\",\"error_count\",
\"report_interval\":\"last_48_hours\"}}",
"url": "report-download?id=b97897a7864dd8f34e7457226c7af592"
},
"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 servicio y el identificador de informe en el url campo de la respuesta anterior GET . Al identificar el archivo en el que desea guardar, asegúrese de usar la extensión de archivo de "format" que especificó en su inicial POST.
Sugerencia
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=b97897a7864dd8f34e7457226c7af592' > /tmp/advertiser_analytics.csv
Nota:
Hay un límite de 100 000 filas por informe cuando se descargan como archivos XLSX y Excel.