Produktdaten mithilfe der Management API importieren

Andrew Wales, Google Analytics Developer Relations – Mai 2014

In diesem Leitfaden wird beschrieben, wie Sie Ihre erweiterte E-Commerce-Implementierung durch den Import von Produktdaten mithilfe der Management API vereinfachen können. Weitere Informationen zum Importieren von Produktdaten finden Sie unter Beispiel für den Produktdatenimport.

Einleitung

Durch den Import von Produktdaten in Google Analytics wird die Menge der E-Commerce-Daten, die mit Treffern wie Seitenaufrufen und Ereignissen gesendet werden müssen, vereinfacht und reduziert. Eine einzelne Produkt-ID oder SKU, die zum Zeitpunkt der Erfassung an Google Analytics gesendet wird, kann mit den importierten Produktdaten verknüpft werden, um Produktdimensionen und -messwerte in Ihren Berichten zu erfassen.

Hinweis: Produktdaten können nur mit Treffern importiert werden, die im Format Erweiterter E-Commerce gesendet werden.

Vorbereitung

Lesen Sie vor dem Abschluss dieses Lösungsleitfadens Folgendes:

• Erweiterte E-Commerce-Berichte.
• Entwicklerleitfaden zum Datenimport

Überblick

So aktivieren Sie den Datenimport für Produktdaten:

1. Datensatz erstellen
2. Produktdaten-CSV-Datei für den Upload vorbereiten
3. Produktdaten mithilfe der Management API hochladen
4. E-Commerce-Code zum Senden der Produkt-Artikelposition (SKU) aktualisieren

Informationen zum Hochladen des Datensatzes über die Weboberfläche in Google Analytics finden Sie im Nutzerhandbuch für erweiterte E-Commerce-Berichte.

Wichtig: Nach dem Importieren von Produktdaten kann es bis zu 24 Stunden dauern, bis diese Daten mit Produkt-IDs zusammengeführt werden, die zum Zeitpunkt der Erfassung an Google Analytics gesendet werden. Bis dahin werden die importierten Dimensionen und Messwerte nicht in Ihren Berichten angezeigt.

Datensatz erstellen

Der erste Schritt zum Importieren von Produktdaten besteht darin, einen Datensatz für Ihre Produktdaten zu erstellen und das Schema festzulegen, mit dem die zu importierenden Dimensionen und Messwerte definiert werden.

Folgen Sie dem Entwicklerleitfaden für den Datenimport, um einen Datensatz zu erstellen, wählen Sie Produktdaten als Datensatztyp und Produkt-Artikelposition (SKU) als Schlüssel aus.

Abbildung 1: Produktdatensatz erstellen

Notieren Sie sich nach dem Erstellen des Datensatzes die ID der benutzerdefinierten Datenquelle. Sie benötigen sie im nächsten Schritt, um Ihre Produktdaten mithilfe der Management API in Google Analytics zu importieren.

Produktdaten-CSV-Datei für den Upload vorbereiten

Die CSV-Datei Ihrer Produktdaten muss eine Kopfzeile, eine Spalte für Produkt-SKU und eine Spalte für jede zu importierende Dimension und/oder jeden zu importierenden Messwert enthalten, wie im Datensatzschema definiert.

Folgen Sie dem Entwicklerleitfaden für den Datenimport, um Ihre Produktdaten in der CSV-Datei für den Import vorzubereiten. Verwenden Sie dabei in der ersten Spalte Produkt-Artikelposition (SKU) als Schlüssel.

Abbildung 2: Produktdaten für den Upload in einer CSV-Datei vorbereiten

Die CSV-Datei sieht so aus:

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

Hinweis: Für die Produktkategorie wird eine Hierarchie mit fünf Ebenen unterstützt. Verwenden Sie / als Trennzeichen für jede Ebene in der Hierarchie (z.B. Bekleidung/Herren/T-Shirts).

Produktdaten mithilfe der Management API hochladen

Nachdem Sie den Datensatz erstellt, das Schema definiert und Ihre Produktdaten für den Upload in einer CSV-Datei vorbereitet haben, können Sie Ihre Produktdaten über die Management API hochladen.

Nachdem die Produktdaten hochgeladen, validiert und verarbeitet wurden, werden Produkt-SKUs mit den hochgeladenen Produktdaten zusammengeführt, wenn eine Übereinstimmung mit eingehenden Treffern auftritt, die von Ihrer Property an Google Analytics gesendet werden.

E-Commerce-Code aktualisieren, um die Artikelnummer zu senden

Nachdem Sie Produktdaten hochgeladen haben, aktualisieren Sie Ihren E-Commerce-Code so, dass mit jedem Treffer Produkt-Artikelnummern zusammen mit allen zusätzlichen Daten gesendet werden, die in Ihren Berichten enthalten sein sollen, z. B. benutzerdefinierte Dimensionen oder Messwerte.

Hinweis: Beim Senden von E-Commerce-Daten an Google Analytics gibt es kein spezifisches Feld namens „Produkt-SKU“. Stattdessen wird es durch das Feld id dargestellt (siehe Beispiel unten).

// 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.

Über Ihre Implementierung der erweiterten E-Commerce-Berichte gesendete Produkt-IDs werden jetzt mit Produkt-SKUs im importierten Produktdatensatz abgeglichen und Ihre Berichte werden automatisch mit den zusätzlich hochgeladenen Produktdaten gefüllt.