Treffer validieren – Measurement Protocol

In diesem Dokument wird beschrieben, wie Google Analytics Measurement Protocol-Treffer validiert werden.

Überblick

Das Google Analytics Measurement Protocol gibt auch dann keine HTTP-Fehlercodes zurück, wenn ein Measurement Protocol-Treffer fehlerhaft ist oder erforderliche Parameter fehlt. Damit die Treffer richtig formatiert sind und alle erforderlichen Parameter enthalten, können Sie sie vor der Bereitstellung für die Produktion mit dem Validierungsserver testen.

In diesem Leitfaden wird beschrieben, wie Treffer an den Measurement Protocol Validation Server gesendet werden. Außerdem wird erläutert, wie die Antwort interpretiert wird.

Dieser Validierungsserver wird vom Measurement Protocol Hit Builder verwendet, mit dem Sie Measurement Protocol-Treffer interaktiv erstellen und validieren können.

Treffer zur Validierung senden

Treffer können über jede Methode an den Measurement Protocol Validation Server gesendet werden, die derzeit vom Measurement Protocol unterstützt wird. Der einzige Unterschied ist die URL. Verwenden Sie zum Senden von Treffern an den Measurement Protocol Validation Server den Endpunkt /debug/collect anstelle von /collect. Das folgende Beispiel zeigt einen ungültigen Treffer, der an den Measurement Protocol Validation Server gesendet wurde:

https://www.google-analytics.com/debug/collect?tid=fake&v=1

Weitere Informationen zum Erstellen von Measurement Protocol-Treffern finden Sie in der Protokollreferenz.

Wichtig:An den Measurement Protocol-Validierungsserver gesendete Treffer werden nicht in Berichten aufgeführt. Sie dienen nur der Fehlerbehebung.

Antwort interpretieren

Antworten des Measurement Protocol Validation Server liegen im JSON-Format vor. Das folgende Beispiel zeigt die Antwort für den oben gezeigten Treffer:

{
  "hitParsingResult": [
    {
      "valid": false,
      "hit": "GET /debug/collect?tid=fake\u0026v=1 HTTP/1.1",
      "parserMessage": [
        {
          "messageType": "ERROR",
          "description": "The value provided for parameter 'tid' is invalid. Please see http://goo.gl/a8d4RP#tid for details.",
          "parameter": "tid"
        },
        {
          "messageType": "ERROR",
          "description": "Tracking Id is a required field for this hit. Please see http://goo.gl/a8d4RP#tid for details.",
          "parameter": "tid"
        }
      ]
    }
  ]
}

Der Antwortstamm hitParsingResult ist ein Array, dessen Länge der Anzahl der Treffer entspricht, die in der ursprünglichen Anfrage gesendet wurden. Jedes Objekt im Array enthält die Schlüssel valid, hit und parserMessage. Wenn ein Treffer ungültig ist, enthält parserMessage ein Array von Objekten, die die Validierungsprobleme beschreiben. Wenn ein Treffer gültig ist, ist parserMessage ein leeres Array.

In der folgenden Tabelle werden die Attribute der einzelnen Elemente im hitParsingResult-Array beschrieben:

Schlüssel	Typ	Beschreibung
valid	Boolean	true für gültige Treffer und false für ungültige Treffer.
hit	string	Ein String, der den Pfad der Anfrage sowie die Methode und das Protokoll enthält.
parserMessage	Array	Eine Liste von Parsernachrichten. Wenn der Treffer gültig ist, ist dieses Array leer.
parserMessage.messageType	string	Mögliche Werte sind "INFO", "WARN" und "ERROR".
parserMessage.description	string	Zusätzliche Details oder Schritte zur Behebung des Überprüfungsproblems.
parserMessage.parameter	string|undefined	Der Parameter (falls zutreffend), der das Validierungsproblem verursacht.