مرجع User-ID

في هذه المقالة:

نظرة عامة

يمكن للمستخدمين التفاعل مع موقعك على الويب أو تطبيقك من عدد من الأجهزة المختلفة، مثل متصفح ويب على جهاز كمبيوتر سطح المكتب، أو متصفح على هاتف جوّال، أو عبر تطبيق جوّال مضمّن. بشكل تلقائي، يعيّن برنامج "إحصاءات" لكل جهازٍ Client ID فريدًا، ويُعتبر كل Client ID فريد مُستخدِمًا فريدًا في تقاريرك. يسمح User-ID بالقياس الشامل لتفاعلات المستخدمين على الأجهزة، مثل إحالة تفاعل مع حملة تسويق على جهاز إلى إحالة ناجحة تحدث على جهاز آخر، أو إلغاء تكرار المستخدمين الفريدين على أجهزة متعددة.

تتألَّف ميزة User-ID مما يلي:

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

عند إرسال معرّفات User-ID مع نتائج Analytics في حقل userId، تعكس تقاريرك عددًا أكثر دقة للمستخدمين الفريدين وتوفّر خيارات جديدة عبر الأجهزة لإعداد التقارير.

توضح هذه المقالة كيفية تهيئة معرّفات User-ID وإرسالها إلى Analytics، إضافةً إلى كيفية معالجة بيانات User-ID وإعداد تقارير بها في الملفات الشخصية التي تم تمكين User-ID بها.

التهيئة

قبل إرسال معرّفات User-ID إلى Analytics، يجب تمكين ملف شخصي واحد على الأقل لإعداد التقارير من أجل User-ID.

يؤثّر تمكين ملف شخصي من أجل User-ID بشكلين على هذا الملف الشخصي:

1. احتساب المستخدمين الجدد والفريدين باستخدام معرّفات User-ID الفريدة بدلاً من معرّفات Client ID الفريدة.
2. تمكين التقارير عبر الأجهزة التي تستفيد من User-ID في هذا الملف الشخصي.

التجميع

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

الأمر متروك لك لتقديم المعرّفات. ويتم إنشاء المعرِّفات عادةً بواسطة نظام مصادقة يخصَّص معرِّفًا فريدًا وثابتًا لكل مستخدم سجَّل الدخول، ويتعيّن أن تكون له الخصائص التالية:

• غير محدِّد للهوية الشخصية
• فريد لأحد مستخدمي خدمتك أو تطبيقك
• ثابت لمستخدم مسجَّل الدخول عبر جميع الأجهزة

للتعرّف على مزيد من المعلومات حول كيفية تحديد userId في بيئة معيّنة، اطَّلع على دليل مطوّر البرامج لحزمة تطوير البرامج (SDK) وواجهات برمجة التطبيقات (API) للتجميع لمكتبتك المحددة.

المعالجة

تتم معالجة نتائج "إحصاءات"، مثل مرات مشاهدة الصفحة أو الأحداث أو المعاملات التي تم تعيين حقل userId لها، بشكل منفصل عن النتائج بخلاف userId وستكون ظاهرة فقط في الملفات الشخصية التي تم تمكين User-ID فيها.

على سبيل المثال، عند تعيين User-ID، في الملفات الشخصية التي تم تمكين User-ID فيها، في وسط جلسة حالية لبرنامج "إحصاءات"، سيتم تغيير بداية الجلسة إلى النتيجة الأولى التي تم تعيين User-ID فيها.

يتم إعداد التقارير في الملفات الشخصية بخلاف User-ID للجلسة الكاملة بدون مراعاة لحقل userId.

إعداد التقارير

بعد المعالجة، تتوفّر بيانات الجلسة التي تم تعيين userId لها للملفات الشخصية التي تم تمكين User-ID فيها في التقارير عبر الأجهزة. على الرغم من توفّر بيانات الجلسات عبر واجهة برمجة التطبيقات لإعداد التقارير الأساسية، فلا يتوفّر حقل userId كسمة في التقارير ولا يمكن تصديره من Analytics.

تستند مقاييس المستخدمين الجدد والفريدين أيضًا إلى User-ID في هذه الملفات الشخصية. في الملفات الشخصية التي لم يتم فيها تمكين User-ID، سيتم حساب هذه المقاييس باستخدام معرّفات clientId فريدة.

ملاحظة : يمكن أن يكون لتقارير نشاط المستخدمين على جميع الأجهزة نطاق زمني أقصى يبلغ 90 يومًا.

Client ID في مقابل User-ID

يلخّص الجدول التالي الاختلافات بين Client ID وUser-ID:

	Client ID	User-ID
ماذا يمثّل المعرّف؟	نسخة لجهاز أو متصفّح غير منسوبة لصاحبها	مستخدم واحد، مثل حساب مستخدم مسجَّل الدخول، والذي قد يتفاعل مع المحتوى على نسخة لجهاز و/ أو متصفح واحد أو أكثر.
كيف يتم تعيين المعرّف؟	يتم إنشاؤه بشكل عشوائي ويتم إرساله تلقائيًا مع جميع النتائج من جانب مكتبات Analytics.	يجب تعيين معرّفات userId التابعة لك وإرسالها مع نتائجك في Analytics.
كيف يتم استخدام المعرّف لحساب المستخدمين الفريدين؟	في أي ملف شخصي لم يتم تمكين User-ID فيه، يتم استخدام Client ID لحساب المستخدمين الفريدين.	في أي ملف شخصي تم تمكين User-ID فيه، يتم استخدام User-ID لحساب المستخدمين الفريدين.

الحدود

يتم العمل حاليًا بالحدود التالية لميزة User-ID:

• الحد الأقصى للنطاق الزمني للتقارير عبر الأجهزة التي تم تمكينها من خلال ميزة User-ID هو 90 يومًا.
• لا يمكن إرسال طلب بحث لقيمة User-ID كسمة في التقارير في واجهة الويب أو واجهات برمجة التطبيقات.

موارد ذات صلة

• تحديد User-ID على المواقع الإلكترونية عبر استخدام analytics.js
• تحديد User-ID على المواقع الإلكترونية عبر استخدام gtag.js
• حزمة SDK لنظام التشغيل Android: اطّلع على كيفية تحديد User-ID لتطبيقات متوافقة مع Android.
• حزمة SDK لنظام التشغيل iOS: تعرّف على كيفية تعيين User-ID لتطبيقات iOS.