Wybierz platformę:
Protokół pomiarowy Google Analytics nie zwraca kodów błędów, nawet jeśli zdarzenie jest zniekształcone lub brakuje w nim wymaganych parametrów.HTTP
Aby się upewnić, że zdarzenie jest prawidłowe, przetestuj je za pomocą serwera weryfikacyjnego Measurement Protocol, zanim je wdrożysz w środowisku produkcyjnym.
Po sprawdzeniu, czy zdarzenia są prawidłowo skonstruowane, zweryfikuj implementację, aby upewnić się, że używasz prawidłowych kluczy.
Możesz wywołać serwer weryfikacji bezpośrednio lub użyć kreatora zdarzeń Google Analytics. Kreator zdarzeń Google Analytics umożliwia interaktywne tworzenie zdarzeń i korzysta z serwera weryfikacji platformy Measurement Protocol do ich weryfikowania.
Z tego przewodnika dowiesz się, jak wysyłać zdarzenia do serwera weryfikacji Measurement Protocol w Google Analytics 4 i interpretować odpowiedź.
Wysyłanie zdarzeń do weryfikacji
Jedyna różnica między żądaniem zdarzeń wysyłanych do Measurement Protocol a żądaniem wysyłanym do serwera weryfikacyjnego Measurement Protocol to adres URL.
Serwer | URL |
---|---|
Measurement Protocol | /mp/collect |
Serwer weryfikacyjny Measurement Protocol | /debug/mp/collect |
Wszystkie pozostałe pola żądania są takie same. Pełne informacje o tworzeniu prawidłowego żądania znajdziesz w dokumentacji protokołu.
Poniższy kod pokazuje, jak wysłać nieprawidłowe zdarzenie do serwera weryfikacji Measurement Protocol:
Odpowiedź na weryfikację
Oto odpowiedź serwera weryfikacyjnego na poprzednie zdarzenie:
{
"validationMessages": [
{
"fieldPath": "events",
"description": "Event at index: [0] has invalid name [_badEventName]. Names must start with an alphabetic character.",
"validationCode": "NAME_INVALID"
}
]
}
Oto odpowiedź serwera weryfikacyjnego na żądanie, w którym nie wykryto problemów z weryfikacją:
{
"validationMessages": []
}
Odpowiedź
Klucz | Typ | Opis |
---|---|---|
validationMessages |
Array<ValidationMessage> | Tablica komunikatów weryfikacyjnych. |
ValidationMessage
Klucz | Typ | Opis |
---|---|---|
fieldPath |
ciąg znaków | Ścieżka do nieprawidłowego pola. |
description |
ciąg znaków | Opis błędu. |
validationCode |
ValidationCode | Kod weryfikacyjny odpowiadający błędowi. |
ValidationCode
Wartość | Opis |
---|---|
VALUE_INVALID |
Podana wartość parametru fieldPath jest nieprawidłowa. Zobacz ograniczenia.
|
VALUE_REQUIRED |
Nie podano wymaganej wartości dla fieldPath . |
NAME_INVALID |
Podana nazwa jest nieprawidłowa. Zobacz ograniczenia. |
NAME_RESERVED |
Podana nazwa była jedną z nazw zarezerwowanych. Zobacz zarezerwowane nazwy. |
VALUE_OUT_OF_BOUNDS |
Podana wartość była za duża. Zobacz ograniczenia. |
EXCEEDED_MAX_ENTITIES |
Żądanie zawierało zbyt wiele parametrów. Zobacz ograniczenia. |
NAME_DUPLICATED |
W żądaniu podano tę samą nazwę więcej niż raz. |