Konfigurowanie usług Google i wysyłanie danych o zdarzeniach

Ta strona jest przeznaczona dla deweloperów, którzy muszą skonfigurować tag Google za pomocą gtag.js. Aby dostosować ustawienia w interfejsie, zapoznaj się z artykułem Konfigurowanie ustawień tagu Google.

Po zainstalowaniu tagu Google możesz wywoływać polecenia gtag() w dowolnym miejscu kodu po fragmencie kodu tagu Google.

Na tej stronie dowiesz się, jak:

1. Wysyłanie zdarzeń do usług Google za pomocą polecenia event
2. Ustaw wartości wysyłane z każdym zdarzeniem za pomocą polecenia set

Zanim zaczniesz

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

• zapoznać się z zasadą działania tagu Google,
• zainstalowany tag Google,

Aby skonfigurować przepływ danych, potrzebujesz:

• dostęp do kodu witryny, w której masz zainstalowany tag Google;
• Identyfikator tagu usługi Google, którą chcesz połączyć z tagiem Google.

Krok 1. Połącz usługi Google z tagiem

Aby ustanowić przepływ danych do usług Google, użyj polecenia config.

Informacje o poleceniu config

Polecenie config określa usługi Google, do których chcesz wysyłać dane zdarzeń. Polecenie ma ten format:

gtag('config', 'TAG_ID', {<additional_config_params>});

gtag('config', 'TAG_ID', {'send_page_view': false});

Konfigurowanie zbierania danych

Aby skonfigurować zbieranie danych w usłudze Google, dodaj polecenie config z identyfikatorem tagu.

Przykład

Tag Google (GT-XXXXXX) wysyła dane do zdefiniowanych przez Ciebie miejsc docelowych, np. do Google Ads i Google Analytics.

Poniższy przykład pokazuje, jak zaktualizować kod, aby wczytywać drugi tag Google połączony z miejscem docelowym Floodlight.

Aby wysyłać dane do Floodlight (identyfikator tagu: DC-ZZZZZZ), po zainicjowaniu pierwszego tagu Google (identyfikator tagu: GT-XXXXXX) dodaj kolejne polecenie config:

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

Działanie config dotyczące konkretnego produktu

W zależności od usługi określonej w TAG_ID polecenie config może też inicjować jej określone działanie. Na przykład w niektórych przypadkach polecenie config informuje gtag.js, że ma zainicjować zdarzenie wyświetlenia strony.

Aby dowiedzieć się więcej o tym, jak polecenie config działa w przypadku poszczególnych usług, przeczytaj dokumentację konkretnej usługi:

• konwersje z reklam Google Ads i remarketing
• Campaign Manager i Display & Video 360
• Search Ads 360
• Google Analytics

Krok 2. Wyślij dane za pomocą event

Po skonfigurowaniu połączeń z usługami Google musisz użyć polecenia event, aby wysyłać dane.

Informacje o poleceniu event

Polecenie event umożliwia wysyłanie danych zdarzeń do usług określonych za pomocą polecenia config. Polecenie ma ten format:

gtag('event', 'event_name', {
  'key': 'value',
});

Konfigurowanie zdarzeń

Metodę event możesz wywołać w dowolnym miejscu kodu po zainicjowaniu tagu Google.

1. Zdefiniuj zdarzenie. Jeśli używasz zalecanego zdarzenia, upewnij się, że stosujesz standardowe nazwy zdarzeń i wstępnie zdefiniowane pary klucz-wartość.

2. Określ, kiedy zdarzenie ma być wywoływane, np. czy ma być wysyłane po wczytaniu strony czy po kliknięciu przycisku.

Przykład

Poniższy przykład pokazuje jeden z możliwych sposobów pomiaru liczby subskrypcji newslettera, gdy użytkownik kliknie przycisk. W przykładzie użyto zdarzenia niestandardowego, które jest wysyłane do usługi w Google Analytics.

<head>
   ...
   /* 1. Initialize the Google tag and gtag.js library */
   <!-- Google tag (gtag.js) -->
   <script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
   <script>
     window.dataLayer = window.dataLayer || [];
     function gtag(){dataLayer.push(arguments)};
     gtag('js', new Date());
     gtag('config', 'TAG_ID');
   </script>
</head>

<body>
   <script>
     let date = Date.now();
     /* 2. Define your event. */
     function newsletterSignup() {
       gtag('event', 'newsletter_signup', {
       'time': date,
       });
   }
   </script>
   ...
   /* 3. Trigger your event */
   <button type="submit" onclick="newsletterSignup()">Sign me up!</button>
   ...
</body>

Opcjonalnie: wysyłaj dane z każdym zdarzeniem za pomocą set

Polecenie set umożliwia definiowanie parametrów, które będą powiązane z każdym kolejnym zdarzeniem na stronie.

Możesz na przykład udostępniać parametry kampanii, aby były dostępne dla wielu tagów na tej samej stronie.

Polecenie ma ten format:

gtag('set', 'parameterName');

Krok 3. Sprawdź poprawność konfiguracji

Aby mieć pewność, że dane zdarzenia są wysyłane prawidłowo:

1. Otwórz usługę Google, w której chcesz zobaczyć dane.
2. Sprawdź, czy dane są przesyłane. Każda usługa ma inne miejsce, w którym możesz sprawdzić, czy dane są odbierane:
   • Google Analytics: sprawdź raport Czas rzeczywisty.
   • Google Ads: sprawdź tabelę Działania powodujące konwersję i kolumnę Stan (aktualizacja może potrwać do 24 godzin).
   • Floodlight: użyj rozszerzenia Tag Assistant, aby sprawdzić, czy tagi Floodlight się uruchamiają.

Dalsze kroki

Po skonfigurowaniu usług i zdarzeń Google podstawowa konfiguracja tagu Google jest zakończona.

Jeśli zarządzasz wieloma usługami i chcesz bardziej szczegółowo zarządzać przepływem danych, przeczytaj artykuł Grupowanie i kierowanie danych.