1. Wprowadzenie
Ostatnia aktualizacja: 30.04.2019
Co utworzysz
- Z tego ćwiczenia w Codelabs dowiesz się, jak wysyłać zdarzenia zewnętrzne do GA4 za pomocą Measurement Protocol.
- W tym ćwiczeniu w programowaniu zakładamy, że masz już stronę internetową/witrynę z wdrożoną usługą Google Analytics 4.
Czego się nauczysz
- Kroki do wykonania pierwszego połączenia w formacie MP
- Omówienie parametrów wymaganych do wywołania
- Wysyłanie i weryfikowanie połączenia testowego
- Tworzenie przykładowego skryptu w Pythonie w celu wywołania
Czego potrzebujesz
- Witryna lub strona internetowa
- Dowolne IDE do wprowadzania zmian
- Konto GA4
- Opcjonalnie: środowisko programistyczne Pythona (lub Colab)
2. Uzupełnij pola obowiązkowe
Tworzenie obiektu tajnego API w GA4
Przejdź do GA4 i utwórz nowy tajny klucz API. W tym celu kliknij Administracja > Strumienie danych > wybierz strumień > Measurement Protocol > Utwórz
Możesz podać dowolny pseudonim, a zostanie wyświetlona wartość obiektu tajnego, której możesz użyć podczas rozmowy.
Zbieranie danych client_id
Identyfikator client_id możesz zbierać, korzystając z dowolnej z poniższych metod.
- Zbieranie przez gtag
Oba te przypadki zostały szczegółowo wyjaśnione poniżej
Zbieranie danych za pomocą tagu gtag
Możesz uzyskać identyfikator client_id ze swojej witryny za pomocą :
gtag('get', 'UA-XXXXXXXX-Y', 'client_id', (clientID) => {
Do something with clientID)
}
Poniżej znajdziesz więcej linków zależnie od Twojej infrastruktury
3. Tworzenie rozmowy
Możesz utworzyć przykładowe wywołanie za pomocą Kreatora zdarzeń w GA4. (Aby to zrobić, należy się zalogować i włączyć obsługę plików cookie). Upewnij się, że przełącznik jest ustawiony na „gtag.js”
Musisz wypełnić następujące pola
- api_secret – został już utworzony wcześniej w GA4.
- pomiar_id – aby go uzyskać, przejdź do sekcji Administracja > Strumienie danych > wybierz strumień . Powinien wyglądać tak jak poniżej.
- client_id – ta wartość została już pobrana
- Parametr user_id nie jest wymagany. Możesz na razie zostawić to pole puste
- Kategoria – zmień na „Niestandardowa” i wpisz dowolną nazwę zdarzenia (nie używaj żadnego zdarzenia zbieranego automatycznie). Tutaj używamy parametru „test_from_codelab”
Opcjonalnie możesz też podać parametry zdarzenia lub właściwości użytkownika, klikając przyciski poniżej
Gdy wypełnisz wszystkie pola, zobaczysz coś takiego z przyciskiem „Sprawdź zdarzenie”.
Gdy to zrobisz, kliknij „SPRAWDŹ WYDARZENIE”. , przycisk jest wyróżniony na pomarańczowo. Powinien wyświetlić się komunikat poniżej z informacją, że zdarzenie jest prawidłowe. Powinien pojawić się przycisk „WYŚLIJ DO GA”. Jeśli na tym etapie zdarzenie okaże się nieprawidłowe, narzędzie poda dokładne pole, w którym występuje problem, co umożliwi Ci naprawienie tego błędu i spróbowanie jeszcze raz.
Możesz już kliknąć ten przycisk. Powinien on wysłać zdarzenie testowe do GA4.
4. Weryfikowanie zdarzeń w GA4
Po wysłaniu zdarzenia możesz przejść na swoje konto GA4 i sprawdzić dane w czasie rzeczywistym. Powinno wyświetlić się zdarzenie.
Rozpowszechnienie zdarzeń z widoku w czasie rzeczywistym na karcie raportowania zdarzeń może potrwać do 24 godzin, więc nie martw się, jeśli nie pojawi się on od razu w standardowych raportach o zdarzeniach.
5. Tworzenie skryptu Pythona
Po przetestowaniu tego interfejsu możesz sprawdzić wywołanie interfejsu API i ładunek zdarzenia, aby utworzyć podobną architekturę w Pythonie (lub w dowolnym wybranym języku), która obsługuje to wywołanie. Możesz potem zaplanować tę częstotliwość i wdrożyć ją z wybraną częstotliwością. W tej części możesz użyć dowolnego IDE obsługującego Pythona lub po prostu użyć notatnika Google Colab, który nie wymaga instalacji na urządzeniu.
W Kreatorze zdarzeń GA4 znajdziesz punkt końcowy przedstawiony 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 kodu podobnego do tego:
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)
Gdy wykonasz kod z właściwymi wartościami, zdarzenie powinno być również odzwierciedlane w czasie rzeczywistym w GA4.
6. Gratulacje
Gratulujemy korzystania z platformy Measurement Protocol w GA4. Możesz teraz tworzyć zaawansowane architektury rozwiązań, które pozwalają wysyłać do Google Analytics bardziej przydatne dane oraz ulepszać analitykę biznesową i marketingową. Aby w pełni wykorzystać możliwości, warto też połączyć się z Google Ads i zaimportować te zdarzenia jako konwersje.
Wiesz już,
- Jak zbierać odpowiednie zmienne, aby wykonywać wywołania MP
- Jak wysyłać i weryfikować zdarzenia testowe
- Jak utworzyć skrypt do wysyłania wywołań w formacie MP