Guía para programadores sobre la importación de datos

La API de administración de Google Analytics permite el acceso programático a la función importación de datos de Google Analytics.

Introducción

La API de administración te permite subir, enumerar, suprimir y obtener archivos subidos, así como enumerar conjuntos de datos. Para obtener una visión general de las ventajas de la función de importación de datos, consulta el artículo del Centro de Ayuda Acerca de la importación de datos.

Los dos recursos de la API de administración que habilitan la importación de datos son:

  • El recurso Fuente de datos personalizada, denominado conjunto de datos en la interfaz web, que actúa de contenedor de los archivos subidos. Una colección de fuentes de datos personalizadas representa todos los conjuntos de datos asociados a una propiedad de Google Analytics.
  • El recurso Subida, que representa un archivo subido. Una colección de recursos Subida representa todos los archivos que has subido a un conjunto de datos.

Casos prácticos

La función de importación de datos tiene tres categorías de nivel superior, cada una de las cuales cuenta con sus propios casos prácticos. La organización es la siguiente:

Importación de datos de hits

Datos de devoluciones

Las transacciones de comercio electrónico que se han devuelto total o parcialmente se pueden subir a Google Analytics. De este modo se facilita la conciliación automática de los datos en los informes de comercio electrónico de Google Analytics con las devoluciones procesadas.

Para obtener información sobre cómo importar los datos de devolución en Google Analytics, consulta Ejemplo de importación de datos de devoluciones.

Importación de datos ampliados

Datos de usuarios

Puedes subir datos personales de usuario no identificables de herramientas de CRM externas y crear audiencias de remarketing de Google Ads para tus segmentos de usuarios más valiosos.

Para obtener información sobre cómo importar los datos de usuario a Google Analytics y crear audiencias de remarketing de Google Ads, consulta:

Datos de campañas

Puedes importar los datos de campañas en Google Analytics para personalizar el análisis del rendimiento de tus campañas de tu empresa.

Para obtener información sobre cómo importar los datos de campaña en Google Analytics, consulta Importar los datos de campaña con la API de administración.

Datos geográficos

Puedes importar las 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 tal vez trabajas con los grupos de estados del este, del centro y del oeste y, en Europa, con los grupos de países del norte, del centro y del sur. Al importar datos, puedes usar ga:regionId, ga:cityId, ga:countryIsoCode o ga:subContinentCode como claves. Encontrarás los ID de ciudad y de país en la tabla de segmentación geográfica. El código ISO de país y el código de subcontinente aparecen 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 de contenido

Puedes subir los metadatos relacionados con el contenido (por ejemplo, el autor y el asunto) para aprovechar Google Analytics y realizar un análisis en profundidad de los artículos publicados en un sitio web.

Para obtener información sobre cómo importar los datos de contenido en Google Analytics, consulta el ejemplo de importación de datos de contenido.

Información del producto

La importación de datos de producto en Google Analytics simplifica y reduce el volumen de datos de comercio electrónico que debes enviar con los hits, como el número de páginas vistas y los eventos. Se puede combinar un ID de producto o código SKU individual con los datos de producto importados para completar las dimensiones y las métricas de producto en los informes.

Para obtener información sobre cómo importar los datos de producto en Google Analytics, consulta Importar los datos de producto con la API de administración.

Importación de datos de resumen

Datos de costes

Puedes subir los datos de costes de campañas de pago que no son de Google y aprovechar la plataforma de Google Analytics para realizar análisis de ROI y comparar el rendimiento de las campañas de todas las inversiones publicitarias y de marketing online.

Para obtener información sobre cómo importar los datos de costes en Google Analytics, consulta Importar los datos de costes con la API de administración.

Conceptos

Estado de procesamiento

Después de subir un archivo, el estado de la subida será PENDING hasta que la subida se haya validado y procesado. Si el procesamiento se realiza correctamente, el estado cambiará a COMPLETED.

Si se produce un error durante el procesamiento y no se realiza la subida, el estado de la subida será FAILED. Se proporcionará una lista de errores para ayudarte a identificar los problemas del archivo. A continuación se muestra una respuesta de ejemplo de una subida que no ha superado 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."
  ]
}

Suma y sobrescritura de datos de costes

Al crear una fuente de datos personalizada o un conjunto de datos para los datos de costes tienes la posibilidad de especificar cómo se gestionan los casos en los que un archivo subido contiene una fila de datos con una clave (por ejemplo, fecha, fuente o medio) que coincide con una fila existente. Las opciones son:

  • suma (valor predeterminado): los nuevos datos se agregarán a los datos coincidentes anteriores y las métricas se sumarán
  • sobrescritura: los nuevos datos sobrescribirán los datos coincidentes anteriores

Para saber qué tipo se ha configurado en un conjunto de datos, comprueba si se ha asignado OVERWRITE o SUMMATION a la propiedad importBehavior mediante el método lista de fuentes de datos personalizadas.

Suma y sobrescritura en filas de datos de costes

También puedes anular el comportamiento del conjunto de datos por cada archivo que subas. Para ello, debes incluir la columna ga:importBehavior en el encabezado. Puedes configurar fila a fila el valor de ga:importBehavior como SUMMATION u OVERWRITE.

Por ejemplo, el siguiente archivo sobrescribirá los datos de costes anteriores de Facebook/cpc y Yahoo/cpc, pero la fila de Bing/cpc se añadirá a los datos de costes existentes de esa fecha concreta y combinación de fuente y medio.

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 formato adecuado. En esta sección se describen las restricciones que deben cumplir para que se considere válido para subir en todos los tipos de importación de datos.

Si no se cumple alguna de las restricciones anteriores o si hay un error de procesamiento, se producirá un error en la solicitud de subida y devolverá mensajes de error. En el API se notificarán hasta diez errores en una sola respuesta para ayudar a los usuarios a reducir el número de subidas no válidas.

Restricciones de archivo

  • Codificación: UTF-8
  • Límite de tamaño de archivo: 1 GB

Restricciones de encabezado

  • La primera fila se considera un encabezado de columna y es obligatoria. Debe definir las dimensiones y las métricas que contendrá esa columna concreta.

Restricciones de fila

  • Hay un límite de fila de 1 MB.

Formato de celdas

  • Las celdas pueden tener una longitud máxima de 2.048 caracteres.
  • Los espacios al principio y al final de la celda se suprimirán.
  • Para especificar una coma dentro de una celda, el valor de la celda debería incluirse entre comillas dobles. Por ejemplo, source1,"medium,ether",group1,100 (el segundo valor de celda es medium,ether).
  • Para especificar comillas dobles dentro de una celda, además de empezar y acabar con comillas dobles, debes aplicar formato de escape a la comilla doble con otra comilla doble. Por ejemplo, source1,"medium""ether",group1,100 (el segundo valor de celda es medium"ether).