Ereignisse validieren

Plattform auswählen:

<ph type="x-smartling-placeholder"></ph>

Das Measurement Protocol von Google Analytics wird nicht HTTP-Fehlercodes, auch wenn ein Termin fehlerhaft ist oder erforderlich ist Parameter. Um sicherzustellen, dass Ihre Ereignisse gültig sind, sollten Sie sie anhand der Measurement Protocol Validation Server vor der Bereitstellung für die Produktion. Nachdem Sie geprüft haben, ob Ihre Ereignisse richtig strukturiert sind, sollten Sie Folgendes tun: Implementierung überprüfen, um sicherzustellen, dass Sie die richtigen Schlüssel verwenden

Sie können den Validierungsserver direkt aufrufen oder die Google Analytics- Event Builder Mit dem Google Analytics Event Builder Ereignisse erstellt und mithilfe des Measurement Protocol Validation Server um sie zu validieren.

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

Ereignisse zur Überprüfung senden

Der einzige Unterschied bei der Anfrage für Ereignisse, die an das Measurement Protocol gesendet werden und der Measurement Protocol Validation Server die URL ist.

Server URL
Measurement Protocol /mp/collect
Measurement Protocol-Validierungsserver /debug/mp/collect

Alle anderen Anfragefelder sind identisch. Vollständige Informationen finden Sie in der Protokollreferenz. wie Sie eine gültige Anfrage erstellen.

Der folgende Code zeigt, wie ein ungültiges Ereignis an das Measurement Protocol gesendet wird. Validierungsserver:

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 war einer der reservierten Namen. Siehe Reserviert 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 In der Anfrage wurde mehrmals derselbe Name angegeben.