En este documento, se proporciona una descripción general de alto nivel de la API de informes de embudos multicanales de Google Analytics. Para obtener una referencia detallada de la API, lee la Guía de referencia.
Introducción
La API de informes de embudos multicanales le permite solicitar datos de embudos multicanales de un usuario autenticado. Los datos se obtienen de los datos de la ruta de conversión, que muestran las interacciones del usuario con varias fuentes de tráfico en varias sesiones antes de generar la conversión. Esto te permite analizar cómo los diversos canales de marketing influyen en las conversiones a lo largo del tiempo. Para obtener más información sobre los datos disponibles, consulta el artículo Acerca de los embudos multicanal y Acerca de los embudos multicanal.
Con la API de informes de embudos multicanales, puede:
- Cree informes personalizados con los datos de los embudos multicanales. Por ejemplo, puedes usar los datos de las rutas de conversión principales para informar sobre atributos como la posición relativa de las interacciones en una ruta de conversión.
- Integre los datos de los embudos multicanales con los datos de su empresa. Por ejemplo, puedes correlacionar los datos de conversiones en línea con los datos de ventas sin conexión y de costos de medios para obtener un panorama más completo del ROI de marketing.
- Mostrar embudos multicanales en entornos nuevos Por ejemplo, puedes crear visualizaciones y otras presentaciones con los datos que comunican el valor de los diferentes canales de marketing para generar conversiones.
Descripción general de conceptos
Los conceptos fundamentales subyacentes a la API de informes de embudos multicanales son:
- Cómo se relacionan los informes con los usuarios y las vistas (perfiles)
- La estructura de un informe y cómo crear consultas
- Datos de rutas de conversión y conceptos de atribución.
- Trabajar con la respuesta de la API
Informes, usuarios y vistas (perfiles)
A fin de solicitar datos de informes para un usuario, tu aplicación debe identificar al usuario y especificar una vista (perfil) para la cual recuperar los datos. Un usuario se identifica cuando obtiene credenciales de autorización y las pasa en cada solicitud a la API. Una vista (perfil) se identifica mediante un ID de vista (perfil). Las vistas (Perfiles), entre otras, forman parte de la jerarquía de configuración de Google Analytics. Tu aplicación puede usar la API de Management para recorrer esta jerarquía y obtener un ID de vista (perfil).
Consulta dimensiones y métricas
Consultas la API para obtener datos de informes de Google Analytics, que consisten en dimensiones y métricas. Las métricas son mediciones individuales de la actividad del usuario, como los valores y los recuentos de conversiones. Las dimensiones desglosan las métricas según algunos criterios comunes y pueden ser valores básicos que representan eventos de interacción individuales en rutas de conversión o secuencias que representan la serie de eventos de interacción de rutas de conversión completas.
Usa la Guía de referencia de dimensiones y métricas para explorar todas las dimensiones y métricas expuestas a través de la API. Además, lee la Guía de referencia de la API de informes de embudos multicanal para obtener información sobre cómo especificar dimensiones y métricas en una consulta de API.
Conceptos de los datos de la ruta de conversión y de atribución
Los informes de embudos multicanales se generan a partir de rutas de conversión: las secuencias de interacciones (p.ej., clics o referencias de canales) que generaron cada conversión y transacción. Las rutas de conversión se recopilan a través de la cookie de Google Analytics que registra las interacciones con el mismo navegador y máquina. Los datos de los embudos multicanales combinan los datos de conversiones de Google Analytics con la secuencia de interacciones capturadas en la cookie.
Las consultas de informes de embudos multicanales muestran datos en función de un conjunto de muestra de un millón de rutas de conversión. Si el período incluye un recuento de conversiones total de 1 millón o menos, no se muestreará el informe. De lo contrario, se usará un conjunto de muestra de 1 millón para generar los resultados. Esto contrasta con la funcionalidad de informes principales, que toma como base las sesiones. Para obtener más información sobre los datos y los conceptos relacionados, consulta Acerca de los datos de embudos multicanales. También puede resultarte útil leer el artículo Cómo analizar las contribuciones de canal, en el que se definen conceptos básicos, como las Conversiones por contribución.
Cómo trabajar con informes
Los datos que se muestran de 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. Lee la Guía de referencia de la API de informes de embudos multicanal para obtener más información acerca de la respuesta de la API.
Cada valor de celda contiene un valor primitivo de tipo de string o un valor de ruta de conversión. Este valor de ruta de conversión es un arreglo de objetos que representa todos los nodos de esa ruta. Podemos usar la información de tipo en los encabezados de las columnas para analizar cada valor de celda con el tipo adecuado. Obtén más información aquí.
Política de cuotas
La consulta de datos Embudos multicanal controla millones de operaciones. Para evitar que el sistema reciba más operaciones de las que puede manejar y garantizar una distribución equitativa de los recursos del sistema, es necesario emplear un sistema de cuotas. Consulta la guía Límites y cuotas para obtener más detalles.
Próximos pasos
Ahora que comprendes cómo funciona la API, te ofrecemos una serie de recursos para ayudarte a comenzar:
- Lee la Guía para desarrolladores si quieres obtener información sobre cómo trabajar con la API.
- Usa el Explorador de API de Google interactivo para crear consultas de forma visual y ver la respuesta a través de la API.
- Consulta la Guía de referencia de 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 ejemplos para ver una lista de todas las bibliotecas cliente disponibles que se pueden usar con esta API.