Wysyłanie identyfikatorów użytkowników

Identyfikatory użytkowników to Twoje własne unikalne identyfikatory, które przypisujesz poszczególnym użytkownikom. Z tego przewodnika dowiesz się, jak wysyłać identyfikatory użytkowników do Google Analytics, aby łączyć zachowania użytkowników w ramach różnych sesji, urządzeń i platform.

Więcej informacji o funkcji User-ID znajdziesz w artykule Pomiar aktywności na różnych platformach. Aby dowiedzieć się, jak skonfigurować identyfikator użytkownika w aplikacji, przeczytaj artykuł Konfigurowanie identyfikatora użytkownika.

Ostrzeżenie: nie ustawiaj wymiarów niestandardowych na podstawie identyfikatorów użytkowników. Ustawianie wymiarów niestandardowych na podstawie identyfikatorów użytkowników prowadzi do uzyskania wymiarów ze zbyt dużą liczbą unikalnych wartości. Zbyt wiele unikalnych wartości powoduje problemy z danymi Google Analytics i dokładnością raportów. Więcej informacji o sprawdzonych metodach konfigurowania niestandardowych wymiarów

Parametr user_id jest parametrem konfiguracji, a nie niestandardową właściwością użytkownika ani standardowym parametrem zdarzenia. Zamiast tego parametr user_id jest zarezerwowanym parametrem systemowym, który służy do identyfikowania uwierzytelnionych użytkowników na różnych urządzeniach i w różnych sesjach. Nie ustawiaj go jako niestandardowej właściwości użytkownika (np. w user_propertiesobiekcie dla gtag.js lub w sekcji Właściwości użytkownika tagów Menedżera tagów Google) ani nie rejestruj go jako wymiaru niestandardowego w interfejsie Analytics. Nie przekazuj go też jako parametru na poziomie zdarzenia w przypadku poszczególnych zdarzeń. Zamiast tego ustaw user_id tylko jako parametr konfiguracji, korzystając z tych metod.

gtag.js Menedżer tagów

Zanim zaczniesz

Zanim zaczniesz wysyłać identyfikatory użytkowników, wykonaj te czynności:

• Utwórz konto i usługę w Google Analytics.
• Utwórz na potrzeby witryny strumień danych z sieci.
• Umieść tag Google w swojej witrynie.
• mieć dostęp do kodu źródłowego swojej witryny;
• mieć na koncie Google Analytics rolę Edytujący (lub o większych uprawnieniach);

Wysyłanie identyfikatorów użytkowników

Wartość, którą przesyłasz w przypadku parametru user_id, zależy od stanu użytkownika:

• Użytkownik nigdy się nie zalogował: nie wysyłaj parametru user_id.
• Użytkownik jest zalogowany: wyślij jego identyfikator.
• Użytkownik zalogował się, a potem wylogował: wyślij null.

Aby wysyłać identyfikator użytkownika do Analytics, dodaj parametr user_id do polecenia config na każdej stronie witryny:

if (/* your logic for determining if the user is signed in */) {
  gtag('config', 'TAG_ID', {
    'user_id': 'USER_ID'
  });
} else if (/* your logic for determining if the user signed out */) {
  gtag('config', 'TAG_ID', {
    'user_id': null
  });
} else {
  // Do nothing if the user never signed in.
}

1. Zastąp TAG_ID swoim identyfikatorem tagu.
2. Zastąp komentarze sprawdzeniem, czy użytkownik jest zalogowany, i czy był zalogowany, ale potem się wylogował.
3. Jeśli użytkownik jest zalogowany, zastąp symbol USER_ID jego identyfikatorem.
4. Gdy użytkownik się wyloguje, ustaw wartość user_id na null. Nie wysyłaj pustego ciągu znaków (""), ciągu znaków zawierającego tylko spacje (" ") ani słów "null" lub "NULL" w cudzysłowie.

Ustawianie identyfikatora użytkownika po inicjalizacji

W wielu przypadkach wartość user_id nie jest znana, gdy tag Google jest inicjowany po raz pierwszy. Użytkownik może na przykład odwiedzić Twoją witrynę, a dopiero później się w niej zalogować.

Aby ustawić lub zaktualizować parametr user_id po początkowym wczytaniu strony, użyj polecenia gtag('set'). To polecenie ustawia user_id dla wszystkich kolejnych zdarzeń na stronie i jest zalecanym rozwiązaniem zamiast gtag('config') w tym scenariuszu.

Ustawianie identyfikatora użytkownika podczas logowania

Gdy użytkownik zaloguje się, wywołaj funkcję gtag('set'), aby powiązać jego identyfikator z przyszłymi zdarzeniami:

// Example function called after successful login
function handleUserLogin(userId) {
  if (userId) {
    gtag('set', {'user_id': userId});
    console.log('User ID set for GA:', userId);

    // You can also send a login event
    gtag('event', 'login', { method: 'your_login_method' });
  }
}

// Example usage:
// handleUserLogin('12345_user');

Usuwanie identyfikatora User-ID po wylogowaniu

Gdy użytkownik się wyloguje, wyczyść user_id, ustawiając jego wartość na null:

// Example function called after logout
function handleUserLogout() {
  gtag('set', {'user_id': null});
  console.log('User ID cleared for GA.');

  // You can also send a logout event
  gtag('event', 'logout');
}

// Example usage:
// handleUserLogout();

Używając gtag('set'), masz pewność, że user_id jest prawidłowo zarządzany w trakcie sesji użytkownika, odzwierciedlając jego bieżący stan logowania, nawet jeśli zmieni się on po załadowaniu strony.

Jak funkcja User-ID jest używana w Google Analytics

Gdy wyślesz do Google Analytics wartości user_id, będą one używane do:

• Ujednolicenie ścieżek użytkowników: łączenie aktywności użytkowników w ramach różnych sesji, urządzeń i platform w przypadku zalogowanych użytkowników.
• Dokładniejsze dane o liczbie użytkowników: bardziej precyzyjne dane o użytkownikach bez duplikatów.
• Włącz analizę:
  • Analizowanie aktywności na podstawie stanu zalogowania: używaj wymiarów takich jak „Zalogowano za pomocą identyfikatora użytkownika”, aby tworzyć porównania w standardowych raportach lub segmenty w eksploracjach.
  • Umożliwia korzystanie z metody eksploracji Eksplorator użytkownika, która pozwala przejść do bardziej szczegółowego widoku osi czasu aktywności poszczególnych użytkowników.

Istotne kwestie

• NIE twórz wymiarów niestandardowych dla identyfikatora użytkownika: nie rejestruj user_id jako wymiaru niestandardowego ograniczonego do użytkownika. To kluczowa najlepsza praktyka. W ten sposób tworzysz niepotrzebny wymiar o dużej mocy zbioru, co może poważnie wpłynąć na wydajność raportu, spowodować grupowanie danych w wierszu „(inne)” i wykorzystać limit wymiarów niestandardowych. Wbudowana funkcja User-ID zajmuje się łączeniem użytkowników. Więcej informacji znajdziesz w artykule Sprawdzone metody korzystania z funkcji User-ID.

• Ustaw user_id jako ustawienie konfiguracji, a nie jako właściwość użytkownika lub parametr zdarzenia: ponieważ user_id jest zarezerwowanym parametrem systemowym, musi być stosowany tylko jako parametr konfiguracji lub ustawień (za pomocą poleceń gtag() config lub set albo ustawień konfiguracji tagu Google w Menedżerze tagów Google). Nie konfiguruj go jako niestandardowej właściwości użytkownika, nie przekazuj go w user_propertiesobiekcie ustawień ani nie wysyłaj jako parametru na poziomie zdarzenia w poszczególnych zdarzeniach.

• Widoczność identyfikatorów bezpośrednich w raportach standardowych i eksploracjach: surowe wartości user_id nie są dostępne jako standardowy wymiar w raportach standardowych ani w większości eksploracji (np. w eksploracji dowolnej) ze względu na ochronę prywatności i zarządzanie mocą zbioru. Możesz jednak wyświetlić nieprzetworzone user_id w szablonie eksploracji Eksplorator użytkownika w kolumnie Efektywny identyfikator użytkownika w przypadku zalogowanych użytkowników.

• Dostęp do nieprzetworzonych identyfikatorów użytkowników: jeśli chcesz przeprowadzić analizę z użyciem nieprzetworzonych wartości user_id, zalecamy skorzystanie z BigQuery Export z Google Analytics 4. Pole user_id jest dostępne w wyeksportowanych danych.

Aby mieć pewność, że dane User-ID są używane i widoczne w sekcji Eksplorator użytkowników, sprawdź, czy tożsamość raportowania w Twojej usłudze jest ustawiona na Mieszana lub Obserwowana.