Zdarzenia

Z tego artykułu dowiesz się, jak przenieść zdarzenia Universal Analytics (UA) do zdarzeń Google Analytics 4 (GA4).

Modele pomiarowe w UA i GA4 różnią się od siebie, dlatego zalecamy przemyślenie zbierania danych pod kątem modelu GA4 zamiast przenoszenia dotychczasowej struktury zdarzeń UA do GA4.

Więcej informacji o zdarzeniach GA4 znajdziesz w artykule Zdarzenia – informacje.

Porównanie zdarzeń UA i GA4

Universal Analytics

W przypadku Universal Analytics (UA) pomiar odbywa się przez wysyłanie działań. Większość typów działań służy do pomiaru konkretnych interakcji (np. pageview), ale typ działania event jest dostępny do pomiarów niestandardowych/ogólnych. Dane wysyłane z działaniem event obejmują pola Kategoria, Działanie i Etykieta.

Poniżej znajdziesz przykładowe zdarzenia Universal Analytics dotyczące bibliotek analytics.js i gtag.js:

Tag analytics.js (UA)

// Send an event using analytics.js.
ga('send', 'event', 'Settings', 'Enable', 'Dark mode');

// Alternatively, you can specify the event fields in the fieldsObject.
// The command above could be rewritten as:
ga('send', {
  hitType: 'event',
  eventCategory: 'Settings',
  eventAction: 'Enable',
  eventLabel: 'Dark mode'
});

gtag.js (UA)

gtag('event', 'Enable', {
  event_category: 'Settings',
  event_label: 'Dark mode'
});

Google Analytics 4

W przypadku Google Analytics 4 (GA4) pomiar odbywa się przez wysyłanie zdarzeń. Istnieją zdarzenia zbierane automatycznie, zdarzenia wstępnie zdefiniowane i zalecane do wysyłania w razie potrzeby, a także zdarzenia niestandardowe, które możesz wysyłać, gdy zdarzenia automatyczne lub zalecane nie spełniają Twojego przypadku użycia.

Oto przykład zdarzenia niestandardowego w GA4:

gtag.js (GA4)

gtag('event', 'settings_update', {
  setting: 'mode',
  status : 'dark'
});

Mapowanie zdarzenia UA na GA4

Aby przenieść zdarzenie UA do GA4, musisz sprawdzić, czy występuje równoważne zdarzenie GA4. Aby zmapować zdarzenie UA na GA4, zastosuj tę metodę:

  1. Przejrzyj listę Zdarzenia zebrane automatycznie. Jeśli zdarzenie zbierane automatycznie przez GA4 jest bardzo zbliżone do zdarzenia UA, usuń to zdarzenie i korzystaj ze zdarzenia zbieranego automatycznie.

  2. Jeśli w poprzednim kroku nie udało się znaleźć dopasowania, sprawdź zdarzenia zebrane za pomocą pomiaru zaawansowanego. Jeśli zdarzenie objęte pomiarem zaawansowanym w GA4 jest bardzo zgodne z celem zdarzenia UA, nie przenoś tego zdarzenia UA, tylko korzystaj z pomiaru zaawansowanego, aby je wysyłać. Aby rejestrować zdarzenia, sprawdź, czy w usłudze w GA4 pomiar zaawansowany jest prawidłowo skonfigurowany.

  3. Jeśli w poprzednim kroku nie udało Ci się znaleźć dopasowania, zapoznaj się z listą zalecanych zdarzeń. Jeśli zalecane zdarzenie GA4 jest ściśle dopasowane do przeznaczenia zdarzenia UA, użyj go i ustaw odpowiednie parametry zdarzenia podczas jego wysyłania.

  4. Jeśli nie udało Ci się znaleźć dopasowania w poprzednim kroku, wyślij Zdarzenie niestandardowe.

Scenariusze i przykłady migracji

Zdarzenia zebrane automatycznie

Zdarzenia zbierane automatycznie są zawsze wysyłane i zwykle nie można ich wyłączyć, chyba że można je skonfigurować za pomocą pomiaru zaawansowanego. Ogólnie nie należy przenosić zdarzeń UA, w przypadku których występuje w wystarczającym stopniu odpowiednik zdarzeń zbieranych automatycznie.

Na przykład zdarzenie UA wysłane w celu pomiaru interakcji z pobraniem pliku prawdopodobnie nie będzie musiało zostać przeniesione do GA4, ponieważ zdarzenie file_download w GA4 jest zbierane automatycznie.

Pomiar zaawansowany

Jeśli za pomocą pomiaru zaawansowanego zostanie zebrane wystarczająco równoważne zdarzenie GA4, nie musisz przenosić zdarzeń UA do GA4. Na przykład podane niżej zdarzenia UA prawdopodobnie nie będą wymagały przeniesienia do GA4, ponieważ są już mierzone w GA4 za pomocą pomiaru zaawansowanego:

Zastąpienie pomiaru zaawansowanego

Jeśli zdarzenie pomiaru zaawansowanego jest odpowiednie do zdarzenia UA, ale nie rejestruje wszystkich potrzebnych danych, możesz je wysłać ręcznie z dodatkowymi parametrami niestandardowymi. Wymaga to skonfigurowania lub wyłączenia pomiaru zaawansowanego dla odpowiedniego zdarzenia oraz ręcznego wysyłania zdarzenia GA4.

Na przykład zdarzenie file_download zebrane za pomocą pomiaru zaawansowanego jest bardzo podobne do zdarzenia UA, ale brakuje w nim informacji o rozmiarze pliku. Aby zastąpić zdarzenie objęte pomiarem zaawansowanym i dodać informacje o rozmiarze pliku:

  1. Wyłącz Pobrania plików w ramach pomiaru zaawansowanego.
  2. W razie potrzeby ręcznie wysyłaj zdarzenie file_download z parametrami niestandardowymi.
    • Zdarzenie zbierane automatycznie jest wyłączone w ramach pomiaru zaawansowanego, więc musisz ręcznie ustawić parametry, które są zwykle gromadzone razem ze zdarzeniem (np. file_extension, file_name itp.).
  3. Utwórz wymiar/dane niestandardowe, aby zobaczyć w raportach wartości parametrów niestandardowych.

Ten przykładowy tag gtag.js wysyła zdarzenie GA4 file_download z parametrem niestandardowym file_size.

gtag('event', 'file_download', {
  file_extension: '.mp4',
  file_name: 'tutorial.mp4',
  link_url: '/videos/tutorial.mp4',
  link_text: 'Download the tutorial!',

  // Custom parameter.
  file_size: '275 MB'
});

Jeśli Twoje zdarzenie UA ma wystarczająco odpowiednik zalecanego zdarzenia w GA4 , przenieś zdarzenie UA do zdarzenia zalecanego.

Oto przykład zdarzenia UA analytics.js służącego do pomiaru logowania:

ga('send', 'event', 'login', 'google-sso');

Możesz użyć zdarzenia login GA4 do przeniesienia tego zdarzenia z UA do GA4. Odpowiednik gtag.js GA4 jest taki:

gtag('event', 'login', {
  method: 'google-sso'
});

Zdarzenie niestandardowe

Jeśli Twoje zdarzenie UA nie ma odpowiadającego mu zdarzenia zbieranego automatycznie, pomiaru zaawansowanego ani zalecanego zdarzenia, przenieś to zdarzenie UA do zdarzenia niestandardowego i w razie potrzeby utwórz wymiary i dane niestandardowe.

Ten przykład przedstawia zdarzenie UA analytics.js, które mierzy zmiany opcji orientacji interfejsu:

ga('send', 'event', 'orientation', 'layout', 'wide');

Nie ma wstępnie zdefiniowanego zdarzenia GA4 do pomiaru podanego wyżej zdarzenia UA. Ten przykład z tagiem gtag.js pokazuje, jak za pomocą zdarzenia niestandardowego mierzy się tę samą interakcję w GA4:

gtag('event', 'orientation_update', {
  ui_element: 'layout',
  configuration: 'wide'
});

Aby uwzględnić w raportach wymiary ui_element i configuration, musisz utworzyć odpowiednie wymiary na podstawie tych parametrów zdarzenia. Więcej informacji znajdziesz w artykule Wymiary i dane niestandardowe.