Informes Dinámicos
- Sebastian Perez (Unlicensed)
El API permite acceder a diversos informes del sistema: impresiones y clicks por pauta, por sitio, por espacio, etc. Mediante parámetros se especifica qué información se desea obtener y la respuesta se devuelve en formato CSV , XML o XLSX segùn se requiera. Se debe elegir por qué objeto filtrar (parámetro filter1_id) y luego qué columnas debe tener el informe. Se pueden elegir 1 o 2 columnas, además de las columnas generadas por el sistema que son impresiones, clicks, usuarios únicos, IPs únicas, etc.
El request se debe realizar con el método GET
URL: /admin/adnet/pub/stats/informedinamico.csv? // /admin/adnet/pub/stats/informedinamico.xml? // /admin/adnet/pub/stats/informedinamico.xlsx?
Parámetros obligatorios:
- filter1_id: código de filtro (pauta, sitio, espacio, etc). Se definen en las Referencias: Filtros para informes dinámicos.
- objeto_id: código del objeto para el cual se muestra el informe. Si, por ejemplo, en filter1_id se eligió filtrar por una pauta, aquí se debe especificar el ID de esa pauta (pauta_id).
- fechashortcut_id: se debe incluir cualquiera de los siguientes ids:
1 - HOY 2 - AYER 4 - ULTIMAS_24HS 8 - ESTA_SEMANA 16 - SEMANA_PASADA 32 - ULTIMOS_7_DIAS 64 - ESTE_MES 128 - MES_PASADO 256 - ULTIMOS_30_DIAS 512 - ESTE_ANO 1024 - ANO_PASADO 2048 - ULTIMOS_12_MESES
0 - OTRO
En caso de que se haya indicado '0':
- fecha_inicio: fecha de inicio del informe
- fecha_fin: fecha de fin del informe. Esta fecha se incluye dentro del informe. Por ejemplo, si se indica fecha_fin 11/11/2006, el informe se muestra hasta las 23:59:59 de esa fecha.
Parámetros opcionales:
- columna1_id: objeto a mostrar en la primera columna del informe. Los valores posibles se listan en las Referencias: Objetos para informes dinámicos.
- columna2_id: objeto a mostrar en la segunda columna.
Ejemplo de request:
URL: /admin/adnet/pub/stats/informedinamico.csv?filter1_id=1&objeto_id=4324&fechashortcut_id=0&fecha_inicio=1/11/2006&fecha_fin=30/11/2006&columna1_id=12
Parámetros:
- filter1_id: filtrar por una pauta (código 1)
- objeto_id: ID de la pauta filtrada
- columna1_id: informe por fecha (código 12)
- fechashortcut_id:0
- fecha_fin: el informe se brinda desde las 0 horas del 1/11/2006
- fecha_fin: el informe se brinda hasta las 23:59:59 del 30/11/2006
Respuesta:
CSV
Se devuelve un archivo de formato CSV, separado por punto y coma y con comillas dobles como delimitador de todos los campos. En la primera línea se incluye un header
| 'Date';'Impressions';'Clicks';'Unique users';'Unique IPs';'Click-through rate' '11/23/2006';'9,721';'0';'9,463';'9,112';'0 %' '11/24/2006';'8,877';'0';'8,666';'8,486';'0 %' '11/25/2006';'8,595';'0';'8,382';'8,203';'0 %' '11/26/2006';'8,462';'0';'8,228';'7,942';'0 %' '11/27/2006';'9,080';'0';'8,873';'8,415';'0 %' '11/28/2006';'8,352';'0';'8,111';'7,805';'0 %' '11/29/2006';'7,441';'0';'7,236';'6,949';'0 %' '11/30/2006';'4,301';'0';'0';'0';'0 %' |
XLSX
XML
| <report> |