Descripción general de los informes

La API de Campaign Manager 360 proporciona varias formas de recuperar datos de los anuncios coordinados a través de Campaign Manager 360.

Servicio de informes

La generación de informes con el servicio Reports implica un flujo de trabajo de varios pasos para configurar, generar y recuperar archivos de informes (como en formato CSV o Excel). Esta es la ruta de informes estándar para la API de Campaign Manager 360 y es adecuada para grandes conjuntos de datos, secuencias de comandos programadas automatizadas o aplicaciones posteriores que consumen archivos.

Por lo general, el flujo de trabajo consta de los siguientes pasos:

  1. Define o localiza un recurso Report (especificando dimensiones, métricas, períodos y filtros) que se guarda con un ID de informe único. Consulta Cómo crear y actualizar informes.
  2. Ejecuta la generación de informes llamando al método reports.run. Esto pone en cola la ejecución del informe y devuelve un recurso File de marcador de posición. Consulta Cómo buscar y generar informes.
  3. Verifica periódicamente el estado del recurso File. Dado que este proceso se ejecuta de forma asíncrona, el estado de un archivo comenzará como PROCESSING y cambiará a REPORT_AVAILABLE cuando se complete. Consulta Cómo buscar y generar informes.
  4. Recupera el contenido del archivo (CSV o Excel) una vez que se complete la generación del informe. Consulta Descargar informes.

Ejecuta informes de forma síncrona

Si necesitas generar un archivo de informe (CSV o Excel) para una pequeña cantidad de datos, puedes ejecutar el informe de forma síncrona llamando al método reports.run con el parámetro synchronous establecido en true. La API intenta generar el informe dentro de un breve período de espera. Si la ejecución tarda más, la ejecución del informe recurre automáticamente a la cola asíncrona.

Para obtener más detalles, consulta Informes síncronos.

Consulta datos de informes

Usa el método reportData.query para consultar los datos de informes directamente en lugar de generar un archivo de informe.

  • En lugar de crear y guardar un recurso Report, especificas las dimensiones, las métricas y otros criterios de filtrado o clasificación directamente en la solicitud.
  • La respuesta contiene datos estructurados del informe, lo que elimina la necesidad de sondear y descargar un archivo generado.
  • La solicitud se ejecuta de forma síncrona con un límite de 60 segundos.

Para obtener más detalles, consulta Cómo consultar datos de informes en formato JSON.