Catch up on highlights from Firebase at Google I/O 2023. Learn more

تعيين خصائص المستخدم

خصائص المستخدم هي سمات تحددها لوصف أجزاء من قاعدة المستخدمين ، مثل تفضيلات اللغة أو الموقع الجغرافي. يمكن استخدامها لتحديد الجماهير لتطبيقك. يوضح لك هذا الدليل كيفية تعيين خصائص المستخدم في تطبيقك.

يقوم برنامج Analytics بتسجيل بعض خصائص المستخدم تلقائيًا ؛ لا تحتاج إلى إضافة أي كود لتمكينهم. إذا كنت بحاجة إلى جمع بيانات إضافية ، فيمكنك إعداد ما يصل إلى 25 خاصية مختلفة للمستخدم لكل مشروع. لاحظ أن أسماء خصائص المستخدم حساسة لحالة الأحرف وأن تعيين خاصيتين للمستخدم تختلف أسماؤهما فقط في الحالة يؤدي إلى تسجيل خاصيتين مختلفتين للمستخدم.

لا يمكنك استخدام مجموعة صغيرة من أسماء خصائص المستخدمين المحجوزة بواسطة Google:

  • عمر
  • جنس
  • اهتمام

قبل ان تبدأ

تأكد من أنك أعددت مشروعك وأنه يمكنك الوصول إلى Analytics كما هو موضح في بدء استخدام Analytics .

تعيين خصائص المستخدم

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

لتعيين خاصية مستخدم ، اتبع الخطوات التالية:

  1. أنشئ تعريفًا مخصصًا لخاصية المستخدم في صفحة التعريفات المخصصة في Analytics في وحدة تحكم Firebase. لمزيد من المعلومات ، راجع الأبعاد والمقاييس المخصصة .
  2. عيِّن خاصية مستخدم في تطبيقك باستخدام طريقة setUserProperty() .

يوضح المثال التالي كيفية إضافة خاصية افتراضية "طعام مفضل" ، والتي تعين القيمة في سلسلة food إلى المستخدم النشط:

Web modular API

import { getAnalytics, setUserProperties } from "firebase/analytics";

const analytics = getAnalytics();
setUserProperties(analytics, { favorite_food: 'apples' });

Web namespaced API

firebase.analytics().setUserProperties({favorite_food: 'apples'});

يمكنك الوصول إلى هذه البيانات من صفحة التعريفات المخصصة في Analytics في وحدة تحكم Firebase. تعرض الصفحة قائمة بخصائص المستخدم التي حددتها لتطبيقك. يمكنك استخدام هذه الخصائص في مقارنات على العديد من التقارير المتوفرة في Google Analytics. اقرأ المزيد عن لوحة تحكم تقارير Analytics في مركز مساعدة Firebase.