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.

Peringatan: Jangan menetapkan dimensi kustom berdasarkan 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 Google Analytics dan akurasi pelaporan. Pelajari lebih lanjut praktik terbaik untuk menetapkan dimensi kustom.

Parameter user_id adalah parameter konfigurasi, bukan properti pengguna kustom atau parameter peristiwa standar. Sebagai gantinya, user_id adalah parameter sistem yang dicadangkan dan digunakan secara khusus untuk mengidentifikasi pengguna yang diautentikasi di berbagai perangkat dan sesi. Jangan tetapkan parameter ini sebagai properti pengguna kustom (misalnya, dalam objek user_properties untuk gtag.js atau di bagian Properti Pengguna pada tag Google Tag Manager), dan jangan daftarkan parameter ini sebagai dimensi kustom di UI Analytics. Demikian pula, jangan teruskan parameter ini sebagai parameter tingkat peristiwa pada setiap peristiwa. Sebagai gantinya, tetapkan user_id hanya sebagai parameter konfigurasi menggunakan metode berikut.

gtag.js Tag Manager

Sebelum memulai

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

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

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.

Cara User-ID digunakan di Google Analytics

Setelah Anda mengirim nilai user_id ke Google Analytics, nilai tersebut akan digunakan untuk:

• Menyatukan perjalanan pengguna: Menghubungkan aktivitas pengguna di berbagai sesi, perangkat, dan platform untuk pengguna yang login.
• Meningkatkan jumlah pengguna: Memberikan metrik pengguna yang lebih akurat dan tidak duplikat.
• Mengaktifkan analisis:
  • Menganalisis aktivitas berdasarkan status login: Menggunakan dimensi seperti "Login dengan ID pengguna" untuk membuat perbandingan dalam laporan standar atau segmen di Eksplorasi.
  • Mendukung teknik eksplorasi Analisis Pengguna, yang memungkinkan Anda melihat perincian linimasa aktivitas untuk setiap pengguna.

Pertimbangan penting

• JANGAN membuat dimensi kustom untuk User-ID: Anda tidak boleh mendaftarkan user_id sebagai dimensi kustom cakupan pengguna. Ini adalah praktik terbaik utama. Melakukannya akan membuat dimensi berkardinalitas tinggi yang tidak perlu, yang dapat berdampak buruk pada performa laporan, menyebabkan data dikelompokkan ke dalam baris "(other)", dan menggunakan kuota dimensi kustom Anda. Fitur User-ID bawaan menangani penggabungan pengguna. Pelajari lebih lanjut di Praktik terbaik untuk User-ID.

• Tetapkan user_id sebagai setelan konfigurasi, bukan properti pengguna atau parameter peristiwa:Karena user_id adalah parameter sistem yang dicadangkan, parameter ini hanya boleh diterapkan sebagai konfigurasi atau parameter setelan (menggunakan perintah gtag() config atau set atau setelan konfigurasi tag Google Tag Manager). Jangan konfigurasikan parameter ini sebagai properti pengguna kustom, teruskan parameter ini di dalam objek setelan user_properties, atau kirim parameter ini sebagai parameter tingkat peristiwa pada setiap peristiwa.

• Visibilitas ID langsung dalam laporan standar vs. eksplorasi: Nilai user_id mentah tidak tersedia sebagai dimensi standar dalam laporan standar atau sebagian besar eksplorasi (seperti Bentuk Bebas) untuk menjaga privasi dan mengelola kardinalitas. Namun, Anda dapat melihat user_id mentah di template eksplorasi Analisis Pengguna di kolom berlabel ID pengguna efektif untuk pengguna yang login.

• Mengakses User-ID mentah: Jika Anda perlu melakukan analisis menggunakan nilai mentah user_id, pendekatan yang direkomendasikan adalah menggunakan BigQuery Export GA4. Kolom user_id tersedia dalam data yang diekspor.

Untuk memastikan data User-ID digunakan dan terlihat di Analisis Pengguna, pastikan Identitas Pelaporan properti Anda ditetapkan ke Gabungan atau Teramati.