Rozwiązywanie problemów

W tym przewodniku znajdziesz najczęstsze rozwiązania typowych błędów implementacji.

Brak wydarzeń

Jeśli Twoje zdarzenia nie są widoczne w Google Analytics, sprawdź, czy nie występują te typowe problemy.

Najpierw wybierz klienta:

• Czy używasz prawidłowego parametru api_secret?

  Sprawdź, czy używasz parametru api_secret dla właściwego strumienia. Jeśli skonfigurujesz Measurement Protocol dla kilku strumieni, każdy z nich będzie miał własny klucz tajny.

• Czy Twój parametr api_secret jest nadal ważny?

  Aby pomóc w walce ze spamem, możesz unieważnić parametry api_secret. Upewnij się, że używany przez Ciebie parametr api_secret jest nadal ważny. Możliwe, że inny użytkownik mający dostęp do Twojego strumienia przypadkowo cofnął do niego dostęp.

• Czy Twój parametr api_secret został poprawnie skopiowany?

  Parametr api_secret rozróżnia wielkość liter. Dokładnie sprawdź, czy parametr api_secret w interfejsie Google Analytics jest dokładnie taki sam jak ten, którego używasz w kodzie.

• Nie używaj parametru advertising_id.

  Parametr advertising_id nie jest obsługiwany jako prawidłowy identyfikator urządzenia. Jeśli używasz Firebase, użyj parametru app_instance_id, a jeśli używasz tagu gtag.js, użyj parametru client_id.

• Czy używasz prawidłowego parametru firebase_app_id?

  Upewnij się, że używasz identyfikatora aplikacji w Firebase. Tę wartość znajdziesz w konsoli Firebase w sekcji Ustawienia projektu > Ogólne > Twoje aplikacje > Identyfikator aplikacji.

  Parametr firebase_app_id różni się od parametru app_instance_id.

• Czy używasz prawidłowego parametru app_instance_id?

  Upewnij się, że używasz identyfikatora, który jest specyficzny dla instalacji aplikacji w Firebase. Tę wartość należy pobrać za pomocą pakietu SDK Google Analytics dla Firebase.

  • Android – getAppInstanceId()
  • Kotlin – getAppInstanceId()
  • Swift – appInstanceID()
  • Objective-C – appInstanceID
  • C++ – GetAnalyticsInstanceId()
  • Unity – GetAnalyticsInstanceIdAsync()

  Parametr app_instance_id różni się od parametru firebase_app_id.

Nieprawidłowe identyfikatory

Measurement Protocol obsługuje identyfikatory z pakietu SDK Google Analytics dla Firebase i tagu gtag.js, więc upewnij się, że używasz właściwego identyfikatora. Identyfikatory, których należy używać, zależą od tego, czy używasz pakietu SDK Google Analytics dla Firebase czy tagu gtag.js. Poniżej znajdziesz informacje o tym, jakich identyfikatorów należy używać:

Pakiet SDK Google Analytics dla Firebase

Jeśli używasz pakietu SDK Google Analytics dla Firebase, powinieneś używać tych identyfikatorów:

• firebase_app_id – dodaj ten identyfikator do parametrów zapytania w żądaniu. Ten identyfikator jednoznacznie identyfikuje Twoją aplikację Firebase. Wszyscy użytkownicy Twojej aplikacji będą mieli ten sam parametr firebase_app_id. Znajdziesz go w konsoli Firebase w sekcji:
  Ustawienia projektu > Ogólne > Twoje aplikacje > Identyfikator aplikacji

• app_instance_id – dodaj ten identyfikator do treści POST w żądaniu. Ten identyfikator jednoznacznie identyfikuje daną instalację aplikacji Firebase. Ta wartość będzie inna dla każdej instalacji Twojej aplikacji. Metody pobierania tej wartości na poszczególnych platformach Firebase są następujące:

  • Android – getAppInstanceId()
  • Kotlin – getAppInstanceId()
  • Swift – appInstanceID()
  • Objective-C – appInstanceID
  • C++ – GetAnalyticsInstanceId()
  • Unity – GetAnalyticsInstanceIdAsync()

Nie należy używać tych identyfikatorów:

• firebase_instance_id – tego identyfikatora nie należy uwzględniać w żądaniu. Ten identyfikator służy do identyfikowania danej instancji aplikacji, ale jest specyficzny dla Firebase. Jest używany do zadań takich jak wiadomości FCM.

gtag.js

Jeśli używasz tagu gtag.js, powinieneś używać tych identyfikatorów:

• measurement_id – dodaj ten identyfikator do parametrów zapytania w żądaniu. Ten identyfikator jednoznacznie identyfikuje strumień danych. Wszyscy użytkownicy Twojej witryny będą mieli ten sam parametr measurement_id. Znajdziesz go w interfejsie Google Analytics w sekcji:
  Administracja > Strumienie danych > wybierz swój strumień > Identyfikator pomiaru
• client_id – dodaj ten identyfikator do treści POST w żądaniu. Ten identyfikator jednoznacznie identyfikuje daną instancję użytkownika klienta internetowego. Ta wartość będzie inna dla każdego użytkownika Twojej aplikacji. Przykłady pobierania tej wartości znajdziesz tutaj.

Brak zdarzeń tagowania po stronie serwera

Instalacja Menedżera tagów po stronie serwera z klientem Measurement Protocol umożliwia wysyłanie zdarzeń w formacie Measurement Protocol do kontenera. Kontener wysyła te zdarzenia do Google Analytics za pomocą tego samego mechanizmu co wszystkie inne zdarzenia SGTM.

Jeśli chcesz korzystać ze wszystkich funkcji Measurement Protocol, wysyłaj zdarzenia bezpośrednio do Measurement Protocol, a nie do kontenera.