Cómo importar datos de productos con la API de Management

Andrew Wales, Relaciones con Desarrolladores de Google Analytics – mayo de 2014

En esta guía, se describe cómo simplificar la implementación de comercio electrónico mejorado mediante la importación de datos de productos mediante la API de Management. Para obtener más información sobre cómo importar datos de productos, consulta el ejemplo de importación de datos de productos.

Introducción

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. Se puede unir un ID de producto o SKU único enviado a Google Analytics en el momento de la recopilación con tus datos de productos importados para propagar las dimensiones y métricas de los productos en tus informes.

Antes de comenzar

Antes de completar esta guía de solución, lee lo siguiente:

Descripción general

Sigue estos pasos para habilitar la importación de datos de productos:

  1. Cómo crear el conjunto de datos
  2. Prepara el archivo CSV de datos de productos para subirlo
  3. Sube los datos de productos con la API de Management
  4. Actualiza tu código de comercio electrónico para enviar el SKU del producto

Si deseas obtener información para subir tu conjunto de datos a Google Analytics mediante la interfaz web, consulta la Guía del usuario de Comercio electrónico mejorado.

Cómo crear el conjunto de datos

El primer paso para importar datos de productos es crear un conjunto de datos para tus datos de productos y establecer el esquema que define las dimensiones y métricas que deseas importar.

Sigue la Guía para desarrolladores de Importación de datos a fin de crear tu conjunto de datos, selecciona Datos de productos como el tipo de conjunto y SKU de producto como la clave.

Figura 1: Creación de un conjunto de datos del producto

Después de crear el conjunto de datos, toma nota del ID de fuente de datos personalizados, que usarás en el siguiente paso para importar tus datos de productos a Google Analytics mediante la API de Management.

Prepare el archivo CSV de datos de productos para subirlo

El CSV de datos de productos debe contener una fila de encabezado, una columna para el SKU de producto y una columna para cada dimensión o métrica que se importe según lo define el esquema del conjunto de datos.

Sigue la Guía para desarrolladores sobre Importación de datos a fin de preparar el CSV de tus datos de productos para la importación. Para ello, usa el SKU de producto como la clave en la primera columna.

Figura 2: Cómo preparar los datos de productos para subirlos en un archivo CSV.

El archivo CSV tiene el siguiente aspecto:

ga:productSku,ga:productName,ga:productBrand,ga:productCategoryNew,ga:productVariant,ga:productPrice
12345,Triblend Shortsleeve T-Shirt,Google,Apparel,black,15.25
67890,Donut Friday Scented T-Shirt,Google,Apparel,gray,33.85
10292,Kaiser the Snake T-Shirt,Google,Apparel,green,19.10
67584,Organic Cotton Android T-Shirt,Google,Apparel,black,13.50
90876,Maps Biking T-Shirt,Google,Apparel,blue,15.65

Sube los datos del producto con la API de Management

Después de crear el conjunto de datos, definir el esquema y preparar los datos de tus productos para subirlos en un CSV, estarás listo para subir tus datos de productos con la API de Management.

Después de que los datos de productos se suban, validen y procesen, los SKUs de producto se unirán con los datos de productos subidos cuando se produzcan coincidencias en los hits entrantes que se envíen a Google Analytics desde tu propiedad.

Actualiza tu código de comercio electrónico para enviar el SKU del producto

Después de subir los datos de productos, actualiza tu código de comercio electrónico para enviar los SKUs de producto con cada uno de tus hits, junto con cualquier dato adicional que desees incluir en tus informes, como dimensiones o métricas personalizadas.

// Example of sending a transaction when joining with imported product data.
ga('create', 'UA-XXXX-Y');
ga('require', 'ec', 'ec.js'); // Load the Enhanced Ecommerce plug-in. Required.

// The product name, price, and other product data will be added to this hit
// at collection time if the value of the id field matches a Product SKU
// you've uploaded.
ga('ec:addImpression', {
  'id': '12345',              // Product ID/SKU (Key). Required.
  'list': 'Search Results',
  'position': 1,
  'dimension1': 'Member'
});

ga('send', 'pageview');       // Send the impression with a pageview hit.

Los IDs de productos enviados desde tu implementación de Comercio electrónico mejorado ahora coincidirán con los SKUs del producto en el conjunto de datos del producto importado, y tus informes se propagarán automáticamente con los datos de productos adicionales que hayas subido.