Wählen Sie Ihre Plattform aus:
Das Google Analytics Measurement Protocol gibt keine HTTP
-Fehlercodes zurück, selbst wenn ein Ereignis falsch formatiert ist oder erforderliche Parameter fehlen. Damit Ihre Ereignisse auf jeden Fall gültig sind, sollten Sie sie mit dem Measurement Protocol-Validierungsserver testen, bevor Sie sie in die Produktion übernehmen.
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 Google Analytics-Ereignis-Builder verwenden. Mit dem Google Analytics-Ereignis-Builder können Sie Ereignisse interaktiv erstellen und mit dem Measurement Protocol-Validierungsserver validieren.
In diesem Leitfaden wird beschrieben, wie Sie Ereignisse an den Measurement Protocol-Server für den Google Analytics 4-Validierungsserver senden und die Antwort interpretieren.
Ereignisse zur Validierung senden
Der einzige Unterschied zwischen 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 gleich. Ausführliche Informationen zum Erstellen einer gültigen Anfrage finden Sie in der Referenz zum Protokoll.
Im folgenden Code wird ein ungültiges Ereignis dargestellt, das an den Measurement Protocol-Bestätigungsserver 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"
}
]
}
Hier ist die Antwort des Validierungsservers auf eine Anfrage ohne Validierungsprobleme:
{
"validationMessages": []
}
Antwort
Schlüssel | Typ | Beschreibung |
---|---|---|
validationMessages |
Array<ValidationMessage> | Ein Array von Validierungsmeldungen. |
ValidationMessage
Schlüssel | Typ | Beschreibung |
---|---|---|
fieldPath |
String | Der Pfad zum ungültigen Feld. |
description |
String | Eine Beschreibung des Fehlers. |
validationCode |
ValidationCode | Ein Validierungscode, der dem Fehler entspricht. |
ValidationCode
Wert | Beschreibung |
---|---|
VALUE_INVALID |
Der für fieldPath angegebene Wert ist ungültig. Weitere Informationen finden Sie unter Einschränkungen.
|
VALUE_REQUIRED |
Für ein fieldPath wurde kein erforderlicher Wert angegeben. |
NAME_INVALID |
Der angegebene Name ist ungültig. Weitere Informationen finden Sie unter Einschränkungen. |
NAME_RESERVED |
Der angegebene Name ist einer der reservierten Namen. Weitere Informationen finden Sie unter Reservierte Namen. |
VALUE_OUT_OF_BOUNDS |
Der angegebene Wert war zu groß. Weitere Informationen finden Sie unter Einschränkungen. |
EXCEEDED_MAX_ENTITIES |
Die Anfrage enthielt zu viele Parameter. Weitere Informationen finden Sie unter Einschränkungen. |
NAME_DUPLICATED |
In der Anfrage wurde derselbe Name mehrmals angegeben. |