Importar datos de productos con la API de Management

Andrew Wales, Relaciones con programadores de Google Analytics, mayo de 2014

En esta guía, se describe cómo simplificar tu 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 la importación de 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 debe enviar junto con los hits, como las páginas vistas y los eventos. Un solo ID de producto o SKU que se envía a Google Analytics en el momento de la recopilación se puede unir con tus datos de productos importados para propagar las dimensiones y las métricas de los productos en tus informes.

Antes de comenzar

Antes de completar esta guía de soluciones, lee lo siguiente:

Descripción general

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

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

Para obtener información sobre cómo subir tu conjunto de datos a Google Analytics mediante la interfaz web, consulta la Guía del usuario de comercio electrónico mejorado.

Cree el conjunto de datos

El primer paso a fin de importar datos de productos es crear un conjunto de datos para tus datos de productos y establecer el esquema que defina las dimensiones y las 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 Product Data como el tipo de conjunto de datos y Product SKU como la clave.

Figura 1: Creación de un conjunto de datos de productos.

Después de crear el conjunto de datos, toma nota del ID de la fuente de datos personalizada, 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

Los datos del producto CSV deben contener una fila de encabezado, una columna para el SKU del producto y una columna para cada dimensión o métrica que se importará según lo definido por el esquema del conjunto de datos.

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

Figura 2: Preparación de los datos de productos para subirlos en un archivo CSV.

El archivo CSV se ve de la siguiente manera:

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

Suba los datos de productos mediante la API de administración

Después de crear el conjunto de datos, definir el esquema y preparar los datos del producto para subirlos en un CSV, estarás listo para subirlos mediante la API de Management.

Después de subir, validar y procesar los datos de productos, los SKU de productos se unirán con los datos de productos subidos cuando se produzca una coincidencia en los hits entrantes que se enviaron a Google Analytics desde tu propiedad.

Actualice su código de comercio electrónico para enviar el SKU del producto

Después de subir datos de productos, actualiza tu código de comercio electrónico para enviar los SKU de productos con cada uno de tus hits, junto con los datos adicionales que desees 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 ID de productos enviados desde su implementación de comercio electrónico mejorado ahora coincidirán con los SKU de producto en su conjunto de datos de productos importado, y sus informes se propagarán automáticamente con los datos de productos adicionales que subió.