Plattform auswählen:
Das Measurement Protocol von Google Analytics wird nicht
HTTP
-Fehlercodes, auch wenn ein Termin fehlerhaft ist oder erforderlich ist
Parameter. Um sicherzustellen, dass Ihre Ereignisse gültig sind, sollten Sie sie anhand der
Measurement Protocol Validation Server vor der Bereitstellung für die Produktion.
Nachdem Sie geprüft haben, ob Ihre Ereignisse richtig strukturiert sind, sollten Sie Folgendes tun:
Implementierung überprüfen, um sicherzustellen, dass Sie die richtigen Schlüssel verwenden
Sie können den Validierungsserver direkt aufrufen oder die Google Analytics- Event Builder Mit dem Google Analytics Event Builder Ereignisse erstellt und mithilfe des Measurement Protocol Validation Server um sie zu validieren.
In diesem Leitfaden wird beschrieben, wie Ereignisse an das Measurement Protocol für Google gesendet werden Analytics 4-Validierungsserver und interpretieren Sie die Antwort.
Ereignisse zur Überprüfung senden
Der einzige Unterschied bei der Anfrage für Ereignisse, die an das Measurement Protocol gesendet werden und der Measurement Protocol Validation Server die URL ist.
Server | URL |
---|---|
Measurement Protocol | /mp/collect |
Measurement Protocol-Validierungsserver | /debug/mp/collect |
Alle anderen Anfragefelder sind identisch. Vollständige Informationen finden Sie in der Protokollreferenz. wie Sie eine gültige Anfrage erstellen.
Der folgende Code zeigt, wie ein ungültiges Ereignis an das Measurement Protocol gesendet wird. Validierungsserver:
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: {},
}]
})
});
Validierungsantwort
Hier ist die Antwort des Validierungsservers auf das vorherige Ereignis:
{
"validationMessages": [
{
"fieldPath": "events",
"description": "Event at index: [0] has invalid name [_badEventName]. Names must start with an alphabetic character.",
"validationCode": "NAME_INVALID"
}
]
}
Antwort
Schlüssel | Typ | Beschreibung |
---|---|---|
validationMessages |
Array < ValidationMessage > | Ein Array von Validierungsmeldungen. |
ValidationMessage
Schlüssel | Typ | Beschreibung |
---|---|---|
fieldPath |
String | Der Pfad zum Feld, das ungültig war. |
description |
String | Eine Beschreibung des Fehlers. |
validationCode |
ValidationCode | Ein ValidationCode, der dem Fehler entspricht. |
ValidationCode
Wert | Beschreibung |
---|---|
VALUE_INVALID |
Der für fieldPath angegebene Wert ist ungültig. Siehe Einschränkungen.
|
VALUE_REQUIRED |
Für fieldPath wurde kein erforderlicher Wert angegeben. |
NAME_INVALID |
Der angegebene Name ist ungültig. Siehe Einschränkungen. |
NAME_RESERVED |
Der angegebene Name war einer der reservierten Namen. Siehe Reserviert Namen. |
VALUE_OUT_OF_BOUNDS |
Der angegebene Wert war zu groß. Siehe Einschränkungen. |
EXCEEDED_MAX_ENTITIES |
Die Anfrage enthielt zu viele Parameter. Siehe Einschränkungen. |
NAME_DUPLICATED |
In der Anfrage wurde mehrmals derselbe Name angegeben. |