API de plataforma digital: informe de Curator Analytics

El Informe de Análisis del Curador proporciona a los curadores información sobre cómo fluye el dinero de la demanda a la oferta dentro de su mercado curado.

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
• hoy
• yesterday
• month_to_date
• last_month
• de duración

Período de retención de datos

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

Intervalos de tiempo, incluidas las fechas de hace más de 45 días

Si crea informes de Curator Analytics con el conjunto en "lifetime", su informe (independientemente de las report_interval métricas incluidas) se agregará a una cola especial para informes de "uso intensivo de recursos". Como resultado, el informe puede tardar más de lo habitual en completarse. Además, debido a la cantidad de datos solicitados, estos informes que hacen un uso intensivo de recursos pueden fallar antes de completarse. Si no se completa el informe, recibirás una notificación. Si se produce un error en la solicitud de denuncia o se elimina, puede:

• Vuelva a ejecutar el informe más tarde.
• Use un tipo de informe distinto de curator_analytics.
• modifique la forma en que estructura los informes (si es posible) para que no incluyan fechas anteriores a 45 días.

Dimensions

Métricas

Ejemplo

Crear una solicitud de informe con formato JSON

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

$ cat curator_analytics

{
    "report": {
        "columns": [
            "hour",
            "buyer_member_name",
            "curated_deal",
            "imps",
            "curator_revenue",
            "curator_margin"
        ],
        "format": "csv",
        "report_interval": "today",
        "report_type": "curator_analytics"
    }
}

POST la solicitud al servicio de informes

$ curl -b cookies -X POST -d @curator_analytics 'https://api.appnexus.com/report'

{
   "response":{
      "status":"OK",
      "report_id":"6b177543a9411ffa67b09bdf5e76cac1"
   }
}

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 'https://api.appnexus.com/report?id=6b177543a9411ffa67b09bdf5e76cac1'
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2020-08-25 13:03:37",
         "json_request":"{\"report\":{\"report_type\":\"curator_analytics\",\"columns\":[\"hour\",\"buyer_member_name\",\"curated_deal\",\"imps\",\"curator_revenue\",\"curator_margin\"],\"report_interval\":\"today\",\"format\":\"csv\",\"grouping\":{\"additional_grouping_sets\":[],\"unselected_implicit_groupings\":[],\"additional_groups_on_bottom\":true},\"timezone\":\"UTC\",\"filters\":[{\"member_id\":\"123456\"}],\"reporting_decimal_type\":\"decimal\",\"use_cache\":true},\"extraction_version\":\"refactored\",\"end_date\":1598400000,\"start_date\":1598313600,\"user_id\":\"987654\"}",
         "url": "report-download?id=6b177543a9411ffa67b09bdf5e76cac1"
      },
      "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 'https://api.appnexus.com/report-download?id=6b177543a9411ffa67b09bdf5e76cac1' > /tmp/curator_analytics.csv