Wybierz platformę:
Measurement Protocol Google Analytics nie zwraca
HTTP
kodów błędów, nawet jeśli zdarzenie jest uszkodzone lub brakuje w nich wymaganych zmian
. Aby mieć pewność, że zdarzenia są prawidłowe, przetestuj je pod kątem
serwer walidacji platformy Measurement Protocol przed wdrożeniem ich w środowisku produkcyjnym.
Po sprawdzeniu, czy wydarzenia mają prawidłową strukturę,
sprawdź implementację, aby mieć pewność, że używasz prawidłowych kluczy.
Możesz wywołać serwer weryfikacji bezpośrednio lub użyć narzędzia Google Analytics Kreator zdarzeń. Kreator zdarzeń Google Analytics umożliwia generować zdarzenia i używać serwera walidacji platformy Measurement Protocol ich potwierdzenie.
Z tego przewodnika dowiesz się, jak wysyłać zdarzenia do platformy Measurement Protocol dla Google serwer walidacji Analytics 4 i zinterpretuj odpowiedź.
Wysyłanie zdarzeń do weryfikacji
Jedyna różnica w żądaniu dotyczącym zdarzeń wysyłanych do platformy Measurement Protocol a serwer walidacji protokołu Measurement Protocol to adres URL.
Serwer | URL |
---|---|
Measurement Protocol | /mp/collect |
Serwer walidacji protokołu Measurement Protocol | /debug/mp/collect |
Wszystkie pozostałe pola żądania są takie same. Pełne informacje znajdziesz w dokumentacji protokołu. na temat tworzenia prawidłowego żądania.
Ten kod pokazuje nieprawidłowe zdarzenie wysyłane do platformy Measurement Protocol Serwer walidacji:
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ź weryfikacji
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 |
Tablica<ValidationMessage> | Tablica komunikatów dotyczących weryfikacji. |
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 ValidationCode powiązany z błędem. |
ValidationCode
Wartość | Opis |
---|---|
VALUE_INVALID |
Wartość podana w polu fieldPath jest nieprawidłowa. Zobacz ograniczenia.
|
VALUE_REQUIRED |
Nie podano wymaganej wartości dla właściwości fieldPath . |
NAME_INVALID |
Podana nazwa jest nieprawidłowa. Zobacz ograniczenia. |
NAME_RESERVED |
Podana nazwa jest jedną z zarezerwowanych. Zobacz zarezerwowane wyświetlenia . |
VALUE_OUT_OF_BOUNDS |
Podana wartość była za duża. Zobacz ograniczenia. |
EXCEEDED_MAX_ENTITIES |
Żądanie zawiera zbyt wiele parametrów. Zobacz ograniczenia. |
NAME_DUPLICATED |
W prośbie podano więcej niż raz tę samą nazwę. |