Importowanie danych produktów za pomocą interfejsu API zarządzania

Andrew Wales, Google Analytics Developer Relations – maj 2014 r.

Z tego przewodnika dowiesz się, jak uprościć implementację Ulepszonego e-commerce przez importowanie danych produktów za pomocą interfejsu Management API. Więcej informacji o importowaniu danych produktów znajdziesz w artykule Przykład importu danych produktów.

Wstęp

Importowanie danych o produktach do Google Analytics upraszcza i zmniejsza ilość danych e-commerce, które trzeba wysyłać razem z działaniami, takimi jak wyświetlenia strony i zdarzenia. Pojedynczy identyfikator produktu lub kod SKU wysłany do Google Analytics podczas zbierania danych można połączyć z zaimportowanymi danymi produktów, aby wypełnić wymiary i dane produktów w raportach.

Uwaga: importowanie danych o produktach działa tylko w przypadku działań wysyłanych w formacie Ulepszonego e-commerce.

Zanim zaczniesz

Przed skorzystaniem z tego przewodnika dotyczącego rozwiązań przeczytaj te informacje:

• Ulepszone e-commerce
• Import danych – przewodnik dla programistów.

Przegląd

Aby włączyć importowanie danych produktów:

1. Tworzenie zbioru danych
2. Przygotuj do przesłania plik CSV z danymi produktów
3. Przesyłanie danych o produktach za pomocą interfejsu API zarządzania Google Analytics
4. Aktualizowanie kodu e-commerce, by wysłać kod SKU produktu

Aby dowiedzieć się, jak przesłać zbiór danych do Google Analytics za pomocą interfejsu internetowego, przeczytaj Przewodnik użytkownika Ulepszonego e-commerce.

Ważne: po zaimportowaniu danych produktów może minąć do 24 godzin, zanim rozpocznie się łączenie tych danych z identyfikatorami produktów przesyłanymi do Google Analytics w momencie gromadzenia danych. Do tego czasu zaimportowane wymiary i dane nie będą widoczne w swoich raportach.

Utwórz zbiór danych

Pierwszym krokiem do zaimportowania danych o produktach jest utworzenie zbioru danych dla danych o produktach i ustawienie schematu definiującego wymiary i dane do zaimportowania.

Wykonaj czynności opisane w Przewodniku dla programistów ds. importowania danych, aby utworzyć zbiór danych, wybierz Dane produktu jako typ zbioru danych i Kod SKU produktu jako klucz.

Rysunek 1.Tworzenie zbioru danych o produkcie

Po utworzeniu zbioru danych zanotuj niestandardowy identyfikator źródła danych, którego użyjesz w następnym kroku do zaimportowania danych produktów do Google Analytics za pomocą interfejsu API zarządzania.

Przygotowanie do przesłania pliku CSV z danymi produktów

Dane produktów w pliku CSV muszą zawierać wiersz nagłówka, kolumnę Kod SKU produktu oraz kolumnę dla wszystkich wymiarów lub danych, które mają zostać zaimportowane zgodnie ze schematem zbioru danych.

Wykonaj Przewodnik dla programistów dotyczący importowania danych, aby przygotować dane produktów w formacie CSV do zaimportowania, używając klucza w pierwszej kolumnie Kod SKU produktu.

Rysunek 2: Przygotowywanie danych produktów do przesłania w pliku CSV.

Plik CSV wygląda tak:

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

Uwaga: w przypadku kategorii produktów obsługiwana jest 5-poziomowa hierarchia. Użyj / jako separatora dla każdego poziomu w hierarchii (np. odzież/męskie/koszulki).

Przesyłanie danych produktów za pomocą interfejsu API zarządzania

Po utworzeniu zbioru danych, zdefiniowaniu schematu i przygotowaniu danych produktów do przesłania w pliku CSV możesz przesłać dane produktów za pomocą interfejsu API zarządzania.

Po przesłaniu, zweryfikowaniu i przetworzeniu danych o produktach kody SKU produktów zostaną połączone z przesłanymi danymi produktów, gdy nastąpi dopasowanie do działań przychodzących wysyłanych z Twojej usługi do Google Analytics.

Aktualizowanie kodu e-commerce, aby wysłać kod SKU produktu

Po przesłaniu danych produktów zaktualizuj kod e-commerce, tak by przy każdym działaniu wysyłać kody SKU produktów wraz z dodatkowymi danymi, które chcesz uwzględnić w raportach, np. z niestandardowymi wymiarami lub danymi.

Uwaga: przy wysyłaniu danych e-commerce do Google Analytics nie ma konkretnego pola o nazwie Kod SKU produktu, ale zamiast niego jest reprezentowane pole id, jak pokazano w poniższym przykładzie.

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

Identyfikatory produktów wysłane z implementacji ulepszonego e-commerce zostaną dopasowane do kodów SKU produktów w zaimportowanym zbiorze danych produktów, a Twoje raporty będą automatycznie wypełniane dodatkowymi, przesłanymi przez Ciebie danymi produktów.