Konfigurowanie zdarzeń

Zdarzenia umożliwiają pomiar interakcji użytkowników w witrynie lub aplikacji. Za pomocą zdarzeń możesz np. mierzyć, kiedy ktoś wczytuje stronę, klika link lub finalizuje zakup. Google Analytics używa danych ze zdarzeń do tworzenia raportów z informacjami o Twojej firmie. Więcej informacji

Typy zdarzeń

Zdarzenia Google Analytics są podzielone na 4 kategorie:

Typ zdarzenia Link Wymagana konfiguracja? Opis i przypadek użycia
Rejestrowane automatycznie Więcej informacji Nie Rejestrowane domyślnie, gdy skonfigurujesz tag Google Analytics w witrynie lub aplikacji. Przykłady: first_visit, session_start i user_engagement.
Pomiar zaawansowany Więcej informacji Nie (zwykle) Rejestrowane automatycznie, gdy w interfejsie Google Analytics włączony jest pomiar zaawansowany. Mierzy typowe interakcje w sieci, takie jak scroll, click i file_download.
Zalecane Zalecane zdarzenia Tak Ustandaryzowane zdarzenia dla różnych branż (np. handel detaliczny, turystyka, gry), które odblokowują gotowe panele raportowania. Przykłady: purchase, login, sign_up.
Niestandardowe Więcej informacji Tak Zdarzenia, które definiujesz samodzielnie, ponieważ żadne ze zdarzeń automatycznych, objętych pomiarem zaawansowanym ani zalecanych nie spełnia Twoich potrzeb. Dostępne w raportach niestandardowych.

Z tego przewodnika dowiesz się, jak za pomocą tagu Google (gtag.js) lub Menedżera tagów Google skonfigurować w witrynie zalecane zdarzenia i zdarzenia niestandardowe na swojej stronie. Nie musisz konfigurować zdarzeń rejestrowanych automatycznie ani zdarzeń objętych pomiarem zaawansowanym.

Odbiorcy

Masz skonfigurowaną usługę Google Analytics i zaczynasz widzieć dane w raportach, ale chcesz zbierać więcej informacji niż te, które Analytics rejestruje automatycznie, lub chcesz odblokować niektóre funkcje i możliwości Analytics.


Zanim zaczniesz

W tym przewodniku przyjęto założenie, że zostały już przez Ciebie wykonane te czynności:

Zakładamy też, że masz:

  • dostęp do kodu źródłowego swojej witryny,
  • rolę Edytujący (lub o większych uprawnieniach) na koncie Google Analytics.

Omówienie tagu Google (gtag.js)

Aby wysyłać zdarzenia do Google Analytics, użyj interfejsu API tagu Google (gtag.js). Interfejs API ma jedną funkcję o nazwie gtag(). Jeśli chcesz wysłać zdarzenie do Google Analytics, użyj tej składni:

gtag('event', '<event_name>', {
  <event_parameters>
});

W tym przykładzie funkcja gtag() zawiera te elementy:

  • polecenie event, które informuje Google, że wysyłasz zdarzenie;
  • nazwę zalecanego lub zdarzenia niestandardowego;
  • (opcjonalnie) zbiór parametrów, które zawierają dodatkowe informacje o zdarzeniu.

Oto przykład zalecanego zdarzenia o nazwie screen_view z 2 parametrami:

gtag('event', 'screen_view', {
  'app_name': 'myAppName',
  'screen_name': 'Home'
});

Dodawanie zdarzeń do kodu JavaScript

gtag() to funkcja JavaScript, więc musisz ją dodać do kodu JavaScript na stronie internetowej. Możesz na przykład dodać tę funkcję w tagach <script> lub w osobnym pliku JavaScript, który importujesz do strony HTML page.

Zdarzenia możesz dodawać do kodu JavaScript w dowolnym miejscu poniżej fragmentu kodu tagu Google. Google nie będzie przetwarzać danych ze zdarzeń umieszczonych powyżej fragmentu kodu tagu Google. Na przykład ten przykładowy kod zawiera zalecane zdarzenie o nazwie screen_view i zdarzenie niestandardowe o nazwie signup_newsletter w tagu <script>:

<!DOCTYPE html>
<html lang="en">
<head>
    <!-- Google tag (gtag.js) -->
    <script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
    <script>
    window.dataLayer = window.dataLayer || [];
    function gtag(){dataLayer.push(arguments);}
    gtag('js', new Date());

    gtag('config', 'G-XXXXXXXXXX');
    </script>

    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Title of the page</title>
</head>
<body>
    <p>Welcome to my website!</p>
    
    <script>
      /**
      *   The following events are sent when the page loads. You send
      *   recommended and custom events the same way. You could wrap
      *   the events in JavaScript functions so they are sent when
      *   users perform specific actions.
      */
      gtag('event', 'screen_view', {
        'app_name': 'myAppName',
        'screen_name': 'Home'
      });
      gtag('event', 'signup_newsletter', {
        'method': 'web'
      });
    </script> 
</body>
</html>

Jeśli chcesz wysyłać zdarzenie na podstawie kliknięcia przycisku (lub innej czynności użytkownika), możesz dodać do zdarzenia dodatkowy kod JavaScript.

Konfigurowanie wielu zdarzeń

Śledzenie różnych interakcji użytkowników wymaga zaimplementowania w kodzie JavaScript witryny wielu gtag('event', ...) wywołań, z których każde jest wywoływane przez określoną czynność lub warunek. W przykładach używamy zarówno zalecanych zdarzeń, jak i niestandardowych zdarzeń.

Aby na przykład śledzić różne działania, takie jak logowanie użytkowników, udostępnianie treści i ukończenie samouczka, zaimplementuj osobne gtag('event', ...)wywołania:

Przykład: śledzenie logowań

Ten fragment kodu zostanie uwzględniony w funkcji JavaScript, która obsługuje udane logowanie użytkownika.

// Send a 'login' event when a user signs in
gtag('event', 'login', {
  method: 'Email' // Example parameter indicating login method
});

Przykład: śledzenie udostępniania treści

Ten fragment kodu zostanie powiązany ze zdarzeniem kliknięcia przycisku udostępniania.

// Send a 'share' event when a user clicks a share button
gtag('event', 'share', {
  method: 'Facebook',
  content_type: 'Article',
  item_id: 'C12345' // Example parameter for the shared item
});

Przykład: śledzenie zdarzenia niestandardowego

Ten fragment kodu zostanie wywołany, gdy użytkownik pomyślnie ukończy samouczek w witrynie.

// Send a custom event
gtag('event', 'tutorial_complete', {
  tutorial_name: 'Introduction to GA4'
});

Te wywołania gtag('event', ...) umieszczasz w różnych miejscach kodu witryny , aby rejestrować dane w odpowiednim momencie. Każde zdarzenie jest wysyłane do Google Analytics w momencie jego wystąpienia. Nie ma specjalnej składni ani pojedynczego wywołania, które umożliwiałoby zdefiniowanie lub wysłanie w pakiecie wielu różnych typów zdarzeń za pomocą gtag.js. Dla każdego zdarzenia, które chcesz wysłać, musisz wywołać gtag('event', ...).

Wyświetlanie zdarzeń w Analytics

Zdarzenia i ich parametry masz widoczne w raportach Czas rzeczywisty i DebugView. Pamiętaj, że raport DebugView wymaga dodatkowej konfiguracji przed użyciem. Te 2 raporty pokazują zdarzenia wywoływane przez użytkowników w Twojej witrynie w momencie ich wywołania.

Dalsze kroki

Wstecz
Web
Dalej
Dodaj parametry