Kullanıcı kimliklerini gönderme

Kullanıcı kimlikleri, tek tek kullanıcılara atadığınız kendi benzersiz tanımlayıcılarınızdır. Bu kılavuzda, kullanıcı kimliklerini Google Analytics'e nasıl göndereceğiniz açıklanmaktadır. Böylece, kullanıcı davranışlarını farklı oturumlar, cihazlar ve platformlar arasında bağlayabilirsiniz.

User-ID özelliği hakkında daha fazla bilgi edinmek için Platformlar arası etkinliği ölçme başlıklı makaleyi inceleyin. Bir uygulama için kullanıcı kimliğinin nasıl ayarlanacağını öğrenmek istiyorsanız Kullanıcı kimliği ayarlama başlıklı makaleyi inceleyin.

Uyarı: Kullanıcı kimliklerine göre özel boyutlar ayarlamayın.

Kullanıcı kimliklerine göre özel boyutların ayarlanması, çok fazla benzersiz değere sahip boyutlara yol açar. Çok fazla benzersiz değer olması, Google Analytics verileri ve raporlarının doğruluğuyla ilgili sorunlara neden olur. Özel boyutları ayarlamayla ilgili en iyi uygulamalar hakkında daha fazla bilgi edinin.

gtag.js Etiket Yöneticisi

Başlamadan önce

Kullanıcı kimliklerini gönderebilmek için aşağıdakileri tamamladığınızdan emin olun:

• Google Analytics hesabı ve mülkü oluşturun.
• Web siteniz için web veri akışı oluşturun.
• Google etiketini web sitenize yerleştirin.
• Web sitenizin kaynak koduna erişebilmeniz gerekir.
• Google Analytics hesabında Düzenleyici rolüne (veya daha üst düzey bir role) sahip olmanız gerekir.

Kullanıcı kimliklerini gönderme

user_id için gönderdiğiniz değer, kullanıcının durumuna bağlıdır:

• Kullanıcı hiç oturum açmamışsa: user_id parametresini göndermeyin.
• Kullanıcının oturumu açık: Kullanıcı kimliğini gönderin.
• Kullanıcı oturum açtıktan sonra oturumu kapattıysa: null gönderin.

Analytics'e kullanıcı kimliği göndermek için web sitenizin her sayfasındaki config komutuna user_id parametresini ekleyin:

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. TAG_ID yerine etiket kimliğinizi girin.
2. Yorumları, kullanıcının oturumunun açık olup olmadığı ve oturumunun açıkken kapatılıp kapatılmadığına dair kontrollerinizle değiştirin.
3. Kullanıcı oturum açtıysa USER_ID yerine kullanıcı kimliğini girin.
4. Kullanıcı oturumu kapattığında user_id değerini null olarak ayarlayın. Boş dize (""), boşluk dizesi (" ") veya tırnak içine alınmış "null" ya da "NULL" kelimelerini göndermeyin.

Başlatma işleminden sonra User-ID ayarlama

Çoğu durumda, Google etiketi ilk kez başlatıldığında user_id bilinmez. Örneğin, bir kullanıcı sitenizi ziyaret edebilir ve yalnızca daha sonra oturum açabilir.

İlk sayfa yüklemesinden sonra user_id değerini ayarlamak veya güncellemek için gtag('set') komutunu kullanın. Bu komut, sayfadaki sonraki tüm etkinlikler için user_id değerini ayarlar ve bu senaryoda gtag('config') yerine kullanılması önerilen yaklaşımdır.

Giriş yapıldığında kullanıcı kimliğini ayarlama

Bir kullanıcı başarıyla giriş yaptığında, kimliğini gelecekteki etkinliklerle ilişkilendirmek için gtag('set') işlevini çağırın:

// 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');

Çıkış yapıldığında User-ID'yi temizleme

Kullanıcı çıkış yaptığında, değerini null olarak ayarlayarak user_id temizlemelisiniz:

// 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();

gtag('set') kullanarak user_id öğesinin kullanıcı oturumu boyunca doğru şekilde yönetilmesini sağlarsınız. Bu sayede, sayfa yüklendikten sonra değişse bile kullanıcının mevcut giriş durumu yansıtılır.