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

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

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

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

gtag.js Tag Manager

قبل البدء

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

• إنشاء حساب وموقع على "إحصاءات Google"
• أنشِئ مصدر بيانات لموقعك الإلكتروني.
• ضَع علامة تتبُّع من Google على موقعك الإلكتروني.
• أن يكون لديك إذن بالوصول إلى رمز المصدر الخاص بموقعك الإلكتروني
• يجب أن يكون لديك دور المحرِّر (أو دور أعلى) في حساب "إحصاءات 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'). يضبط هذا الأمر 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 وظهورها في مستكشف المستخدِم، تأكَّد من أنّ هوية إعداد التقارير في موقعك مضبوطة على مدمجة أو ملاحظة.