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.

SerwerURL
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ź

KluczTypOpis
validationMessagesTablica<ValidationMessage>Tablica komunikatów weryfikacyjnych.

ValidationMessage

KluczTypOpis
fieldPathciąg znakówŚcieżka do pola, które było nieprawidłowe.
descriptionciąg znakówOpis błędu.
validationCodeValidationCodeKod weryfikacyjny odpowiadający błędowi.

ValidationCode

WartośćOpis
VALUE_INVALIDPodana wartość parametru fieldPath jest nieprawidłowa. Zobacz ograniczenia.
VALUE_REQUIREDNie podano wymaganej wartości dla atrybutu fieldPath.
NAME_INVALIDPodana nazwa jest nieprawidłowa. Zobacz ograniczenia.
NAME_RESERVEDPodana nazwa była nazwą zarezerwowaną. Zapoznaj się z zarezerwowanymi nazwami.
VALUE_OUT_OF_BOUNDSPodana wartość jest za duża. Zobacz ograniczenia.
EXCEEDED_MAX_ENTITIESŻądanie zawierało zbyt wiele parametrów. Zobacz ograniczenia.
NAME_DUPLICATEDW żądaniu podano tę samą nazwę więcej niż raz.