Mengirim ID pengguna

ID Pengguna adalah ID unik Anda sendiri yang Anda tetapkan kepada setiap pengguna. Panduan ini menjelaskan cara mengirim ID pengguna ke Google Analytics, sehingga Anda dapat menghubungkan perilaku pengguna di berbagai sesi, perangkat, dan platform.

Untuk mempelajari fitur User-ID lebih lanjut, baca artikel Mengukur aktivitas di berbagai platform. Untuk mempelajari cara menyiapkan ID pengguna untuk aplikasi, lihat artikel Menetapkan User-ID.

Peringatan: Jangan tetapkan dimensi kustom berdasarkan ID pengguna.

Menetapkan dimensi kustom berdasarkan ID pengguna akan menghasilkan dimensi dengan terlalu banyak nilai unik. Memiliki terlalu banyak nilai unik menyebabkan masalah pada akurasi data dan pelaporan Google Analytics. Pelajari lebih lanjut praktik terbaik untuk menetapkan dimensi kustom.

gtag.js Tag Manager

Sebelum memulai

Sebelum dapat mengirim ID pengguna, pastikan Anda telah menyelesaikan hal berikut:

• Buat akun dan properti Google Analytics.
• Membuat aliran data web untuk situs Anda.
• Tempatkan tag Google di situs Anda.
• Memiliki akses ke kode sumber situs Anda.
• Memiliki peran Editor (atau yang lebih tinggi) di akun Google Analytics.

Mengirim ID pengguna

Nilai yang Anda kirim untuk user_id bergantung pada status pengguna:

• Pengguna belum pernah login: Jangan kirim parameter user_id.
• Pengguna login: Kirim ID pengguna mereka.
• Pengguna login, lalu logout: Kirim null.

Untuk mengirim ID pengguna ke Analytics, tambahkan parameter user_id ke perintah config di setiap halaman situs Anda:

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. Ganti TAG_ID dengan ID tag Anda.
2. Ganti komentar dengan pemeriksaan Anda untuk mengetahui apakah pengguna login, dan apakah pengguna login, tetapi kemudian logout.
3. Jika pengguna login, ganti USER_ID dengan ID pengguna mereka.
4. Saat pengguna logout, tetapkan user_id ke null. Jangan mengirim string kosong (""), string kosong (" "), atau kata yang dikutip "null" atau "NULL".

Menetapkan ID pengguna setelah inisialisasi

Dalam banyak kasus, user_id tidak diketahui saat Tag Google diinisialisasi pertama kali. Misalnya, pengguna dapat mengunjungi situs Anda dan hanya login nanti.

Untuk menyetel atau memperbarui user_id setelah pemuatan halaman awal, gunakan perintah gtag('set'). Perintah ini menetapkan user_id untuk semua peristiwa berikutnya di halaman dan merupakan pendekatan yang direkomendasikan, bukan gtag('config') dalam skenario ini.

Menetapkan ID pengguna saat login

Saat pengguna berhasil login, panggil gtag('set') untuk mengaitkan ID-nya dengan peristiwa mendatang:

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

Hapus User-ID saat logout

Saat pengguna keluar, Anda harus menghapus user_id dengan menyetel nilainya ke 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();

Dengan menggunakan gtag('set'), Anda memastikan bahwa user_id dikelola dengan benar selama sesi pengguna, yang mencerminkan status login pengguna saat ini meskipun berubah setelah halaman dimuat.