Plattform auswählen:
Das Google Analytics Measurement Protocol für Google Analytics 4 gibt keine HTTP
-Fehlercodes zurück, selbst wenn ein Ereignis fehlerhaft ist oder erforderliche Parameter fehlen. Damit Ihre Ereignisse gültig sind, sollten Sie sie vor der Bereitstellung in der Produktion mit dem Measurement Protocol Validation Server testen.
Nachdem Sie überprüft haben, ob Ihre Ereignisse richtig strukturiert sind, sollten Sie Ihre Implementierung überprüfen, um sicherzustellen, dass Sie die richtigen Schlüssel verwenden.
Sie können den Validierungsserver entweder direkt aufrufen oder den GA4 Event Builder verwenden. Mit dem GA4 Event Builder können Sie Ereignisse interaktiv erstellen und den Measurement Protocol Validation Server verwenden, um sie zu validieren.
In diesem Leitfaden wird beschrieben, wie Sie Ereignisse an das Measurement Protocol für den Google Analytics 4-Validierungsserver senden und die Antwort interpretieren.
Ereignisse zur Überprüfung senden
Der einzige Unterschied bei der Anfrage für Ereignisse, die an das Measurement Protocol und den Measurement Protocol-Validierungsserver gesendet werden, ist die URL.
Server | URL |
---|---|
Measurement Protocol | /mp/collect |
Measurement Protocol-Validierungsserver | /debug/mp/collect |
Alle anderen Anfragefelder sind identisch. Ausführliche Informationen zum Erstellen einer gültigen Anfrage finden Sie in der Protokollreferenz.
Der folgende Code zeigt ein ungültiges Ereignis, das an den Measurement Protocol-Validierungsserver gesendet wird:
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 ist einer der reservierten Namen. Siehe Reservierte 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 |
Derselbe Name wurde in der Anfrage mehrmals angegeben. |