Nazwy niektórych zdarzeń i parametrów e-commerce zostały zmienione w usłudze GA4. Używanie prawidłowych nazw i parametrów GA4 zapewni Ci najbardziej przydatne raporty e-commerce i dane o zdarzeniach e-commerce w usłudze GA4.
Aby przeprowadzić migrację z UA do GA4:
- Pozostaw implementację UA bez zmian.
- Zduplikuj zdarzenia na potrzeby usługi GA4. Użyj nowych nazw i parametrów zdarzeń wymaganych w usłudze Google Analytics. Obie implementacje będą działać niezależnie, pełniąc nieco odmienne funkcje.
Unikaj współdzielenia implementacji e-commerce przez UA i GA4
Jeśli używasz w usłudze GA4 obecnej implementacji e-commerce UA (np. zdarzeń dataLayer i kodu gtag.js), raporty e-commerce GA4 będą niekompletne. Biblioteka gtag.js automatycznie przekształca niektóre (ale nie wszystkie) zdarzenia i parametry UA w elementy wymagane przez GA4.
Z drugiej strony nie można zastosować po prostu nazw i parametrów zdarzeń GA4, ponieważ UA nie będzie zbierać żadnych danych o zdarzeniach, których nie rozpoznaje. Na przykład wszystkie zdarzenia e-commerce GA4 mają parametr item_id
zamiast id
.
Dlatego warto zastosować 2 implementacje – jedną na potrzeby UA i jedną na potrzeby usługi GA4.
Spowoduje to wysyłanie 2 zdarzeń, podczas gdy normalnie wystarczyłoby jedno. Możesz się też zdecydować na pozostanie przy implementacji UA i dodanie tylko zdarzeń lub parametrów niezbędnych do wysyłania danych do usługi GA4. Wymaga to jednak dogłębnej znajomości tych 2 różnych zbiorów zdarzeń i parametrów. Jeśli zachowasz strukturę i elementy obiektu dataLayer w UA:
- aby mieć dostęp do wszystkich funkcji raportowania w usłudze GA4, musisz dodać nowe zdarzenia i parametry GA4;
- jeśli dane zdarzenie UA zostało wycofane w GA4, musisz utworzyć zduplikowane zdarzenie ze zaktualizowaną nazwą wymaganą przez GA4.
Podstawy: zdarzenia i parametry
Zdarzenie określa sposób interpretacji wysyłanych danych o produkcie, liście lub promocji. Parametry przekazują bardziej szczegółowe informacje o zdarzeniu.
- W przypadku GA4 parametry są umieszczone w tablicy
items
(szczegóły). Pamiętaj, że różni się ona od obiektu dataLayer w UA, w którego przypadku skonfigurowanie osobnych zdarzeń wymaga podania dodatkowych informacji o działaniu. - Oznaczanie tagami e-commerce podlega ograniczeniom dotyczącym zdarzeń i parametrów GA4. Możesz określić do 25 parametrów niestandardowych na zdarzenie (tablica
items
zajmuje tylko jedno pole) oraz maksymalnie 50 wymiarów niestandardowych i 50 danych niestandardowych na projekt (szczegóły).
Wymagane parametry zdarzeń e-commerce w GA4
(wymagane parametry są wyróżnione pogrubieniem)
Jeśli nie podasz wymaganych parametrów zdarzeń e-commerce (np. items
, item_id
czy item_name
), zdarzenia te nie będą się pojawiać w raportach e-commerce w GA4 (zostaną zarejestrowane jako zwykłe zdarzenia niestandardowe).
Parametr zdarzenia |
Parametry na poziomie elementu |
Elementy (patrz poniżej) |
affiliation, coupon, currency, discount, index, item_id, item_brand, item_category, item_category2, item_category3, item_category4, item_category5, item_list_name, item_list_id, item_name, item_variant, price, quantity |
Poniższa tabela zawiera opis poszczególnych parametrów w tablicy elementów, które można zbierać.
Nazwa parametru w tablicy elementów |
Opis |
affiliation |
Nazwa lub kod podmiotu stowarzyszonego (ewentualnego partnera lub dostawcy) powiązane z danym elementem |
coupon |
Nazwa lub kod kuponu (jeśli jest używany) powiązane z danym elementem |
discount |
Rabat (jeśli jest stosowany) powiązany z danym elementem |
item_brand |
Marka elementu |
item_category |
Kategoria elementu |
item_category2 |
Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu |
item_category3 |
Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu |
item_category4 |
Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu |
item_category5 |
Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu |
item_id |
Identyfikator elementu (wymagane) |
item_name |
Nazwa elementu (wymagane) |
item_variant |
Wersja elementu albo niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje elementu |
price |
Cena elementu |
quantity |
Liczba elementów, których dotyczą interakcje |
Mapowanie w UA i GA4
Pamiętaj, że niektóre nazwy uległy zmianie, np. parametry warstwy danych (wcześniej: „impression” lub „product”) zostały połączone w tablicę items
.
Występuje teraz tablica items
.
Jak korzystać z tej tabeli:
- Porównaj zmiany dotyczące zdarzeń (kolumny A i C).
- Sprawdź wymagania oraz zmiany dotyczące wymiarów i parametrów (kolumny B i D). Informacje o zmianach parametrów elementów/produktów znajdziesz w dodatkowej tabeli poniżej.
- Jeśli masz aplikację z Firebase, zwróć uwagę na podane niżej zmiany w nazwach zdarzeń i wprowadź odpowiednie modyfikacje, aby zapewnić zgodność z nazwami zdarzeń w GA4 (kolumna C). Nowe funkcje raportowania e-commerce w usłudze GA4 nie będą widoczne w interfejsie Firebase. Oprócz tego szczegółowe raporty Firebase o zdarzeniach (np.
e-commerce_purchase
ipurchase
) mogą nie być aktualizowane.- Zmiany
ecommerce_purchase
(Google Analytics dla Firebase) ->purchase
ecommerce_refund
(Google Analytics dla Firebase) ->refund
select_content
(Google Analytics dla Firebase) ->select_item
present_offer
(Google Analytics dla Firebase) ->select_promotion
- Nowe
view_cart
- Zmiany
Kolumna A Nazwy zdarzeń w UA (źródło informacji) |
Kolumna B Wymiary w UA (źródło informacji) |
Kolumna C Nazwy zdarzeń w GA4 (źródło informacji) |
Kolumna D Parametry w GA4 (źródło informacji) |
|
id coupon revenue tax shipping currencyCode ** products (szczegóły poniżej) |
|
transaction_id coupon value tax shipping currency ** items (szczegóły poniżej) |
|
option |
|
payment_type |
|
revenue currencyCode option |
|
price currency shipping_tier |
|
currencyCode revenue coupon step (tylko w analytics.js) option (tylko w analytics.js) ** products |
|
currency value coupon ** items |
Nie dotyczy
Nie dotyczy |
currencyCode revenue ** products |
|
currency value ** items |
|
currencyCode ** products revenue |
|
currency ** items value |
productClick |
list Nie dotyczy – nie istniał ** products |
|
item_list_name item_list_id ** items |
|
id name creative position ** products |
|
promotion_id promotion_name creative_name creative_slot ** items |
* Nazwa zdarzenia nowa lub zmieniona w stosunku do UA
Szczegóły |
Parametry w GA4 |
Odpowiadające im wymiary w UA |
** Szczegóły elementów/produktów |
items item_id item_name item_brand item_category item_category2 item_category3 item_category4 item_category5 item_variant affiliation discount coupon price quantity |
products id name brand category Nie dotyczy – nie istniał Nie dotyczy – nie istniał Nie dotyczy – nie istniał Nie dotyczy – nie istniał variant Nie dotyczy – nie istniał Nie dotyczy – nie istniał coupon price quantity |
Te nazwy zdarzeń w UA są rozpoznawane w usłudze GA4 jako zdarzenia e-commerce:
purchase
refund
begin_checkout
add_to_cart
remove_from_cart
view_cart
add_to_wishlist
view_item
*view_promotion
select_promotion
select_item
*view_item_list
add_payment_info
add_shipping_info
- * Te zdarzenia obsługują tylko jeden element.
Gdy jedno z podanych wyżej zdarzeń jest wysyłane do usługi GA4 za pomocą interfejsu API gtag.js, przetwarzanie zdarzeń e-commerce w GA4 wyszukuje w modelu zdarzenia klucz items
. Jeśli zostanie on znaleziony, parametr będzie analizowany jako tablica zawierająca maksymalnie 200 elementów, w której każdy element jest obiektem ze wstępnie zdefiniowanym schematem. W przypadku każdego elementu zdarzenia e-commerce GA4 będą przesyłać dane w dowolnym polu ze wstępnie zdefiniowanej listy. Oto pierwsze wstępnie zdefiniowane pola elementu:
- item_id
- item_name
- item_brand
- item_category
- item_category2
- item_category3
- item_category4
- item_category5
- item_variant
- price
- quantity
- coupon
- index
- item_list_name
- item_list_id
- discount
- affiliation
- location_id
- promotion_id (poziom zdarzenia lub elementu; pierwszeństwo ma poziom elementu)
- promotion_name (poziom zdarzenia lub elementu; pierwszeństwo ma poziom elementu)
- creative_name (poziom zdarzenia lub elementu; pierwszeństwo ma poziom elementu)
- creative_slot (poziom zdarzenia lub elementu; pierwszeństwo ma poziom elementu)
Jeśli nie zaktualizujesz instrumentacji zdarzeń z UA, raporty e-commerce GA4 nie będą uwzględniać podanych niżej zdarzeń, ponieważ stare nazwy zdarzeń nie zostaną rozpoznane. Utwórz zduplikowane zdarzenie o nazwie dostosowanej do usługi GA4.
set_checkout_option
(w GA4 scalone ze zdarzeniem begin_checkout),checkout_progress
(w GA4 scalone ze zdarzeniem begin_checkout),select_content
(w GA4 nie jest to już zdarzenie e-commerce, ale jest zalecane; bez obsługi tablicy „items”).
Usługa GA4 wprowadza dodatkowe parametry na poziomie elementu, np. affiliation, currency i kilka parametrów item_category. Aby mieć dostęp do korzyści związanych z dodatkowymi parametrami, musisz zmienić tagowanie. Dodatkowe parametry są jednak opcjonalne i kod nadal będzie działać, jeśli nie będziesz ich używać.
Aktualizowanie obiektu dataLayer pod kątem Menedżera tagów Google
Aby móc korzystać z nowych zdarzeń wprowadzonych w usłudze GA4, musisz w usłudze Menedżer tagów Google dodać do obiektu dataLayer nowe zdarzenia i parametry oraz nowe reguły zdarzeń.
- Możesz ręcznie określić, który klucz obiektu dataLayer ma być zmapowany na określony parametr zdarzenia.
- Na przykład w UA trzeba umieścić w obiekcie dataLayer identyfikator „
id
” (zdarzenia purchase) jako „ecommerce.purchase.actionField.id
”. W GA4 możesz zmapować klucz obiektu dataLayer na parametr zdarzenia „transaction_id
”. Jeśli używasz obiektu dataLayer z UA, możesz utworzyć w usłudze Menedżer tagów Google zmienną dataLayer zmapowaną na klucz „ecommerce.purchase.actionField.id
” i przypisać go do zdarzenia GA4 jako „transaction_id
”. Możesz też zmapować zmienną dataLayer Menedżera tagów Google na klucz „ecommerce.purchase.transaction_id
” i przypisać go do parametru zdarzenia „transaction_id
”.
- Na przykład w UA trzeba umieścić w obiekcie dataLayer identyfikator „
- Nadal możesz się odwoływać do dotychczasowych obiektów dataLayer.
- Jeśli używasz dotychczasowych obiektów dataLayer z implementacji UA, nie możesz korzystać z nowych nazw ani parametrów zdarzeń GA4 (np. z dodatkowych parametrów na poziomie
item
). Jeśli jednak utworzysz ręcznie odpowiednie zmienne w Menedżerze tagów, będziesz otrzymywać niektóre raporty e-commerce dotyczące dotychczasowych zdarzeń.
- Jeśli używasz dotychczasowych obiektów dataLayer z implementacji UA, nie możesz korzystać z nowych nazw ani parametrów zdarzeń GA4 (np. z dodatkowych parametrów na poziomie
items
” i jego wartość {{ecommerce.purchase.products}}
, gdzie {{ecommerce.purchase.products}}
to zmienna dataLayer Menedżera tagów, którą należy utworzyć, aby odczytywać tablicę produktów z obiektu dataLayer. Utwórz zmienną dataLayer dla każdego parametru na poziomie zdarzenia i przypisz ją do parametru zdarzenia. Następnie powtórz te czynności dla każdego zdarzenia e-commerce. Zapoznaj się z poniższym przykładem.
Kod push obiektu dataLayer Menedżera tagów Google w UA (źródło informacji) |
Użycie w implementacji Menedżera tagów Google w GA4 dotychczasowego obiektu dataLayer wdrożonego w UA |
|
Musisz utworzyć zmienne dataLayer dla każdego parametru na poziomie zdarzenia, jak w poniższym przykładzie. Musisz powtórzyć tę czynność dla każdego śledzonego zdarzenia e-commerce. |
Przykłady implementacji
Konfigurowanie ścieżki zakupowej
Zwykle ścieżka zakupowa składa się z 4 kroków:
Wyświetlanie produktów
Użytkownik wyświetla produkt lub listę produktów. Aby zmierzyć liczbę wyświetleń listy produktów, przekaż tę listę do obiektu dataLayer i zarejestruj zdarzenie wraz z tymi danymi.
- gtag.js
- Zdarzenie:
view_item_list
LUBview_item
.- Odpowiednikiem w UA jest zdarzenie „
impressions
”.
- Odpowiednikiem w UA jest zdarzenie „
- Parametry: muszą obejmować co najmniej parametr
item_id
LUBitem_name
.- W UA parametry nie mają prefiksu „
item_
”. Parametr „list_position
” to obecnie „index
”.
- W UA parametry nie mają prefiksu „
- Zdarzenie:
- Menedżer tagów Google
- Zdarzenie:
view_item_list
LUBview_item
.- Odpowiednikiem w UA jest zdarzenie „
impressions
”.
- Odpowiednikiem w UA jest zdarzenie „
- Parametry: „items” to zmienna warstwy danych „
ecommerce.items
”. Parametry to „items{ }
”, a wymagany jest co najmniej „item_id
” LUB „item_name
”.- W UA parametry nie mają prefiksu „
item_
”. Parametr „position
” to obecnie „index
”.
- W UA parametry nie mają prefiksu „
- Zdarzenie:
Dodawanie do koszyka
Użytkownik wybiera produkt i dodaje go do koszyka. Alternatywą może tu być dodanie go do listy życzeń lub wysłanie prośby o dodatkowe informacje.
- gtag.js
- Zdarzenie:
add_to_cart
- Parametry: muszą obejmować co najmniej parametr
item_id
LUBitem_name
.
- Zdarzenie:
- Menedżer tagów Google
- Zdarzenie:
add_to_cart
- W UA równoważne zdarzenie dataLayer to „
addToCart
”, które wymaga dodatkowego obiektu actionFieldObject „add”. W przypadku GA4 obiekt actionFieldObject w obiekcie dataLayer nie jest już wymagany.
- W UA równoważne zdarzenie dataLayer to „
- Parametry: zawarte w tablicy „
items
”, muszą obejmować co najmniej parametr „item_id
” LUB „item_name
”.- W przypadku informacji o produkcie w UA wymagana jest osobna zmienna „
products
”.
- W przypadku informacji o produkcie w UA wymagana jest osobna zmienna „
- Zdarzenie:
Dokonanie płatności
Użytkownik przechodzi do koszyka zawierającego produkt i rozpoczyna proces płatności. Dodatkowe kroki, np. dodawanie informacji o płatności lub dostawie, mają osobne zdarzenia GA4. Jeśli proces płatności obejmuje te dodatkowe kroki, pamiętaj, aby przesyłać odpowiednie zdarzenia, które pozwolą je uwzględnić w ścieżce zakupowej.
- gtag.js
- Zdarzenie:
begin_checkout
- W UA występują też zdarzenia „
checkout_progress
” i „set_checkout_option
”, które są niedostępne w usłudze GA4. Zamiast nich występują zdarzenia: „add_to_cart
”, „add_shipping_info
” i „add_payment_info
”.
- W UA występują też zdarzenia „
- Parametry: muszą obejmować co najmniej parametr
item_id
LUBitem_name
.
- Zdarzenie:
- Menedżer tagów Google
- Zdarzenie:
begin_checkout
- W UA równoważne zdarzenie dataLayer to „
checkout
”, które wymaga dodatkowego obiektu actionFieldObject „checkout”. W przypadku GA4 obiekt actionFieldObject nie jest wymagany, ale nie należy zmieniać dotychczasowej implementacji, bo zakłóci to śledzenie e-commerce w UA.
- W UA równoważne zdarzenie dataLayer to „
- Parametry: zawarte w tablicy „items”, muszą obejmować co najmniej parametr „
item_id
” LUB „item_name
”.-
W przypadku informacji o produkcie w UA wymagana jest osobna zmienna „products”.
-
- Zdarzenie:
Zakup
Użytkownik dokonuje zakupu.
- W usłudze GA4 po dodaniu tego zdarzenia do kodu jest ono automatycznie oznaczane jako konwersja.
- gtag.js
- Zdarzenie:
purchase
- W UA występują też zdarzenia „
checkout_progress
” i „set_checkout_option
”, które nie są na razie dostępne w usłudze GA4.
- W UA występują też zdarzenia „
- Parametry: muszą obejmować co najmniej parametr „
transaction_id
”.
- Zdarzenie:
UA – analytics.js |
UA – gtag.js |
Usługa GA4 – gtag.js |
|
|
|
Kod analytics.js wykorzystuje Ulepszony e-commerce do ustawienia productFieldObject, by określić szczegóły produktu, oraz actionFieldObject, by określić działanie. Przejście na gtag.js wprowadza istotne różnice. Jest tylko jedno zdarzenie, które jest automatycznie rejestrowane jako e-commerce; można uwzględnić zarówno informacje o transakcjach, jak i produktach; informacje o produktach mogą być przesyłane w postaci tablicy (nie wymagają rejestrowania dodatkowych zdarzeń). |
Wyślij zdarzenie zakupu z elementami w transakcji. Nazwy wymaganych wartości są inne, na przykład fragment „id” został przeniesiony do „item_id”, a „name” do „item_name”. Są też różnice w wartościach opcjonalnych, których należy przestrzegać. |
Wyślij zdarzenie zakupu z elementami w transakcji |
- Menedżer tagów Google
- Zdarzenie:
purchase
- W UA równoważne zdarzenie warstwy danych to „
purchase
”, które wymaga pola działania dla pełnej transakcji.
- W UA równoważne zdarzenie warstwy danych to „
- Parametry: zawarte w tablicy „
items
”, muszą obejmować co najmniej parametr „item_id
” LUB „item_name
”.- W przypadku informacji o produkcie w UA wymagana jest osobna zmienna „products”.
- Zdarzenie:
UA – Menedżer tagów |
Usługa GA4 – gtag.js |
|
|
Przekaż szczegóły transakcji do obiektu dataLayer za pomocą działania zakupu i zdarzenia, które spowoduje uruchomienie tagu z włączonym Ulepszonym e-commerce. Wyślij szczegóły transakcji z odsłoną, jeśli są dostępne podczas wczytywania strony. W przeciwnym razie użyj zdarzenia, gdy dane transakcji staną się dostępne. Ważne zmiany:
|
Aby mierzyć liczbę transakcji, przekaż listę produktów do warstwy danych i rejestruj zdarzenie |
Dodatkowe działania e-commerce
Usługa GA4 może też rejestrować dodatkowe informacje:
- Wyróżnienie zachęty związanej z elementem lub zdarzeniem.
- Kupon – pozwala określić nazwę wszelkich kuponów powiązanych z danym elementem (np. bezpłatna dostawa lub 20% rabatu). Typ danych to ciąg znaków i jest to parametr elementu.
- Rabat (nowość) – umożliwia określenie wartości pieniężnej rabatu powiązanego z elementem (np. „0,05”). Typ danych to liczba zmiennoprzecinkowa.
- Promocja – obejmuje wiadomości w witrynie, które kierują użytkownika do określonej sekcji witryny lub aplikacji.
- Wymaga parametru
promotion_id
lubpromotion_name
. W przeciwnym razie dane będą dostępne tylko w standardowych raportach tabeli zdarzeń. - Aby przypisać zakup do promocji, musisz dodać parametr
promotion_id
lubpromotion_name
na poziomie elementu lub listy elementów każdego zdarzenia e-commerce.
- Wymaga parametru
- Zwroty środków – umożliwia pomiar zwrotu środków za transakcję.
- Zwrot środków to osobne zdarzenie, które obejmuje pełne i częściowe zwroty środków.
- Wymaga parametru
transaction_id
. W przeciwnym razie dane będą dostępne tylko w standardowych raportach tabeli zdarzeń.