Wybierz platformę:
Google Analytics Measurement Protocol nie zwraca kodów błędów HTTP
, nawet wtedy, gdy zdarzenie jest zniekształcone lub brakuje w nim wymaganych parametrów. Aby się upewnić, że zdarzenia są prawidłowe, przed wdrożeniem ich w wersji produkcyjnej przetestuj je za pomocą serwera weryfikacyjnego Measurement Protocol. Gdy upewnisz się, że zdarzenia są prawidłowo sformatowane, sprawdź implementację, aby upewnić się, że używasz prawidłowych kluczy.
Możesz wywołać serwer walidacji bezpośrednio lub użyć Kreatora zdarzeń Google Analytics. Kreator zdarzeń Google Analytics umożliwia interaktywne tworzenie zdarzeń i ich sprawdzanie za pomocą serwera walidacji Measurement Protocol.
Z tego przewodnika dowiesz się, jak wysyłać zdarzenia do serwera weryfikacji Measurement Protocol dla Google Analytics 4 i jak interpretować odpowiedź.
Wysyłanie zdarzeń do weryfikacji
Jedyną różnicą w żądaniu zdarzeń wysyłanych do Measurement Protocol i na serwer weryfikacyjny Measurement Protocol jest adres URL.
Serwer | URL |
---|---|
Measurement Protocol | /mp/collect |
Serwer weryfikacyjny Measurement Protocol | /debug/mp/collect |
Pozostałe pola żądania są takie same. Szczegółowe informacje o składaniu prawidłowego żądania znajdziesz w dokumentacji protokołu.
Poniższy kod pokazuje nieprawidłowe zdarzenie wysyłane na serwer 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 weryfikującego na żądanie bez problemów z weryfikacją:
{
"validationMessages": []
}
Odpowiedź
Klucz | Typ | Opis |
---|---|---|
validationMessages | Tablica<ValidationMessage> | Tablica komunikatów weryfikacyjnych. |
ValidationMessage
Klucz | Typ | Opis |
---|---|---|
fieldPath | ciąg znaków | Ścieżka do pola, które było nieprawidłowe. |
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 atrybutu fieldPath . |
NAME_INVALID | Podana nazwa jest nieprawidłowa. Zobacz ograniczenia. |
NAME_RESERVED | Podana nazwa była nazwą zarezerwowaną. Zapoznaj się z zarezerwowanymi nazwami. |
VALUE_OUT_OF_BOUNDS | Podana wartość jest 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. |