W tym dokumencie opisujemy zgodność i przekształcanie zdarzeń e-commerce między Universal Analytics (UA) a Google Analytics 4 (GA4).
Wprowadzenie
Po wysłaniu do usługi w UA zdarzenia e-commerce w GA4 są automatycznie przekształcane w odpowiadające im zdarzenia UA. Translacja ma też miejsce, gdy wysyłasz do usługi w GA4 zdarzenia e-commerce UA. W tym dokumencie wyjaśniamy, jak działa tłumaczenie, jaka jest zgodność zdarzeń i jakie kompromisy, jakich może dochodzić, gdy korzystasz z automatycznego tłumaczenia.
Purpose
Tłumaczenie zdarzeń e-commerce UA i GA4 pomaga w następujących kwestiach:
- Łatwa implementacja: zacznij korzystać z e-commerce w GA4, korzystając z dotychczasowej implementacji UA z niewielką aktualizacją konfiguracji.
- Wyeliminuj potrzebę stosowania podwójnego tagowania: do usługi w UA i GA4 możesz wysyłać te same zdarzenia e-commerce. Umożliwia to przejście na GA4 i zachowanie implementacji e-commerce UA bez konieczności obsługi konfiguracji z 2 tagami.
Kompromis
Zgodność zapewnia elastyczność i możliwość wyboru ścieżki migracji GA4, która najlepiej spełni Twoje krótko- i długoterminowe wymagania związane z utrzymaniem implementacji UA.
Większość zdarzeń i parametrów e-commerce GA4 jest zgodna z UA i odwrotnie. W przypadku niewielkiej liczby niezgodności raporty e-commerce z UA i GA4 mogą nie być w pełni wypełnione danymi. Zależy to od wybranego sposobu migracji.
Pamiętaj, aby zapoznać się z każdą opcją migracji, aby uzyskać szczegółowe informacje o zgodności i wymaganej konfiguracji.
Jak działa tłumaczenie
Tag zdarzenia GA4
- Używanie gtag to zalecany sposób wysyłania zdarzeń e-commerce GA4. Tag zdarzenia GA4 może jednak odczytywać dane e-commerce przekazywane do warstwy danych.
- Parametry zdarzenia GA4 skonfigurowane bezpośrednio w tagu zdarzenia GA4 mają pierwszeństwo przed danymi przesyłanymi z tagu gtag, warstwy danych lub zmiennej niestandardowej.
- Tag zdarzenia GA4 jest zgodny wstecznie z danymi zdarzeń e-commerce używanymi w Universal Analytics. Oto jak działają priorytety:
- Używaj zdarzeń e-commerce GA4.
- Jeśli nie znajdziesz zdarzeń e-commerce GA4, wyszukaj zdarzenia e-commerce UA i je wykorzystaj.
- Jeśli zdarzenie e-commerce UA jest używane z tagiem zdarzenia GA4, przed wysłaniem go do usługi w GA4 zostanie ono najpierw przekształcone w odpowiednie zdarzenie e-commerce w GA4. Dotyczy to niezależnie od tego, czy używasz tagu gtag, warstwy danych czy obiektu niestandardowego.
Tag Universal Analytics
- Tag Universal Analytics obsługuje odczyt zdarzeń e-commerce GA4 (w tym danych wysyłanych za pomocą tagu gtag).
- Jeśli w tagu włączono odczytywanie zdarzeń e-commerce GA4, obowiązuje takie działanie pierwszeństwa:
- Używaj zdarzeń e-commerce GA4.
- Jeśli nie znajdziesz zdarzeń e-commerce GA4, wyszukaj zdarzenia e-commerce UA i je wykorzystaj.
- Jeśli zdarzenie e-commerce GA4 jest używane z tagiem Universal Analytics, przed wysłaniem go do usługi w UA zostanie ono najpierw przekształcone w odpowiednie zdarzenie e-commerce UA. Dotyczy to zarówno tagu gtag, warstwy danych, jak i obiektu niestandardowego.
Parametry porównywalne w UA i GA4
W tabeli poniżej znajdziesz porównywalne parametry e-commerce w Universal Analytics i Google Analytics 4.
Nazwa parametru Universal Analytics | Nazwa parametru Google Analytics 4 | Uwagi |
---|---|---|
affiliation |
affiliation |
|
checkout_step |
||
checkout_option |
||
content_type |
||
coupon |
coupon |
|
currency |
currency |
Gdy wysyłasz zdarzenie UA do usługi w GA4, ta wartość waluty zostanie użyta w parametrze items[].currency GA4. |
location_id |
||
payment_type |
||
shipping |
shipping |
|
shipping_tier |
||
tax |
tax |
|
transaction_id |
transaction_id |
|
value |
value |
|
items[] |
items[] |
|
items[].name |
items[].item_name |
|
items[].id |
items[].item_id |
|
items[].affiliation |
||
items[].brand |
items[].item_brand |
|
items[].category |
items[].item_category items[].item_category2 items[].item_category3 items[].item_category4 items[].item_category5 |
Kategoria produktu. Można określić maksymalnie 5 poziomów hierarchii.
Szczegółowe informacje o przekształcaniu zdarzeń UA i GA4 znajdziesz w sekcji Translacja parametrów kategorii.
|
items[].currency |
||
items[].coupon |
items[].coupon |
|
items[].discount |
||
items[].list_name |
items[].item_list_name |
|
items[].list_position |
items[].index |
|
items[].location_id |
||
items[].price |
items[].price |
|
items[].quantity |
items[].quantity |
|
items[].variant |
items[].item_variant |
|
promotions[] |
W GA4 parametr items[] jest używany z parametrami specyficznymi dla promocji, np. items[].promotion_id . |
|
promotions[].id |
items[].promotion_id |
Te parametry nie są przekształcane podczas wysyłania zdarzenia UA do GA4 lub odwrotnie. |
promotions[].name |
items[].promotion_name |
Te parametry nie są przekształcane podczas wysyłania zdarzenia UA do GA4 lub odwrotnie. |
promotions[].creative_name |
||
promotions[].creative_slot |
items[].creative_slot |
Te parametry nie są przekształcane podczas wysyłania zdarzenia UA do GA4 lub odwrotnie. |
Translacja parametru kategorii
Translacja parametru kategorii jest uwzględniana w szczególnych przypadkach podczas wysyłania zdarzeń GA4 do UA i odwrotnie.
W przypadku Universal Analytics do ustawiania parametru items[].category
używasz /
jako separatora, który pozwala określić maksymalnie 5 poziomów hierarchii. W Google Analytics 4 wyliczane parametry kategorii służą do określania do 5 poziomów hierarchii: items[].item_category
, items[].item_category2
, items[].item_category3
, items[].item_category4
i items[].item_category5
.
Tłumaczenie kategorii działa tak:
- W przypadku zdarzeń GA4 przekształconych do UA wyliczone kategorie zostaną połączone w jeden parametr
category
, a każda kategoria będzie oddzielona znakiem/
. - W przypadku zdarzeń UA przekształconych do GA4 wartość parametru kategorii zostanie podzielona, aby wypełnić odpowiednie kategorie wyliczone w GA4.
- Jeśli chcesz wysyłać do UA zdarzenia GA4, nie zalecamy używania w wartościach kategorii znaku
/
, ponieważ będzie on interpretowany jako separator kategorii przy tłumaczeniu do UA. - Użyjemy tylko 5 pierwszych poziomów kategorii, niezależnie od tego, ile z nich zostało zdefiniowanych.
Przykład translacji kategorii
W podanych niżej przykładach widać parametr kategorii UA przekształcony w GA4. Ta sama zasada obowiązuje przy przekształcaniu zdarzenia GA4 na UA.
Zdarzenie UA z kategorią, która określa 5 poziomów hierarchii:
gtag("event", "add_to_cart", {
items: [{
...
category: "Apparel/Adult/Shirts/Crew/Short sleeve",
...
}]
});
Zdarzenie UA zostanie przekształcone w zdarzenie GA4 z wyliczonymi kategoriami:
gtag("event", "add_to_cart", {
items: [{
...
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
...
}]
});
Zgodność zdarzeń UA i GA4
W tabeli poniżej znajdziesz porównywalne zdarzenia e-commerce w Universal Analytics i Google Analytics 4 oraz zachowanie translacji podczas wysyłania zdarzenia UA do GA4 i odwrotnie.
W każdym wierszu tabeli każda kolumna zawiera te informacje:
- Kolumny Zdarzenie UA i Zdarzenie GA4 wskazują zdarzenia porównywalne na podstawie ich przeznaczenia.
- Parametry zawiera listę parametrów, które nie mają odpowiednika między odpowiednimi zdarzeniami UA i GA4. Tylko GA4 zawiera listę parametrów używanych tylko w zdarzeniu GA4, a lista parametrów Tylko w UA – listę parametrów używanych tylko w tym zdarzeniu UA.
- Zachowanie translacji (Wysyłanie UA do GA4) opisuje zachowanie translacji podczas wysyłania zdarzenia UA do usługi w GA4. Uwagi zawierają szczegółowe informacje o przesłanych danych, różnicach w stosunku do zdarzenia GA4 i wszelkim znaczącym wpływie na raporty GA4.
- Zachowanie translacji (wysyłanie GA4 do UA) opisuje zachowanie translacji podczas wysyłania zdarzenia UA do usługi GA4. Uwagi zawierają szczegółowe informacje o wysyłanych danych, różnicach w stosunku do zdarzenia UA i wszelkim znaczącym wpływie na raporty UA.
Zdarzenie UA | Wydarzenie GA4 | Parametry | Sposób translacji (Wysyłanie z UA do GA4) |
Sposób translacji (Wysyłanie GA4 do UA) |
---|---|---|---|---|
Wyświetlenia produktu (impressions )
|
|
Tylko w GA4:
item_list_id item_list_name items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id |
Zgodne.
Wszystkie parametry UA są przekształcane w ich odpowiedniki w GA4 i wysyłane.
Raporty GA4, które wymagają parametrów tylko w GA4, będą niekompletne.
|
Zgodne.
Parametry GA4 z odpowiednim parametrem UA są przekształcane i wysyłane. Parametry tylko w GA4 nie są wysyłane.
Parametr item_list_name na poziomie zdarzenia jest ignorowany. Wysyłane będzie tylko item_list_name na poziomie produktu.
Raporty UA wypełniane danymi ze zdarzenia GA4 będą pełne lub niezmienione.
|
Kliknięcia produktu (click )
|
|
Tylko w GA4:
item_list_id item_list_name items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id Tylko w UA: content_type |
Niezgodność. Wysłano zdarzenie niestandardowe select_content i content_type parametr niestandardowy. Żadne dane z kategorii items nie zostaną wysłane.
|
Niezgodny. Działanie zdarzenia UA jest wysyłane z parametrem general (ogólny) jako event_category i select_item jako event_action . Żadne dane items nie zostaną wysłane.
|
Kliknięcia promocji (promoClick )
|
|
Tylko w GA4:
creative_name creative_slot location_id promotion_id promotion_name items Tylko w UA: content_type promotions |
Niezgodne. Wysłano zdarzenie niestandardowe select_content z parametrami niestandardowymi content_type i promotions . Parametr niestandardowy promotions nie zawiera żadnych przydatnych danych.
|
Niezgodny. Działanie zdarzenia UA jest wysyłane z parametrem general (ogólny) jako event_category i select_promotion jako event_action . Żadne dane promotions nie zostaną wysłane.
|
View of Product Details (Wyświetlenia szczegółów produktu) (detail )
|
|
Tylko w GA4:
currency value items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id |
Zgodne.
Wszystkie parametry UA są przekształcane w ich odpowiedniki w GA4 i wysyłane.
Raporty GA4, które wymagają parametrów tylko w GA4, będą niekompletne.
|
Zgodne.
Parametry GA4 z odpowiednim parametrem UA są przekształcane i wysyłane. Wyjątek to wartość item_list_name . Ta wartość nie jest wysyłana. Z parametrów tylko GA4 przesyłane są parametry currency i value z działaniem odpowiednio jako
currency i
Przychody z transakcji. event_value jest też ustawiony na parametr value jako liczbę całkowitą.
Pamiętaj, że przekształcanie z GA4 w UA obejmuje funkcję event_value , ale zwykle nie jest ona ustawiona w przypadku działań UA.
Raporty UA wypełniane danymi z GA4 będą w większości pełne lub niezmienione.
Brakuje nazwy listy produktów.
|
add_to_wishlist*
*UA nie obsługuje danych typu
items .
|
|
Tylko w GA4:
items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id |
Zgodne.
Wszystkie parametry UA są przekształcane w ich odpowiedniki w GA4 i wysyłane.
Raporty GA4, które wymagają parametrów tylko w GA4, będą niekompletne.
|
Zgodne.
Równoważne
działanie związane ze zdarzeniem jest wysyłane z ecommerce jako event_category , ecommerce jako event_action , a parametr value jako event_value .
Raporty UA wypełniane danymi ze zdarzenia GA4 będą pełne lub niezmienione.
To zdarzenie nie jest zazwyczaj obsługiwane w raportach e-commerce UA, więc nie będzie miało znaczącego wpływu.
|
Dodawanie produktu do koszyka (add )
|
|
Tylko w GA4:
items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id |
Zgodne.
Wszystkie parametry UA są przekształcane w ich odpowiedniki w GA4 i wysyłane.
Raporty GA4, które wymagają parametrów tylko w GA4, będą niekompletne.
|
Zgodne.
Parametry GA4 z odpowiednim parametrem UA są przekształcane i wysyłane*. Parametry tylko w GA4 nie są wysyłane.
*Parametr item_list_name nie jest wysyłany, ale jest to zgodne z tagiem gtag.js (UA), który nie wysyła parametru list_name .
Raporty UA wypełniane danymi ze zdarzenia GA4 będą pełne lub niezmienione.
|
Usuwanie produktu z koszyka (remove )
|
|
Tylko w GA4:
items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id |
Zgodne.
Wszystkie parametry UA są przekształcane w ich odpowiedniki w GA4 i wysyłane.
Raporty GA4, które wymagają parametrów tylko w GA4, będą niekompletne.
|
Zgodne.
Parametry GA4 z odpowiednim parametrem UA są przekształcane i wysyłane*. Parametry tylko w GA4 nie są wysyłane.
*Parametr item_list_name nie jest wysyłany, ale działa to zgodnie z tagiem gtag.js (UA), który nie wysyła parametru list_name .
Raporty UA wypełniane danymi ze zdarzenia GA4 będą pełne lub niezmienione.
|
Nie dotyczy |
|
Zdarzenie jest zalecane tylko w przypadku GA4. |
Niezgodny*.
*Mało prawdopodobne, że Twoja implementacja UA wyśle to zdarzenie, ponieważ nie jest ono zalecane. Aby mieć pewność, że raporty GA4 będą kompletne, możesz wdrożyć to zdarzenie w UA, korzystając z formatu GA4.
Jeśli zaimplementujesz zdarzenie GA4 w UA, będzie ono widoczne jako zdarzenie bez danych
items , co może nie być przydatne. Nie będzie to miało wpływu na raportowanie e-commerce UA.
|
Niezgodność.
Działanie związane ze zdarzeniem jest wysyłane z ogólnym wartością event_category ,
view_cart jako event_action , a
parametrem value jako event_value .
Dane typu items nie zostały wysłane.
To zdarzenie nie jest zazwyczaj obsługiwane w raportach e-commerce UA, więc nie będzie miało znaczącego wpływu.
|
Proces płatności (checkout , checkout_option )
|
|
Tylko w GA4:
items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id |
Zgodne.
Wszystkie parametry UA są przekształcane w ich odpowiedniki w GA4 i wysyłane.
Raporty GA4, które wymagają parametrów tylko w GA4, będą niekompletne.
|
Zgodne.
Parametry GA4 z odpowiednim parametrem UA są przekształcane i wysyłane*. Parametry tylko w GA4 nie są wysyłane.
*Parametr item_list_name nie jest wysyłany, ale działa to zgodnie z tagiem gtag.js (UA), który nie wysyła parametru list_name .
begin_checkout jest odpowiednikiem wysłania zdarzenia checkout_progress z checkout_step ustawionym na 1 .
Raporty UA wypełniane danymi ze zdarzenia GA4 będą pełne lub niezmienione.
|
add_payment_info
|
|
Tylko w GA4:
currency value coupon payment_type items UA: Nie dotyczy: parametry nie są obsługiwane.
|
Niezgodny*.
*UA nie obsługuje parametrów tego zdarzenia, więc żaden nie jest wysyłany. Będzie działać, ale raczej nie będzie przydatna.
Raporty GA4, które wymagają parametrów zdarzeń, będą niekompletne.
|
Zgodne.
Równoważne
działanie związane ze zdarzeniem jest wysyłane z ecommerce jako event_category , ecommerce jako event_action , a parametr value (przestawiony na liczbę całkowitą) jako event_value . Pamiętaj, że przekształcanie z GA4 w UA obejmuje funkcję event_value , ale zwykle nie jest ona ustawiona w przypadku działań UA.
Raporty UA wypełniane danymi ze zdarzenia GA4 będą pełne lub niezmienione.
To zdarzenie nie jest zazwyczaj obsługiwane w raportach e-commerce UA, więc nie będzie miało znaczącego wpływu.
|
Nie dotyczy |
|
Zdarzenie jest zalecane tylko w przypadku GA4. |
Niezgodny*.
*Mało prawdopodobne, że Twoja implementacja UA wyśle to zdarzenie, ponieważ nie jest ono zalecane. Aby mieć pewność, że raporty GA4 będą kompletne, możesz wdrożyć to zdarzenie w UA, korzystając z formatu GA4.
Jeśli zaimplementujesz zdarzenie GA4 w UA, będzie ono widoczne jako zdarzenie bez danych
items , co może nie być przydatne. Nie będzie to miało wpływu na raportowanie e-commerce UA.
|
Niezgodny*.
Działanie związane ze zdarzeniem jest wysyłane z ogólnym wartością event_category ,
add_shipping_info jako event_action , a parametrem value (przeniesionym na liczbę całkowitą) jako
event_value . Parametr currency GA4 jest wysyłany z działaniem jako
currency.
To zdarzenie nie jest zazwyczaj obsługiwane w raportach e-commerce UA, więc nie będzie miało znaczącego wpływu.
|
Proces płatności (checkout , checkout_option )
|
Nie dotyczy | Zdarzenia są zalecane tylko w UA. |
Zdarzenie będzie traktowane jako
zdarzenie niestandardowe. Zostaną wysłane tylko parametry na poziomie zdarzenia. Żadne dane items nie zostaną wysłane.
Zdarzenia te nie są zwykle obsługiwane w raportach e-commerce GA4, więc nie będą miały znaczącego wpływu.
|
Nie dotyczy |
Wyświetlenia promocji (promoView )
|
|
Tylko w GA4:
creative_name creative_slot location_id promotion_id promotion_name items Tylko w UA: promotions |
Niezgodne. Wysłano zdarzenie niestandardowe view_promotion z parametrem niestandardowym promotions . Parametr niestandardowy promotions nie zawiera żadnych przydatnych danych.
|
Niezgodny. Działanie zdarzenia UA jest wysyłane z parametrem engagement (zaangażowanie) jako event_category , a view_promotion jako event_action . Żadne dane promotions nie zostaną wysłane. Zdarzenie jest oznaczone jako
Zdarzenie niebędące interakcją.
|
Pomiary zakupów (purchase )
|
|
Tylko w GA4:
items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id |
Zgodne.
Wszystkie parametry UA są przekształcane w ich odpowiedniki w GA4 i wysyłane.
Używana jest currency na poziomie zdarzenia, ponieważ element currency na poziomie produktu nie jest obsługiwany.
Raporty GA4, które wymagają parametrów tylko w GA4, będą niekompletne.
|
Zgodne.
Parametry GA4 z odpowiednim parametrem UA są przekształcane i wysyłane*. Parametry tylko w GA4 nie są wysyłane.
*Parametr item_list_name nie jest wysyłany, ale działa to zgodnie z tagiem gtag.js (UA), który nie wysyła parametru list_name .
Raporty UA wypełniane danymi ze zdarzenia GA4 będą pełne lub niezmienione.
|
Pomiary zwrotów (refund )
|
|
Tylko w GA4:
affiliation items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id |
Zgodne.
Wszystkie parametry UA są przekształcane w ich odpowiedniki w GA4 i wysyłane.
Używana jest currency na poziomie zdarzenia, ponieważ element currency na poziomie produktu nie jest obsługiwany.
Raporty GA4, które wymagają parametrów tylko w GA4, będą niekompletne.
|
Zgodne.
Parametry GA4 z odpowiednim parametrem UA są przekształcane i wysyłane*. Parametry tylko w GA4 nie są wysyłane.
*Parametr item_list_name nie jest wysyłany, ale działa to zgodnie z tagiem gtag.js (UA), który nie wysyła parametru list_name .
Raporty UA wypełniane danymi ze zdarzenia GA4 będą pełne lub niezmienione.
|