Wysyłanie zdarzeń internetowych do GA4 za pomocą Measurement Protocol

1. Wprowadzenie

Ostatnia aktualizacja: 30.04.2019

Co utworzysz

Z tego modułu dowiesz się, jak wysyłać zdarzenia zewnętrzne do GA4 za pomocą Measurement Protocol.
W tym samouczku zakładamy, że masz już stronę internetową lub witrynę z wdrożoną usługą Google Analytics 4.

Czego się nauczysz

Jak wykonać pierwsze wywołanie MP
Zapoznanie z parametrami wymaganymi na potrzeby wywołania
Wysyłanie i weryfikowanie wywołania testowego
Utwórz przykładowy skrypt w Pythonie, aby wykonać połączenie

Czego potrzebujesz

Witryna lub strona internetowa
Dowolne środowisko IDE do wprowadzania zmian
Konto GA4
Opcjonalnie – środowisko programistyczne w języku Python (lub Colab)

2. Zbieranie pól obowiązkowych

Tworzenie tajnego klucza API w GA4

Otwórz GA4 i utwórz nowy tajny klucz API. W tym celu kliknij kolejno Administracja > Strumienie danych > wybierz strumień > Measurement Protocol > Utwórz.

Możesz podać dowolny pseudonim, a wyświetli się wartość obiektu tajnego, której możesz użyć w wywołaniu.

Zbieranie identyfikatora klienta

Aby uzyskać identyfikator klienta, możesz użyć dowolnej z tych metod.

Zbieranie danych za pomocą tagu Google

Obie te metody zostały szczegółowo opisane poniżej.

Zbieranie danych za pomocą tagu gTag

Identyfikator client_id możesz pobrać ze swojej witryny za pomocą tego kodu :

gtag('get', 'UA-XXXXXXXX-Y', 'client_id', (clientID) => {
  Do something with clientID)
}

Poniżej znajdziesz więcej linków w zależności od infrastruktury.

gtag.js(‘get')

3. Tworzenie połączenia

Przykładowe wywołanie możesz utworzyć w GA4 za pomocą Event Builder. (w tym celu musisz się zalogować i mieć włączone pliki cookie). Upewnij się, że przełącznik znajduje się w położeniu „gtag.js”.

Musisz wypełnić te pola:

api_secret – utworzony wcześniej w GA4
measurement_id – aby go uzyskać, kliknij kolejno Administracja > Strumienie danych > wybierz swój strumień . Powinien on wyglądać tak:

client_id – ta wartość została już pobrana.
user_id nie jest obowiązkowy. Możesz na razie pozostawić to pole puste.
Kategoria – w menu kliknij „Niestandardowe” i wpisz dowolną nazwę zdarzenia (nie używaj żadnego zdarzenia zbieranego automatycznie). Używamy tutaj nazwy „test_from_codelab”.

Opcjonalnie możesz też podać parametry zdarzenia lub właściwości użytkownika, klikając przyciski poniżej.

Po wypełnieniu wszystkich pól powinna pojawić się tabela podobna do tej poniżej z przyciskiem „Sprawdź wydarzenie”.

Gdy to zrobisz, kliknij przycisk „SPRAWDŹ ZDARZENIE” (zaznaczony na pomarańczowo). Powinien wyświetlić się komunikat poniżej, informujący, że zdarzenie jest prawidłowe, oraz przycisk „WYŚLIJ DO GA”. Jeśli w tym momencie zdarzenie zostanie uznane za nieprawidłowe, narzędzie wskaże dokładne pole, w którym występuje problem. Możesz go rozwiązać i spróbować ponownie.

Teraz możesz kliknąć przycisk. Powinno to spowodować wysłanie zdarzenia testowego do GA4.

4. Weryfikowanie zdarzeń w GA4

Po wysłaniu zdarzenia możesz przejść na konto GA4 i sprawdzić raport Czas rzeczywisty. Powinno się pojawić zdarzenie.

Zanim zdarzenia zostaną przeniesione z widoku czasu rzeczywistego na kartę raportowania zdarzeń, może minąć około 24 godzin, więc nie musisz się martwić, jeśli nie zobaczysz ich od razu w raportach o zdarzeniach.

5. Tworzenie skryptu w Pythonie

Po przetestowaniu możesz sprawdzić wywołanie interfejsu API i ładunek zdarzenia, aby utworzyć podobną architekturę w Pythonie (lub w dowolnym wybranym języku), która może wykonywać to wywołanie. Możesz wtedy zaplanować to działanie z wybraną częstotliwością i wdrożyć je w praktyce. W tej części możesz użyć dowolnego środowiska IDE obsługującego język Python lub po prostu notatnika Google Colab, który nie wymaga instalacji na urządzeniu.

W narzędziu do tworzenia zdarzeń GA4 zobaczysz, że punkt końcowy jest taki jak poniżej:

POST /mp/collect?measurement_id=XXXX&api_secret=XXXX 
HTTP/1.1
Host: www.google-analytics.com

Ładunek zdarzenia wyglądał tak:

{
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}

Możesz to przetłumaczyć na Pythona, używając czegoś takiego:

import requests
import json
url = "https://www.google-analytics.com/mp/collect?measurement_id=XXXX&api_secret=XXXX"
payload = {
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}
r = requests.post(url,data=json.dumps(payload),verify=True)
print(r.status_code)

Po wykonaniu tego działania z odpowiednimi wartościami zdarzenie powinno być widoczne w GA4 w czasie rzeczywistym.

6. Gratulacje

Gratulacje! Udało Ci się użyć Measurement Protocol w GA4. Możesz teraz tworzyć zaawansowane architektury rozwiązań, aby wysyłać do Google Analytics bardziej przydatne dane i ulepszać marketing oraz analizy biznesowe. Aby w pełni wykorzystać tę funkcję, zalecamy też połączenie z Google Ads i zaimportowanie tych zdarzeń jako konwersji.

Dowiesz się:

Jak zbierać odpowiednie zmienne do wykonywania połączeń MP
Wysyłanie i weryfikowanie zdarzeń testowych
Jak utworzyć skrypt do wysyłania połączeń MP