إرسال أرقام تعريف المستخدمين

أرقام تعريف المستخدمين هي معرّفات فريدة خاصة بك تعيّنها لمستخدمين فرديين. يشرح هذا الدليل كيفية إرسال أرقام تعريف المستخدمين إلى "إحصاءات Google"، ما يتيح لك ربط سلوك المستخدمين في الجلسات والأجهزة والمنصّات المختلفة.

لمزيد من المعلومات عن ميزة User-ID، يُرجى الاطّلاع على مقالة قياس النشاط على مختلف المنصّات. للتعرّف على كيفية ضبط رقم تعريف مستخدم لتطبيق، يُرجى الاطّلاع على مقالة ضبط رقم تعريف مستخدم.

يؤدي ضبط سمات مخصّصة استنادًا إلى أرقام تعريف المستخدمين إلى إنشاء سمات تتضمّن عددًا كبيرًا جدًا من القيم الفريدة. ويؤدي وجود عدد كبير جدًا من القيم الفريدة إلى حدوث مشاكل في بيانات "إحصاءات Google" ودقة التقارير. مزيد من المعلومات عن أفضل الممارسات لـ ضبط السمات المخصّصة.


قبل البدء

قبل أن تتمكّن من إرسال أرقام تعريف المستخدمين، تأكَّد من إكمال ما يلي:

إرسال أرقام تعريف المستخدمين

تعتمد القيمة التي ترسلها إلى user_id على حالة المستخدم:

  • لم يسبق للمستخدم تسجيل الدخول: لا تُرسِل المَعلمة user_id.
  • المستخدم مسجّل الدخول: أرسِل رقم تعريف المستخدم.
  • المستخدم كان مسجّلاً الدخول، ثم سجّل الخروج: أرسِل null.

لإرسال رقم تعريف مستخدم إلى "إحصاءات Google"، أضِف المَعلمة user_id إلى الأمر config في كل صفحة من صفحات موقعك الإلكتروني:

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 برقم تعريف علامتك .
  2. استبدِل التعليقات بعمليات التحقّق مما إذا كان المستخدم مسجّلاً الدخول، وما إذا كان المستخدم مسجّلاً الدخول ثم سجّل الخروج.
  3. إذا كان المستخدم مسجّلاً الدخول، استبدِل USER_ID برقم تعريف المستخدم.
  4. عندما يسجّل المستخدم الخروج، اضبط user_id على null. لا تُرسِل سلسلة فارغة ("") أو سلسلة فارغة (" ") أو الكلمات بين علامتَي اقتباس "null" أو "NULL".

ضبط رقم تعريف المستخدم بعد التهيئة

في كثير من الحالات، لا يكون user_id معروفًا عند تهيئة علامة التتبُّع من Google لأول مرة. على سبيل المثال، قد يزور المستخدم موقعك الإلكتروني ويسجّل الدخول لاحقًا فقط.

لضبط user_id أو تعديله بعد تحميل الصفحة الأولية، استخدِم الـ gtag('set') command. يضبط هذا الأمر user_id لجميع الأحداث اللاحقة على الصفحة، وهو الأسلوب المقترَح بدلاً من gtag('config') في هذا السيناريو.

ضبط رقم تعريف المستخدم عند تسجيل الدخول

عندما يسجّل المستخدم الدخول بنجاح، استدعِ gtag('set') لربط رقم تعريفه بـ الأحداث المستقبلية:

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

محو رقم تعريف المستخدم عند تسجيل الخروج

عندما يسجّل المستخدم الخروج، عليك محو user_id من خلال ضبط قيمته على 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();

باستخدام gtag('set')، يمكنك التأكّد من إدارة user_id بشكلٍ صحيح طوال جلسة المستخدم، ما يعكس حالة تسجيل الدخول الحالية للمستخدم حتى إذا تغيّرت بعد تحميل الصفحة.

السابق
إضافة معلمات
التالي
قياس الاستثناءات