Weryfikowanie zdarzeń

Wybierz platformę:

Google Analytics Measurement Protocol nie zwraca HTTP kodów błędów, nawet jeśli zdarzenie jest zniekształcone lub brakuje w nim wymaganych parametrów. Aby się upewnić, że zdarzenia są prawidłowe, przetestuj je za pomocą serwera walidacji Measurement Protocol, zanim je wdrożysz w środowisku produkcyjnym. Po sprawdzeniu, czy zdarzenia mają prawidłową strukturę, zweryfikuj implementację, aby upewnić się, że używasz prawidłowych kluczy.

Możesz wywołać serwer walidacji bezpośrednio lub użyć narzędzia Event Builder Google Analytics. Kreator zdarzeń Google Analytics umożliwia interaktywne tworzenie zdarzeń i korzysta z serwera weryfikacji Measurement Protocol do ich sprawdzania.

Z tego przewodnika dowiesz się, jak wysyłać zdarzenia do serwera walidacji Measurement Protocol w Google Analytics i interpretować odpowiedź.

Wysyłanie zdarzeń do weryfikacji

Jedyna różnica w żądaniu zdarzeń wysyłanych do Measurement Protocol i serwera weryfikacji Measurement Protocol to adres URL.

Wszystkie pozostałe pola żądania są takie same.

Zalecamy następujące podejście do weryfikacji:

• Podczas tworzenia aplikacji używaj ścisłych weryfikacji, korzystając z jednej z tych opcji:
  • Weryfikuj żądania za pomocą narzędzia do tworzenia zdarzeń.
  • Wysyłaj żądania do serwera weryfikacji z parametrem validation_behavior ustawionym na ENFORCE_RECOMMENDATIONS.
• W środowisku produkcyjnym wysyłaj żądania bez parametru validation_behavior, aby zminimalizować ilość danych odrzucanych przez Measurement Protocol.

Przykład nieprawidłowego zdarzenia

Poniższy kod pokazuje, jak wysłać nieprawidłowe zdarzenie do serwera weryfikacji Measurement Protocol:

const firebaseAppId = "FIREBASE_APP_ID";
const apiSecret = "API_SECRET";

fetch(`https://www.google-analytics.com/debug/mp/collect?firebase_app_id=${firebaseAppId}&api_secret=${apiSecret}`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    app_instance_id: "APP_INSTANCE_ID",
    validation_behavior: "ENFORCE_RECOMMENDATIONS",
    events: [{
      // Event names must start with an alphabetic character.
      name: "_badEventName",
      params: {},
    }]
  })
});

Przykład prawidłowego zdarzenia

Poniższy kod pokazuje prawidłowe zdarzenie wysyłane do serwera weryfikacji Measurement Protocol. To żądanie spowoduje zwrócenie w odpowiedzi pustej tablicy validationMessages, jak pokazano w sekcji Odpowiedź weryfikacyjna.

const firebaseAppId = "FIREBASE_APP_ID";
const apiSecret = "API_SECRET";

fetch(`https://www.google-analytics.com/debug/mp/collect?firebase_app_id=${firebaseAppId}&api_secret=${apiSecret}`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    app_instance_id: "APP_INSTANCE_ID",
    validation_behavior: "ENFORCE_RECOMMENDATIONS",
    events: [{
      name: "level_up",
      params: {
        level: 2,
        character: "MyHero"
      },
    }]
  })
});

Odpowiedź weryfikacyjna

Oto odpowiedź serwera walidacji na przykład nieprawidłowego zdarzenia.

{
  "validationMessages": [
    {
      "fieldPath": "events",
      "description": "Event at index: [0] has invalid name [_badEventName]. Names must start with an alphabetic character.",
      "validationCode": "NAME_INVALID"
    }
  ]
}

Oto odpowiedź serwera walidacji na żądanie bez problemów z weryfikacją:

{
  "validationMessages": []
}

Odpowiedź

ValidationMessage

ValidationCode