API de informe de errores de puja del licitador

Artículo
05/18/2024

El informe de errores de puja del licitador le ayuda a obtener información sobre la demanda rechazada a través de un conjunto seleccionado aleatoriamente del 1 % de los errores registrados en la plataforma Xandr. El recuento de errores se ha multiplicado por 100 para tener en cuenta el muestreo del 1 %.

Use este informe para solucionar problemas de configuración de compra y venta 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 los ejemplos siguientes.

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
yesterday
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.

Dimensions

Column	Tipo	¿Grupo?	¿Filtro?	Ejemplo	Descripción
`hour`	time	Yes	No	`"2010-02-01 06:00:00"`	La hora de la subasta.
`day`	time	Yes	No	`"2010-02-01"`	El día de la subasta.
`error_id`	Entero	Sí	Sí	`101`	Error específico que se produjo y se registró en ImpBus (vínculos al mensaje de error).
`error_message`	Varchar	Yes	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í	Sí	`1432`	El id. de perfil de anuncio del miembro vendedor afectado por el error.
`brand_name`	string	Sí	No	`"Ace Hardware"`	Marca registrada en el sistema Xandr y asociada a la creatividad que se ve afectada por el error.
`brand_id`	Entero	Sí	Sí	`3`	Identificador de la marca asociada a la creatividad.
`buyer_member_name`	string	Sí	No	`"My Network"`	El miembro comprador que se ve afectado por el error.
`buyer_member_id`	Entero	Sí	Sí	`123`	Identificador del miembro comprador.
`creative_category_name`	string	Sí	No	`“Beauty”`	Clasificación asignada tanto a las marcas como a las creatividades afectadas por el error.
`creative_category_id`	Entero	Sí	Sí	`784`	Identificador de la categoría creativa.
`creative_code`	Entero	Sí	Sí	`485`	Código creativo (identificador de creatividad interno) asociado a la creatividad que se ve afectado por el error.
`creative_id`	Entero	Sí	Sí	`554`	Identificador creativo asociado al miembro comprador que se ve afectado por el error.
`creative_size`	string	Sí	No	`"728x90"`	Tamaño de la creatividad afectada por el error.
`deal_id`	Entero	Sí	Sí	`2345`	El identificador de la oferta afectado por el error (si id. de oferta = 0 no se ha implicado ninguna oferta).
`language_name`	string	Sí	No	`"English"`	Nombre del idioma.
`language_id`	Entero	Sí	Sí	`1`	Identificador del idioma.
`publisher_id`	Entero	Sí	Sí	`321`	Identificador del publicador.
`seller_member_name`	string	Sí	No	`"NYTimes"`	El miembro del vendedor que se ve afectado por el error.
`seller_member_id`	Entero	Sí	Sí	`123`	Id. del miembro del vendedor.
`technical_attribute_name`	string	Sí	No	`“Flash”`	Característica de la creatividad, como si se trata de una imagen, flash, vídeo, es ampliable, etc. afectada por el error.
`technical_attribute_id`	Entero	Sí	Sí	`350`	Identificador del atributo técnico.
`buyer_seat_code`	string	Sí	No	`"123abc"`	El id. de asiento del comprador personalizado (enviado por DSP) que se usó para pujar por la impresión.
`buyer_seat_name`	string	Sí	No	`"123abc (dsp name)"`	Nombre para mostrar del código de asiento del comprador.

Métricas

Column	Tipo	Ejemplo	Fórmula	Description
`error_count`	Entero	`2340`	sum(error_count)*100	Cantidad de errores registrados en la plataforma Xandr durante el período de tiempo seleccionado (un conjunto seleccionado aleatoriamente del 1% de los errores multiplicado por 100 para tener en cuenta el muestreo).

Ejemplos

Create la solicitud de informe con formato JSON

El archivo JSON debe incluir , report_typebidder_bid_error_reportasí como ( columns dimensiones y métricas) y report_interval que desea recuperar. También puede filtrar por dimensiones específicas, definir granularidad (year, month, day) y especificar el formato en el 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 bidder_bid_error
{
        "report":
        {
                "report_type":"bidder_bid_error_report",
                "columns":[
                        "hour",
                        "seller_member_name",
                        "error_count"
                ],
                "report_interval":"last_24_hours",
                "format":"csv"
        }
}

`POST` la solicitud al servicio de informes

$ curl -b cookies -c cookies -X POST -d @bidder_bid_error 'https://api.adnxs.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.adnxs.com/report?id=097f59fc3ab7d02c5d60db42081d9b69'
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2010-05-25 19:19:53",
         "json_request":"{\"report\":{\"report_type\":\"bidder_bid_error_report\",\"columns\":[\"hour\",
            \"seller_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.

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.adnxs.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/bidder_bid_error.csv

Compartir a través de

API de informe de errores de puja del licitador

Período de tiempo

Dimensions

Métricas

Ejemplos

Create la solicitud de informe con formato JSON

`POST` la solicitud al servicio de informes

`GET` estado del informe del servicio de informes

`GET` los datos del informe del servicio de descarga de informes

Recursos adicionales

Compartir a través de

API de informe de errores de puja del licitador

Período de tiempo

Dimensions

Métricas

Ejemplos

Create la solicitud de informe con formato JSON

POST la solicitud al servicio de informes

GET estado del informe del servicio de informes

GET los datos del informe del servicio de descarga de informes

Recursos adicionales

`POST` la solicitud al servicio de informes

`GET` estado del informe del servicio de informes

`GET` los datos del informe del servicio de descarga de informes