Mengirim ID pengguna

User-ID adalah ID unik Anda sendiri yang Anda tetapkan ke masing-masing pengguna. Panduan ini menjelaskan cara mengirim User-ID 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 User-ID untuk aplikasi, baca artikel Menetapkan User-ID.

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


Sebelum memulai

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

Mengirim User-ID

Nilai yang Anda kirim untuk user_id bergantung pada status pengguna:

  • Pengguna belum pernah login: Jangan kirim parameter user_id.
  • Pengguna login: Kirim User-ID-nya.
  • Pengguna login, lalu logout: Kirim null.

Untuk mengirim User-ID 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 User-ID-nya.
  4. Saat pengguna logout, tetapkan user_id ke null. Jangan kirim string kosong (""), string kosong (" "), atau kata yang dikutip "null" atau "NULL".

Menetapkan User-ID setelah inisialisasi

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

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

Menetapkan User-ID 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');

Menghapus User-ID saat logout

Saat pengguna logout, Anda harus menghapus user_id dengan menetapkan 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 di seluruh sesi pengguna, yang mencerminkan status login pengguna saat ini meskipun status tersebut berubah setelah halaman dimuat.