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ć działania użytkowników w różnych sesjach, na różnych urządzeniach i platformach.

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

Ustawianie wymiarów niestandardowych na podstawie identyfikatorów użytkowników prowadzi do tworzenia wymiarów z zbyt dużą liczbą unikalnych wartości. Zbyt duża liczba unikalnych wartości powoduje problemy z danymi i dokładnością raportów Google Analytics. Więcej informacji o sprawdzonych metodach ustawiania wymiarów niestandardowych.


Zanim zaczniesz

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

Wysyłanie identyfikatorów użytkowników

Wartość wysyłana 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żytkownika.
  • Użytkownik był zalogowany, a potem się wylogował: wyślij wartość null.

Aby wysł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 sprawdzeniami, czy użytkownik jest zalogowany oraz czy był zalogowany, ale się wylogował.
  3. Jeśli użytkownik jest zalogowany, zastąp USER_ID jego identyfikatorem użytkownika.
  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 ciągu znaków "null" lub "NULL".

Ustawianie identyfikatora użytkownika po inicjalizacji

W wielu przypadkach identyfikator user_id nie jest znany podczas pierwszej inicjalizacji tagu Google. Użytkownik może na przykład odwiedzić Twoją witrynę i zalogować się dopiero później.

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

Ustawianie identyfikatora użytkownika podczas logowania

Gdy użytkownik się zaloguje, wywołaj polecenie 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');

Czyszczenie identyfikatora użytkownika podczas wylogowywania

Gdy użytkownik się wyloguje, wyczyść identyfikator 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 polecenia gtag('set'), masz pewność, że identyfikator user_id jest prawidłowo zarządzany przez całą sesję użytkownika, odzwierciedlając jego bieżący stan logowania, nawet jeśli zmieni się on po wczytaniu strony.

Wstecz
Dodaj parametry
Dalej
Mierz wyjątki