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.

user_id parametresi, özel kullanıcı özelliği veya standart etkinlik parametresi değil, bir yapılandırma parametresidir. Bunun yerine, user_id, cihazlar ve oturumlar arasında kimliği doğrulanmış kullanıcıları tanımlamak için özel olarak kullanılan ayrılmış bir sistem parametresidir. Bu özelliği özel bir kullanıcı özelliği olarak ayarlamayın (örneğin, user_properties nesnesinde gtag.js veya Google Etiket Yöneticisi etiketlerinin Kullanıcı Özellikleri bölümünde) ve Analytics kullanıcı arayüzünde özel boyut olarak kaydetmeyin. Aynı şekilde, bu parametreyi tek tek etkinliklerde etkinlik düzeyinde bir parametre olarak iletmeyin. Bunun yerine, aşağıdaki yöntemleri kullanarak user_id değerini yalnızca bir yapılandırma parametresi olarak ayarlayın.


Başlamadan önce

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

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.

User-ID'nin Google Analytics'te kullanılma şekli

user_id değerlerini Google Analytics'e gönderdiğinizde bu değerler şu amaçlarla kullanılır:

  • Kullanıcı yolculuklarını birleştirme: Oturum açmış kullanıcılar için farklı oturumlar, cihazlar ve platformlardaki kullanıcı etkinliğini bağlayın.
  • Kullanıcı sayılarını iyileştirme: Daha doğru ve tekilleştirilmiş kullanıcı metrikleri sunar.
  • Analizi etkinleştirme:
    • Oturum açma durumuna göre etkinliği analiz etme: Standart raporlarda karşılaştırmalar veya keşiflerde segmentler oluşturmak için "Kullanıcı kimliğiyle oturum açıldı" gibi boyutları kullanın.
    • Kullanıcı Gezgini keşif tekniğini destekleyerek bağımsız kullanıcıların etkinlik zaman çizelgesini ayrıntılı olarak incelemenize olanak tanır.

Dikkat edilecek önemli noktalar

  • User-ID için özel boyutlar OLUŞTURMAYIN: user_id, kullanıcı kapsamlı özel boyut olarak kaydedilmemelidir. Bu, önemli bir en iyi uygulamadır. Bunu yapmanız, gereksiz bir yüksek kardinaliteli boyut oluşturur. Bu durum, rapor performansını ciddi şekilde etkileyebilir, verilerin "(other)" satırında gruplandırılmasına neden olabilir ve özel boyut kotanızı tüketebilir. Kullanıcı birleştirme işlemi, yerleşik User-ID özelliğiyle yapılır. Daha fazla bilgiyi User-ID ile ilgili en iyi uygulamalar başlıklı makalede bulabilirsiniz.

  • user_id'ı kullanıcı özelliği veya etkinlik parametresi olarak değil, yapılandırma ayarı olarak ayarlayın: user_id ayrılmış bir sistem parametresi olduğundan yalnızca yapılandırma veya ayar parametresi olarak uygulanmalıdır (gtag() config ya da set komutları veya Google Etiket Yöneticisi'nin Google etiketi yapılandırma ayarları kullanılarak). Özel kullanıcı özelliği olarak yapılandırmayın, user_properties ayarlar nesnesinin içinde iletmeyin veya ayrı etkinliklerde etkinlik düzeyinde parametre olarak göndermeyin.

  • Standart raporlarda ve keşiflerde doğrudan kimlik görünürlüğü: Gizliliği korumak ve kardinaliteyi yönetmek için standart raporlarda veya çoğu keşifte (ör. Serbest Biçim) ham user_id değerleri standart boyut olarak kullanılamaz. Ancak, oturum açmış kullanıcılar için Kullanıcı Gezgini keşif şablonundaki Etkili kullanıcı kimliği etiketli sütunun altında ham user_id değerini görüntüleyebilirsiniz.

  • Ham kullanıcı kimliklerine erişme: Analizi ham user_id değerlerini kullanarak yapmanız gerekiyorsa önerilen yaklaşım Google Analytics 4 BigQuery Export özelliğini kullanmaktır. user_id alanı, dışa aktarılan verilerde kullanılabilir.

User-ID verilerinin kullanıldığından ve Kullanıcı Gezgini'nde görünür olduğundan emin olmak için mülkünüzün Raporlama Kimliği'nin Karışım veya Gözlemlenen olarak ayarlandığından emin olun.

Önceki
Parametre ekle
Sonraki
İstisnaları ölçme