Konfigurowanie zdarzeń

Zdarzenia umożliwiają pomiar interakcji użytkowników w witrynie lub aplikacji. Możesz np. mierzyć, kiedy ktoś wczytuje stronę, klika link lub dokonuje zakupu. Google Analytics wykorzystuje dane ze zdarzeń do tworzenia raportów z informacjami o Twojej firmie. Więcej informacji

Z tego przewodnika dowiesz się, jak za pomocą tagu Google (gtag.js) lub Menedżera tagów Google skonfigurować w witrynie zalecane zdarzeniazdarzenia niestandardowe. Nie musisz konfigurować zdarzeń zbieranych automatycznie ani zdarzeń pomiaru zaawansowanego.

Odbiorcy

Masz skonfigurowane Google Analytics i widzisz już dane w raportach, ale chcesz zbierać więcej informacji niż te, które Analytics zbiera automatycznie, lub chcesz odblokować określone 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 na koncie Google Analytics.

Omówienie tagu Google (gtag.js)

Używaj interfejsu API tagu Google (gtag.js) do wysyłania zdarzeń do Google Analytics. 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.
  • Nazwa zalecanego lub niestandardowego zdarzenia
  • (Opcjonalnie) Zbiór parametrów, które dostarczają dodatkowych informacji o zdarzeniu.

Oto np. zalecane zdarzenie 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 JavaScriptu, więc musisz dodać ją do kodu JavaScript na stronie internetowej. Możesz na przykład dodać tę funkcję w tagach <script> lub w osobnym pliku JavaScript, który zaimportujesz do strony HTML.

Zdarzenia możesz dodawać do kodu JavaScript w dowolnym miejscu poniżej fragmentu kodu tagu Google. Google nie przetwarza danych ze zdarzeń, które umieścisz powyżej fragmentu kodu tagu Google. Na przykład ten przykładowy kod zawiera zdarzenie o nazwie screen_view 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 event is sent when the page loads. You could
      *   wrap the event in a JavaScript function so the event is
      *   sent when the user performs some action.
      */
      gtag('event', 'screen_view', {
        'app_name': 'myAppName',
        'screen_name': 'Home'
      });
    </script> 
</body>
</html>

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

Wyświetlanie zdarzeń w Analytics

Zdarzenia i ich parametry masz widoczne w raportach Czas rzeczywistyDebugView. Pamiętaj, że raport DebugView trzeba skonfigurować przed użyciem. Te 2 raporty wskazują zdarzenia wywoływane stopniowo przez użytkowników w Twojej witrynie.

Dalsze kroki