Ereignisse validieren

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:

const measurement_id = `G-XXXXXXXXXX`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/debug/mp/collect?measurement_id=${measurement_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    client_id: 'XXXXXXXXXX.YYYYYYYYYY',
    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 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.