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

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

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

المعلَمة user_id هي مَعلمة إعدادات، وليست خاصية مستخدم مخصّصة أو مَعلمة خاصة بالحدث. بدلاً من ذلك، user_id هي مَعلمة نظام محجوزة تُستخدَم تحديدًا لتحديد المستخدمين الذين تمّت المصادقة عليهم على مستوى الأجهزة والجلسات. لا تضبطها كخاصية مستخدم مخصّصة (مثلاً، في العنصر user_properties لـ gtag.js أو في قسم خصائص المستخدمين في علامات Google Tag Manager)، ولا تسجّلها كسمة مخصّصة في واجهة مستخدم "إحصاءات Google". وبالمثل، لا تمرِّرها كمَعلمة على مستوى الحدث في الأحداث الفردية. بدلاً من ذلك، اضبط user_id كمَعلمة إعدادات فقط باستخدام الطرق التالية.


قبل البدء

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

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

تعتمد القيمة التي ترسلها لـ 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') يضبط هذا الأمر 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 بشكلٍ صحيح طوال جلسة المستخدم، ما يعكس حالة تسجيل الدخول الحالية للمستخدم حتى إذا تغيّرت بعد تحميل الصفحة.

كيفية استخدام User-ID في "إحصاءات Google"

بعد إرسال قيم user_id إلى "إحصاءات Google"، يتم استخدامها في ما يلي:

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

اعتبارات مهمة

  • لا تُنشئ سمات مخصّصة لرقم تعريف المستخدم: لا يجب تسجيل user_id كسمة مخصّصة على مستوى المستخدم. هذه أفضل ممارسة أساسية. يؤدي ذلك إلى إنشاء سمة تتضمّن عددًا كبيرًا من القيم الفريدة غير ضرورية، ما قد يؤثر بشدة في أداء التقرير ويؤدي إلى تجميع البيانات في الصف "(other)" ويستهلك حصة السمات المخصّصة. تتولّى ميزة User-ID المضمّنة ربط المستخدمين. مزيد من المعلومات في أفضل الممارسات لميزة User-ID.

  • اضبط user_id كإعدادات ضبط، وليس كخاصية مستخدم أو مَعلمة خاصة بالحدث: بما أنّ user_id هي مَعلمة نظام محجوزة، يجب تطبيقها فقط كـ إعدادات ضبط أو مَعلمة إعدادات (باستخدام الأوامر gtag() أو config أو set أو إعدادات ضبط علامة تتبُّع من Google في Google Tag Manager). لا تضبطها كخاصية مستخدم مخصّصة أو تمرِّرها داخل العنصر user_properties أو تُرسِلها كمَعلمة على مستوى الحدث في الأحداث الفردية.

  • مدى ظهور رقم التعريف المباشر في التقارير العادية مقابل الاستكشافات: لا تتوفّر قيم user_id الأولية كسمة عادية في التقارير العادية أو معظم الاستكشافات (مثل "التقرير الحر") للحفاظ على الخصوصية وإدارة عدد القيم الفريدة للسمة. ومع ذلك، يمكنك عرض user_id الأولي في نموذج استكشاف تحليل سلوك المستخدِم ضِمن العمود الذي يحمل العنوان رقم تعريف المستخدم الفعلي للمستخدمين الذين سجّلوا الدخول.

  • الوصول إلى أرقام تعريف المستخدمين الأولية: إذا كنت بحاجة إلى إجراء تحليل باستخدام القيم الأولية user_id، فإنّ النهج المقترَح هو استخدام BigQuery Export في "إحصاءات Google‏ 4". يتوفّر الحقل user_id في البيانات التي تم تصديرها.

لضمان استخدام بيانات User-ID وظهورها في تحليل سلوك المستخدِم، تأكَّد من ضبط هوية إعداد التقارير في موقعك على مختلطة أو ملاحظة.

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