Dokumentacja zgodności i translacji zdarzeń e-commerce (gtag.js)

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

  • Gdy zdarzenie e-commerce GA4 jest wysyłane do usługi w UA, jest ono przekształcane w odpowiednie zdarzenie e-commerce UA (gtag.js).
    • Parametry zdarzeń UA są wypełniane wartościami z porównywalnych parametrów GA4. Jeśli parametru UA nie można wypełniać ze zdarzenia GA4 (tj. nie ma porównywalnych parametru), jest on pomijany podczas wysyłania zdarzenia do usługi w UA.
  • Gdy zdarzenie e-commerce UA (gtag.js) jest wysyłane do usługi w GA4, jest ono przekształcane w odpowiednie zdarzenie e-commerce w GA4.
    • Parametry zdarzeń GA4 są wypełniane wartościami z porównywalnych parametrów UA. Jeśli danego parametru GA4 nie można wypełniać ze zdarzenia UA (czyli nie ma on odpowiednika), jest on pomijany podczas wysyłania zdarzenia do usługi w GA4. W niektórych przypadkach, jeśli parametr UA nie ma porównywalnej parametru GA4, zostanie on wysłany ze zdarzeniem GA4 jako parametr niestandardowy.
  • Wszystkie tłumaczenia z GA4 na UA i odwrotnie są wykonywane po stronie klienta.
  • Tłumaczenia zdarzeń/parametrów są domyślnie włączone, nie można jej wyłączyć, nie wymaga konfigurowania żadnych ustawień użytkownika.

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)
view_item_list 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.
select_content (items) 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_typeparametr 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.
select_content (promotions) 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_item 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.
add_to_cart 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.
remove_from_cart 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.
begin_checkout 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.
checkout_progress
set_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
view_promotion 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ą.
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.
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.