Ereignisse validieren

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.