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

En este documento se explican conceptos avanzados para programadores sobre cómo usar la API de administración para importar datos a la cuenta de Google Analytics.

Introducción

La función de importación de datos de la API de administración permite subir, enumerar, suprimir y obtener datos importados en la cuenta de Google Analytics. Para obtener una descripción general y más información sobre las ventajas de la función de importación de datos, consulta 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 todas las fuentes de datos asociada 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 una fuente de datos personalizada o conjunto de datos.

Antes de empezar

A todas las API de Google Analytics se accede de un modo similar. Antes de empezar a usar la API de administración, consulta:

  • La página de bibliotecas de cliente para obtener una lista completa de las bibliotecas de cliente específicas del lenguaje de programación que funcionan con la API.
  • La Guía de referencia para obtener información sobre la interfaz de la API y el acceso a los datos sin una biblioteca de cliente.

Cada biblioteca de cliente proporciona un solo objeto de servicio Analytics para acceder a todos los datos de la API de administración. Para crear el objeto de servicio, realiza las siguientes acciones:

  1. Registrar la aplicación en Google Developers Console.
  2. Autorizar el acceso a los datos de Google Analytics.
  3. Crear un objeto de servicio Analytics.

Si no has completado estos pasos, no sigas y lee el tutorial de presentación de la API de Google Analytics. Con este tutorial recorrerás los pasos iniciales de la creación de una aplicación de la API de Google Analytics. Una vez completado, sabrás cómo acceder a las API de Google Analytics para realizar tareas del mundo real.

Casos prácticos

La función de importación de datos se puede usar para integrar los datos empresariales con los datos de Google Analytics. Por ejemplo, puedes utilizar:

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 usuario

Puedes subir datos de usuario sin identificación personal de herramientas de CRM externas y crear audiencias de remarketing de AdWords para tus segmentos de usuarios más valiosos.

Para obtener más información sobre cómo importar los datos de usuario en Google Analytics para crear listas de remarketing de AdWords, consulta, Importar datos de usuario para crear audiencias de remarketing de AdWords.

Datos de campaña

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 se podría trabajar en los grupos de estados del este, del centro y del oeste. En Europa, se podría trabajar en 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. Los ID de ciudad y de país se pueden encontrar en la tabla Segmentación geográfica. El código ISO de país y el código de subcontinente se pueden encontrar en las tablas ISO-3166-1 aplha-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.

Datos de 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 las 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 hastra 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 averiguar el tipo que se ha configurado para una fuente de datos personalizada o un conjunto de datos, utiliza el método list de la fuente de datos personalizada y comprueba si la propiedad importBehavior se ha configurado como OVERWRITE o SUMMATION.

Suma y sobrescritura en filas de datos de costes

También puedes anular el comportamiento de la fuente de datos personalizada o del conjunto de datos por cada archivo que subas mediante la inclusión de la columna ga:importBehavior en el encabezado. Puedes configurar fila a fila el valor de ga:importBehaviour 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 agregará 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 de la importación de datos

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 debe 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 la 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
  • 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. Por ejemplo, source1,"medium,ether",group1,100 (el segundo valor de celda es medium,ether).
  • Para especificar comillas dentro de una celda, además de empezar y acabar con comillas, debes aplicar formato de escape a las comillas con otras comillas. Por ejemplo, source1,"medium""ether",group1,100 (el segundo valor de celda es medium"ether).

Ejemplos de código

El recurso upload permite que un usuario autorizado suba, enumere, obtenga y suprima los datos importados. El recurso customDataSource permite que un usuario autorizado enumere las fuentes de datos personalizadas. Para usar cualquiera de estos métodos, debes crear un objeto de servicio Analytics, tal como se describe en la sección Antes de empezar.

Para ver ejemplos de código que muestran cómo trabajar con el recurso Subidas, consulta las siguientes referencias de métodos:

Subidas

  • list: enumera las subidas a las que tiene acceso el usuario.
  • get: obtiene las subidas a las que tiene acceso el usuario.
  • deleteUploadData: suprime los datos asociados con una subida anterior.
  • uploadData: sube datos a una fuente de datos personalizada.

Fuentes de datos personalizadas y conjuntos de datos

  • list: enumera las fuentes de datos personalizadas a las que tiene acceso el usuario.