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 User ID.

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

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;
• Musisz mieć rolę Edytujący (lub o większych uprawnieniach) na koncie Google Analytics.

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 parametr 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.