La API de Google Analytics Management habilita el acceso programático a la función Importación de datos de Google Analytics.
Introducción
La API de Management te permite subir, enumerar, borrar y obtener archivos subidos, así como enumerar conjuntos de datos. Para obtener una descripción general de alto nivel de los beneficios de la función de Importación de datos, consulta el artículo Acerca de la Importación de datos del Centro de ayuda.
Los dos recursos de la API de Management que permiten la Importación de datos son los siguientes:
- El recurso Fuente de datos personalizados, denominado conjunto de datos en la interfaz web, que actúa como un contenedor para los archivos subidos. Un conjunto de fuentes de datos personalizadas representa todos los conjuntos de datos asociados con una propiedad de Google Analytics.
- El recurso Upload, que representa un archivo subido. Un conjunto de recursos de carga representa todos los archivos que subiste a un conjunto de datos.
Casos de uso
La función de importación de datos tiene tres categorías de nivel superior, cada una con sus propios casos de uso. La organización es la siguiente:
Importación de datos de hits
Datos de reembolso
Las transacciones de comercio electrónico que se reembolsaron total o parcialmente se pueden subir a Google Analytics. Esto facilita la conciliación automática de los datos en tus informes de comercio electrónico de Google Analytics con los reembolsos procesados.
Si deseas obtener información para importar datos de reembolso a Google Analytics, consulta el ejemplo de importación de datos de reembolso.
Importación de datos extendidos
Datos del usuario
Puedes subir datos del usuario que no sean de identificación personal desde herramientas externas de CRM y crear públicos de remarketing de Google Ads para tus segmentos de usuarios más valiosos.
Si deseas obtener información sobre cómo importar datos del usuario a Google Analytics para crear públicos de remarketing de Google Ads, consulta los siguientes artículos:
Datos de la campaña
Puedes importar datos de campañas a Google Analytics para personalizar el análisis de rendimiento de tu campaña para tu empresa.
Para obtener información sobre cómo importar datos de campañas a Google Analytics, consulta Cómo importar datos de campañas con la API de Management.
Datos geográficos
Puedes importar asignaciones de ID geográficos a regiones, lo que permite generar informes sobre los datos de Google Analytics por región personalizada. Por ejemplo, en Estados Unidos, es posible que operes en grupos de estados del este, centro y oeste. En Europa, podrías operar en grupos de países del norte, centro y sur. Cuando importes datos, puedes usar ga:regionId, ga:cityId, ga:countryIsoCode o ga:subContinentCode como claves. Puedes encontrar los ID de ciudad y de país en la tabla Orientación geográfica. Puedes encontrar el código ISO de país y el código de subcontinente en las tablas ISO-3166-1 alpha-2 y UN M.49, respectivamente.
Para obtener más información sobre cómo importar datos geográficos, consulta el ejemplo de Importación de datos geográficos.
Datos del contenido
Puedes subir metadatos relacionados con el contenido, como el autor y el tema, para aprovechar Google Analytics para realizar análisis detallados de los artículos publicados en un sitio web.
Si deseas obtener información para importar datos de contenido a Google Analytics, consulta el ejemplo de Importación de datos de contenido.
Datos del producto
Importar datos de productos a Google Analytics simplifica y reduce la cantidad de datos de comercio electrónico que debes enviar junto con los hits, como las vistas de página y los eventos. Puedes combinar un ID o SKU de producto único con tus datos de productos importados para propagar las dimensiones y métricas de los productos en tus informes.
Si quieres obtener información para importar tus datos de productos a Google Analytics, consulta Cómo importar datos de productos con la API de Management.
Importación de datos de resumen
Datos de costos
Puedes subir datos de costos para campañas pagadas que no sean de Google y aprovechar la plataforma de Google Analytics para analizar el ROI y comparar el rendimiento de las campañas con todas las inversiones de marketing y publicidad en línea.
Si deseas obtener información sobre cómo importar datos de costos a Google Analytics, consulta Cómo importar datos de costos con la API de Management.
Conceptos
Estado del procesamiento
Después de subir un archivo, el estado de la carga será PENDING hasta que se valide y procese. Si el procesamiento se realiza correctamente, el estado cambiará a COMPLETED.
Si se produjo un error durante el procesamiento y la carga no se realizó correctamente, el estado de la carga será FAILED. Se proporcionará una lista de errores para ayudarlo a identificar los problemas con el archivo. A continuación, se muestra un ejemplo de respuesta para una carga que falló en la validación:
{
id: "YU4DersR_ORzyzXC_AoWw",
kind: "analytics#upload",
accountId: "12345",
customDataSourceId: "poaU7EPcR4WGU-dkNghYKQ",
status: "FAILED",
errors:
[
"Invalid cell data 12.99 at row 1 column 6. expected data type LONG.",
"Invalid cell data 12.99 at row 2 column 6. expected data type LONG.",
"Invalid cell data 23.81 at row 3 column 6. expected data type LONG.",
"Invalid cell data 199.99 at row 4 column 6. expected data type LONG."
]
}
Comparación entre la suma de datos de costos y el reemplazo de datos
Al crear una fuente de datos o un conjunto de datos personalizados para los datos de costos, tienes la opción de especificar cómo gestionar los casos en los que un archivo subido contiene una fila de datos con una clave (es decir, fecha, fuente, medio) que coincide con una fila existente. Las opciones son las siguientes:
- summation (predeterminado): Los datos nuevos se agregarán a los datos coincidentes anteriores y las métricas se sumarán.
- overwrite: los datos nuevos reemplazarán a los datos coincidentes anteriores.
Para averiguar qué tipo se estableció para un conjunto de datos, usa el método de lista de fuentes de datos personalizadas para verificar si la propiedad importBehavior se estableció en OVERWRITE o SUMMATION.
Comparación entre la suma de los datos de costos y el reemplazo de las filas
También tienes la opción de anular el comportamiento del conjunto de datos para cada archivo que subas. Para ello, debes incluir la columna ga:importBehavior en el encabezado. En función de fila por fila, puedes establecer el valor de ga:importBehavior en SUMMATION o OVERWRITE.
Por ejemplo, el siguiente archivo reemplazará los datos de costos anteriores de Facebook/cpc y Yahoo/cpc, pero la fila de Bing/cpc se agregará a los datos de costos existentes para esa fecha y combinación de fuente/medio en particular.
ga:date,ga:source, ga:medium,ga:adCost,ga:importBehavior
20140604,facebook,cpc,12.23,OVERWRITE
20140604,bing,cpc,3.23,SUMMATION
20140604,yahoo,cpc,11.23,OVERWRITE
Formato y restricciones
Para que los datos se suban a Google Analytics, deben estar en un archivo CSV con el formato correcto. En esta sección, se describen las restricciones que debe cumplir antes de que se pueda considerar válidas para la carga en todos los tipos de Importación de datos.
Si se infringe alguna de las siguientes restricciones o si hay un error de análisis, la solicitud de carga fallará y mostrará mensajes de error. La API informará hasta 10 errores en una sola respuesta para ayudar a los usuarios a reducir la cantidad de cargas no válidas.
Restricciones de archivos
- Codificación: UTF-8
- Límite de tamaño del archivo: 1 GB
Restricciones del encabezado
- La primera fila se considera un encabezado de columna y es obligatoria. Se deben definir las dimensiones y las métricas que contendrá esa columna en particular.
Restricciones de filas
- El límite de filas es de 1 MB.
Formato de celdas
- Las celdas pueden tener una longitud máxima de 2,048 caracteres.
- Se quitarán los espacios iniciales y finales de una celda.
- Para especificar una coma dentro de una celda, el valor de la celda debe estar entre comillas dobles. P. ej.:
source1,"medium,ether",group1,100: El valor de la segunda celda es medio. - Para especificar comillas dobles dentro de una celda, además de las comillas dobles de inicio y final, escapa la comilla doble con otra comilla doble. P. ej.:
source1,"medium""ether",group1,100: El valor de la segunda celda esmedium"ether.