API de plataforma digital: informe de errores de oferta del vendedor

El informe de errores de la oferta del 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 20 para tener en cuenta el muestreo del 5 %.

Utilice este informe para solucionar problemas de configuración del lado de la venta y del lado de la compra que dan lugar a errores en la subasta y, por lo tanto, bloquean 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 oferta.

Para obtener instrucciones sobre cómo recuperar un informe, consulte Servicio de informes 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 Servicio de informes.

Período de retención de datos

El período de retención de datos de este informe es de 403 días.

Dimensions

Métricas

Ejemplo

Crear una solicitud de informe con formato JSON

El archivo JSON debe incluir el report_type"seller_bid_error_report", así como el columns (dimensiones y métricas) y report_interval que desea recuperar. También puede filtrar dimensiones específicas, definir la granularidad (, , ) y especificar la forma en que "format" 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, vea el servicio de informes.

$ 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 el estado del informe desde el servicio de informes

Realice una GET llamada con el id. de informe para recuperar el estado del informe. Continúe realizando esta GET llamada hasta que se {{execution_status}} ."ready" Después, 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 ID del informe, pero esta vez al servicio de descarga de informes . Puede encontrar el servicio y el ID de informe en el url campo de la respuesta anterior GET . Al identificar el archivo en el que desea guardarlo, asegúrese de usar la extensión de archivo que especificó en POSTel "format" archivo .

$ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/advertiser_analytics.csv