API de plataforma digital: informe de errores de puja del comprador

Artículo
05/18/2024

El informe de errores de puja del comprador le ayuda a 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. El informe de errores de puja del comprador 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 Xandr. El recuento de errores se ha multiplicado por 100 para tener en cuenta el muestreo del 5 %.

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:

costumbre
last_hour
hoy
last_24_hours
yesterday
last_2_days
last_7_days
last_30_days

Período de retención de datos

Los datos de este informe se conservan durante 33 días.

Nota:

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	¿Filtro?	Ejemplo	Descripción
`ad_profile_id`	Entero	Yes	`1432`	El identificador del perfil de anuncio del miembro del vendedor afectado por el error.
`bidder_id`	string	Sí	`101`	Identificador asociado al pujador.
`bidder_name`	Entero	No	`“DBM”`	El proveedor de tecnología que representa a un miembro comprador y se ve afectado por el error.
`brand`	string	No	`"Ace Hardware(3)"`	El nombre y el identificador de la marca.
`brand_id`	Entero	Yes	`3`	Identificador de la marca asociada a la creatividad.
`brand_name`	string	No	`"Ace Hardware"`	Marca registrada en el sistema Xandr y asociada a la creatividad que se ve afectada por el error.
`buyer_member_id`	Entero	Yes	`123`	Identificador del miembro comprador.
`buyer_member_name`	string	No	`"My Network"`	El miembro comprador afectado por el error.
`buyer_seat_code`	string	No	`"SCID001"`	El identificador de asiento del comprador personalizado (enviado por DSP) que se usó para pujar por la impresión
`buyer_seat_id`	Entero	Yes	`350`	Identificador del asiento del miembro comprador que se ve afectado por el error.
`buyer_seat_name`	string	No	`"FirstSeatCodeID"`	Nombre para mostrar del código de asiento del comprador.
`creative_category_id`	Int	Yes	`784`	Identificador de la categoría creativa.
`creative_category_name`	string	No	`“Beauty”`	Clasificación asignada tanto a las marcas como a las creatividades afectadas por el error.
`creative_code`	string	Sí	`"CC001"`	Identificador alternativo de la creatividad asociada al miembro comprador que se ve afectado por el error.
`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.
`curated_deal`	string	No	`"Renault Curator Deal (111)"`	El nombre y el identificador de la oferta seleccionada afectada.
`curated_deal_id`	Entero	Yes	`991`	Identificador de la oferta seleccionada afectada por el error
`curated_deal_name`	string	No	`"Renault Curator Deal"`	Nombre de la oferta seleccionada afectada.
`curator_member`	string	No	`"OMD - Renault Group (CURATOR) (12148)"`	El nombre y el identificador del conservador asociados a los errores.
`curator_member_name`	string	No	`"OMD - Renault Group (CURATOR)"`	Nombre del miembro del conservador asociado a los errores.
`day`	time	No	`"2010-02-01"`	El día de la subasta.
`deal`	string	No	`"My Deal(2345)"`	El nombre y el identificador de la oferta afectada.
`deal_id`	Entero	Yes	`2345`	Identificador de la oferta afectada por el error (si Id. de oferta = 0 no se ha implicado ninguna oferta).
`deal_name`	string	No	`"My Deal"`	Nombre de la oferta afectada.
`error_id`	Entero	Yes	`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”`	Mensaje de error genérico que describe el error que se produjo (vincula al identificador de error).
`hour`	time	No	`"2010-02-01 06:00:00"`	La hora de la subasta.
`language`	string	No	`"English(1)"`	Nombre del idioma.
`language_id`	Entero	Yes	`1`	Identificador del idioma.
`language_name`	string	No	`"English"`	Nombre del idioma.
`month`	time	No	`"2010-02"`	El mes de la subasta.
`placement_id`	Entero	Yes	`7890`	Identificador de la ubicación.
`placement_name`	string	No	`"My placement"`	Colocación del miembro del vendedor asociado al error.
`publisher_id`	Entero	Yes	`321`	Identificador del publicador afectado por el error.
`seller_member`	string	No	`"My Network(122)"`	El nombre y el identificador del miembro del vendedor.
`seller_member_id`	Entero	Yes	`122`	El identificador del miembro del vendedor.
`seller_member_name`	string	No	`"My Network"`	El miembro del vendedor afectado por el error.
`technical_attribute`	string	No	`“Flash(350)”`	El nombre y el identificador del atributo técnico.
`technical_attribute_id`	Entero	Yes	`350`	Identificador del atributo técnico.
`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.

Métricas

Column	Tipo	Ejemplo	Fórmula	Descripción
`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 5 % de los errores multiplicado por 100 para tener en cuenta el muestreo).

Ejemplo

Creación de la solicitud de informe con formato JSON

El archivo JSON debe incluir , report_type"buyer_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 (año, mes, día) y especificar el formato en el que se deben devolver los datos (csv, excel o html). Para obtener una explicación completa de los campos que se pueden incluir en el archivo JSON, consulte Report Service.

$ cat buyer_bid_error_report

{
    "report":
    {
        "report_type":"buyer_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 @buyer_bid_error_report '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 report-download servicio 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\":\"buyer_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.

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=b97897a7864dd8f34e7457226c7af592' > /tmp/buyer_bid_error_report.csv

Nota:

Hay un límite de 100 000 filas por informe cuando se descargan como archivos XLSX y Excel.

Compartir a través de

API de plataforma digital: informe de errores de puja del comprador

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Ejemplo

Creación de 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 plataforma digital: informe de errores de puja del comprador

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Ejemplo

Creación de 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