Weryfikowanie działań – Measurement Protocol

Z tego dokumentu dowiesz się, jak weryfikować działania zgodne z protokołem pomiarowym Google Analytics.

Przegląd

Google Analytics Measurement Protocol nie zwraca kodów błędów HTTP, nawet jeśli działanie Measurement Protocol ma nieprawidłowy format lub brakuje w nim wymaganych parametrów. Aby mieć pewność, że działania są prawidłowo sformatowane i zawierają wszystkie wymagane parametry, możesz przetestować je na serwerze weryfikacji przed wdrożeniem w środowisku produkcyjnym.

Ten przewodnik opisuje proces wysyłania działań do serwera walidacji protokołu pomiaru oraz wyjaśnia, jak interpretować odpowiedź.

Wysyłanie działań do weryfikacji

Działania można przesyłać na serwer weryfikacji protokołu Measurement Protocol za pomocą dowolnej metody obsługiwanej obecnie przez Measurement Protocol. Jedyną różnicą jest adres URL. Aby wysyłać działania do serwera weryfikacji protokołu Measurement Protocol, użyj punktu końcowego /debug/collect zamiast /collect. Ten przykład pokazuje nieprawidłowe działanie wysłane na serwer weryfikacji protokołu Measurement Protocol:

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

Więcej informacji o tworzeniu działania Measurement Protocol znajdziesz w dokumentacji protokołu.

Interpretacja odpowiedzi

Odpowiedzi z serwera Measurement Protocol weryfikacji są w formacie JSON. Poniższy przykład pokazuje odpowiedź na działanie widoczne powyżej:

{
  "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"
        }
      ]
    }
  ]
}

Poziom główny odpowiedzi (hitParsingResult) to tablica, której długość odpowiada liczbie działań wysłanych w pierwotnym żądaniu. Każdy obiekt w tablicy będzie zawierał klucze valid, hit i parserMessage. Jeśli działanie jest nieprawidłowe, parserMessage będzie zawierać tablicę obiektów z opisem problemów ze sprawdzaniem poprawności. Jeśli działanie jest prawidłowe, parserMessage będzie pustą tablicą.

W tej tabeli opisano właściwości każdego elementu w tablicy hitParsingResult:

Klucz Typ Opis
valid Boolean true – prawidłowe działania, false – nieprawidłowe działania.
hit string Ciąg tekstowy zawierający ścieżkę żądania oraz jego metodę i protokół.
parserMessage Array Lista wiadomości parsera. Jeśli działanie jest prawidłowe, ta tablica będzie pusta.
parserMessage.messageType string Możliwe wartości to „INFO”, „WARN” i „ERROR”.
parserMessage.description string Dodatkowe informacje lub kroki umożliwiające rozwiązanie problemu ze sprawdzaniem poprawności.
parserMessage.parameter string|undefined Parametr (jeśli dotyczy) powodujący problem z weryfikacją.