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

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

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

تحذير: لا تضبط سمات مخصّصة استنادًا إلى أرقام تعريف المستخدمين.

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

gtag.js إدارة العلامات من Google

قبل البدء

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

• أنشِئ حسابًا وموقعًا على "إحصاءات 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" بين علامتَي اقتباس.