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:
const firebase_app_id = `X:XX:XX:XX`;
const api_secret = `<secret_value>`;
fetch(`https://www.google-analytics.com/debug/mp/collect?firebase_app_id=${firebase_app_id}&api_secret=${api_secret}`, {
method: "POST",
body: JSON.stringify({
app_instance_id: 'app_instance_id',
events: [{
// Event names must start with an alphabetic character.
name: '_badEventName',
params: {},
}]
})
});
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ę. |