Weryfikowanie zdarzeń

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.