Weryfikowanie zdarzeń

Wybierz platformę:

Protokół Google Analytics Measurement Protocol do Google Analytics 4 nie zwraca kodów błędów HTTP, nawet jeśli zdarzenie ma nieprawidłowy format lub brakuje w nim wymaganych parametrów. Aby mieć pewność, że zdarzenia są prawidłowe, przetestuj je przed wdrożeniem w środowisku produkcyjnym za pomocą serwera weryfikacji platformy Measurement Protocol. Po potwierdzeniu, że zdarzenia mają prawidłową strukturę, zweryfikuj implementację, aby mieć pewność, że używasz prawidłowych kluczy.

Możesz bezpośrednio wywołać serwer weryfikacji lub użyć Kreatora zdarzeń GA4. Kreator zdarzeń GA4 umożliwia interaktywne tworzenie zdarzeń i korzysta z serwera weryfikacji protokołu Measurement Protocol.

Z tego przewodnika dowiesz się, jak wysyłać zdarzenia do platformy Measurement Protocol na potrzeby serwera weryfikacji Google Analytics 4 i interpretować odpowiedź.

Wysyłanie zdarzeń do weryfikacji

Jedyną różnicą w żądaniu zdarzeń wysyłanych do Measurement Protocol i serwera Measurement Protocol Weryfikacja jest adres URL.

Serwer URL
Measurement Protocol /mp/collect
Serwer walidacji platformy Measurement Protocol /debug/mp/collect

Wszystkie pozostałe pola żądania są takie same. Szczegółowe informacje o tworzeniu prawidłowego żądania znajdziesz w dokumentacji protokołu.

Ten kod pokazuje nieprawidłowe zdarzenie wysyłane do serwera weryfikacji Measurement Protocol:

Odpowiedź na weryfikację

Oto odpowiedź serwera weryfikacji 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"
    }
  ]
}

Odpowiedź

Klucz Typ Opis
validationMessages Array<ValidationMessage> Tablica komunikatów weryfikacji.

ValidationMessage

Klucz Typ Opis
fieldPath string, Ścieżka do pola, które było nieprawidłowe.
description string, Opis błędu.
validationCode ValidationCode WalidationCode, który odpowiada błądowi.

ValidationCode

Wartość Opis
VALUE_INVALID Podana wartość fieldPath jest nieprawidłowa. Zobacz ograniczenia.
VALUE_REQUIRED Nie podano wymaganej wartości dla pola fieldPath.
NAME_INVALID Podana nazwa jest nieprawidłowa. Zobacz ograniczenia.
NAME_RESERVED Podana nazwa jest jedną z zarezerwowanych. Zobacz nazwy zarezerwowane.
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 prośbie więcej niż raz podano tę samą nazwę.