En este documento, se proporciona una descripción general de la versión 3.0 de la API de Google Analytics Core Reporting. Para obtener una referencia detallada de la API, consulta la Guía de referencia.
Introducción
La API de Google Analytics Core Reporting te brinda acceso a la mayoría de los datos de los informes en Google Analytics. Con la API de Core Reporting, puedes hacer lo siguiente:
- Crear paneles personalizados para mostrar datos de Google Analytics
- Automatiza las tareas complejas de generación de informes para ahorrar tiempo.
- Integra tus datos de Google Analytics con otras aplicaciones empresariales.
Cómo elegir una versión
Recientemente, lanzamos una nueva versión de la API de Core Reporting.
- ¿Quieres compilar una aplicación nueva? – Te recomendamos usar la versión más reciente, 3.0.
- ¿Usas la versión heredada 2.3? – Lee la Guía de migración si quieres obtener detalles sobre cómo actualizar tu app para usar la versión nueva.
Cómo comenzar
¿Quieres comenzar de inmediato? Lee el instructivo de la API de Hello Analytics.
Cada aplicación que use la API deberá seguir algunos pasos para registrarse, autorizar al usuario y trabajar con la API. En este instructivo, se explicará cada paso y, al final, tendrás una aplicación que funciona y que puedes personalizar.
Descripción general de conceptos
La API de Core Reporting muestra datos de informes que consisten en estadísticas derivadas de los datos recopilados por el código de seguimiento de Google Analytics. Cada informe está organizado en dimensiones y métricas. Usa la API de Core Reporting para consultar dimensiones y métricas a fin de crear informes personalizados.
Hay 3 conceptos fundamentales en los que se basa la API de Core Reporting:
- Cómo se relacionan los informes con los usuarios y las vistas (perfiles)
- Estructura de un informe y cómo crear consultas
- Trabaja con la respuesta de la API
Informes, usuarios y vistas (perfiles)
Para solicitar datos de informes de un usuario, tu aplicación debe identificarlo y especificar una vista (perfil) de la que recuperar los datos. Para identificar a un usuario, se obtienen credenciales de autorización y se pasan en cada solicitud a la API. Una vista (perfil) forma parte de la jerarquía de configuración de Google Analytics y se identifica mediante un ID de vista (perfil).
Existen dos maneras de encontrar tu ID de vista (perfil).
- La aplicación puede usar la API de Management para desviar la jerarquía de configuración de Management y obtener un ID de vista (perfil).
- En la URL de cada informe en Google Analytics.
captura de la pantalla
- En Google Analytics, haz clic en
Administrar en la barra de menú. Selecciona la cuenta y la propiedad a las que
pertenece la vista. En la columna VISTA, haz clic en Configuración de la vista para obtener el ID de la vista.
captura de la pantalla
Cómo realizar consultas de dimensiones y métricas
Solo debes consultar la API para obtener datos de informes de Google Analytics, que consisten en dimensiones y métricas. Las métricas son las mediciones individuales de la actividad de los usuarios en tu propiedad, como las sesiones y las vistas de página. Las dimensiones desglosan las métricas de algunos criterios comunes, como el país o el navegador. Cuando creas una consulta, especificas qué dimensiones y métricas deseas que aparezcan en los datos de informes.
Usa la guía interactiva de referencia de dimensiones y métricas para explorar todas las dimensiones y métricas expuestas a través de la API. Consulta también la Guía de referencia de la API de Core Reporting para obtener información sobre cómo especificar dimensiones y métricas en una consulta a la API.
Trabajar con informes
Los datos que se muestran desde la API pueden considerarse como una tabla con un encabezado y una lista de filas. Cada respuesta de la API consta de un encabezado que describe el nombre y el tipo de datos de cada columna. La respuesta también contiene una lista de filas, en la que cada fila es una lista de celdas con datos en el mismo orden que los encabezados. Usa la información del encabezado para determinar el tipo de datos en cada celda.
Lee la Guía de referencia de la API de Core Reporting para obtener más información sobre la respuesta de la API.
Políticas de cuotas y baja
La API de Google Analytics controla millones de operaciones. Es necesario emplear un sistema de cuotas para proteger el sistema y evitar que reciba más operaciones de las que puede manejar y garantizar una distribución equitativa de los recursos del sistema. Consulta la guía Límites y cuotas para conocer los límites específicos.
Para obtener detalles sobre cómo se manejan los cambios en las columnas de la API de Core Reporting (es decir, dimensiones y métricas), lee la Política de Baja de Datos. Si quieres obtener información sobre cómo se puede usar la API de Metadata para verificar las columnas obsoletas, consulta la Guía para desarrolladores de la API de metadatos.
Próximos pasos
Ahora que comprendes cómo funciona la API, disponemos de una gran cantidad de recursos para ayudarte a comenzar:
- Lee la Guía para desarrolladores para obtener información sobre cómo trabajar con la API.
- Usa la herramienta interactiva Explorador de consultas para crear consultas de manera visual y ver la respuesta a través de la API.
- Lee el artículo Consultas comunes, en el que se enumeran varias de las consultas más comunes a la API de Core Reporting.
- Consulta la referencia Dimensiones y métricas para obtener una lista de todos los datos disponibles a través de la API.
- Consulta la página Bibliotecas y muestras para obtener una lista de todas las bibliotecas cliente disponibles que se pueden usar con esta API.