Ereignisse validieren

Wählen Sie Ihre Plattform aus:

Firebase gtag.js

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 bestätigen, um sicherzugehen, dass Sie die richtigen Schlüssel verwenden.

Achtung :Der Validierungsserver validiert nicht die api_secret- oder Prüfen Sie diese Werte sorgfältig, um sicherzugehen, dass sie korrekt sind.

Sie können den Validierungsserver entweder direkt aufrufen oder den Google Analytics Event Builder verwenden. Mit dem Google Analytics Event Builder können Sie Ereignisse interaktiv erstellen und sie mithilfe des Measurement Protocol-Validierungsservers validieren.

In diesem Leitfaden wird beschrieben, wie Sie Ereignisse an den Measurement Protocol-Validierungsserver für Google Analytics 4 senden und die Antwort interpretieren.

Wichtig :Ereignisse, die an den Validierungsserver gesendet werden, werden nicht in Berichten angezeigt.

Ereignisse zur Validierung senden

Der einzige Unterschied zwischen der Anfrage für Ereignisse, die an das Measurement Protocol gesendet werden, und der Anfrage für Ereignisse, die an 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.

Wir empfehlen die folgende Vorgehensweise für die Validierung:

• Verwenden Sie während der Entwicklung strenge Validierungsprüfungen mit einer der folgenden Optionen:
  • Anfragen mit dem Event Builder validieren
  • Senden Sie Anfragen an den Validierungsserver, wobei validation_behavior auf ENFORCE_RECOMMENDATIONS gesetzt ist.
• Senden Sie in der Produktion Anfragen ohne validation_behavior, um die vom Measurement Protocol abgelehnten Daten zu minimieren.

Im folgenden Code wird ein ungültiges Ereignis an den Measurement Protocol-Validierungsserver gesendet:

Tipp :Wenn Ihre Daten in der EU erhoben werden sollen, ändern Sie die URL, die an die fetch-Methode übergeben wird, sodass sie mit https://region1.google-analytics.com anstelle von https://www.google-analytics.com beginnt.

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 sehen Sie 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
VALUE_REQUIRED	Ein erforderlicher Wert für ein fieldPath wurde nicht angegeben.
NAME_INVALID	Der angegebene Name ist ungültig. Weitere Informationen
NAME_RESERVED	Der angegebene Name war einer der reservierten Namen. Reservierte Namen
VALUE_OUT_OF_BOUNDS	Der angegebene Wert war zu groß. Weitere Informationen
EXCEEDED_MAX_ENTITIES	Die Anfrage enthielt zu viele Parameter. Weitere Informationen
NAME_DUPLICATED	Derselbe Name wurde in der Anfrage mehrmals angegeben.