فلترة البيانات باستخدام السمات

iOS+ Android الويب

باستخدام Performance Monitoring، يمكنك استخدام السمات لتقسيم بيانات الأداء والتركيز على أداء تطبيقك في سيناريوهات مختلفة من الاستخدام الفعلي.

بعد النقر على اسم عملية تتبُّع في جدول عمليات التتبُّع (الموجود في أسفل لوحة بيانات الأداء)، يمكنك الانتقال إلى تفاصيل المقاييس التي تهمّك. استخدِم الزر فلتر (في أعلى يمين الشاشة) لفلترة البيانات حسب السمة، على سبيل المثال:

تتم فلترة بيانات "مراقبة أداء Firebase" حسب السمة" />

• يمكنك الفلترة حسب إصدار التطبيق لعرض بيانات حول إصدار سابق أو أحدث إصدار.
• يمكنك الفلترة حسب الجهاز لمعرفة كيفية تعامل الأجهزة القديمة مع تطبيقك.
• يمكنك الفلترة حسب البلد للتأكّد من أنّ موقع قاعدة البيانات لا يؤثر في منطقة معيّنة.

لتحليل أكثر فعالية استنادًا إلى السمات، يمكنك تصدير بيانات الأداء إلى BigQuery.

السمات التلقائية

تجمع Performance Monitoring تلقائيًا مجموعة متنوّعة من السمات التلقائية استنادًا إلى نوع التتبُّع.

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

السمات التلقائية لتطبيقات Apple وAndroid

تجمع جميع عمليات التتبُّع لتطبيقات Apple وAndroid السمات التالية تلقائيًا:

• إصدار التطبيق
• البلد
• مستوى نظام التشغيل
• الجهاز
• راديو
• شركة جوال‬

بالإضافة إلى ذلك، تجمع عمليات تتبُّع طلبات الشبكة السمة التالية أيضًا:

• نوع MIME

جمع بيانات المستخدمين

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

في ما يلي مثال على رسالة سجل لا تحتوي على معلومات تحديد الهوية الشخصية:

trace.putAttribute("experiment", "A");

في ما يلي مثال يتضمّن معلومات تحديد الهوية الشخصية (يُرجى عدم استخدام هذا النوع من السمات المخصّصة في تطبيقك):

trace.putAttribute("email", user.getEmailAddress());

ويخضع أي محتوى يكشف عن أي معلومات تحدّد الهوية الشخصية للحذف بدون إشعار.

إنشاء سمات مخصّصة

يمكنك إنشاء سمات مخصّصة على أيّ من عمليات التتبُّع المخصّصة للرموز التي تمّت مراقبتها.

استخدِم واجهة برمجة التطبيقات Performance Monitoring Trace API (Swift | Obj-C) لإضافة سمات مخصّصة إلى عمليات تتبُّع الرموز المخصّصة.

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

لاحظ ما يلي:

• يجب أن تستوفي أسماء السمات المخصّصة المتطلبات التالية:

  • لا توجد مسافة بيضاء بادئة أو لاحقة، ولا يوجد حرف شرطة سفلية بادئة (_)
  • ما مِن مساحات
  • الحد الأقصى للطول هو 32 حرفًا.
  • الأحرف المسموح بها في الاسم هي A-Z وa-z و_.

• يمكن أن يسجّل كلّ تتبُّع للرمز المخصّص ما يصل إلى 5 سمات مخصّصة.

• يُرجى التأكّد من أنّ السمات المخصّصة لا تتضمّن أي معلومات تحدّد هوية فرد معيّن لدى Google.

  مزيد من المعلومات عن هذه الإرشادات

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

  في ما يلي مثال على رسالة سجل لا تحتوي على معلومات تحديد الهوية الشخصية:

  trace.putAttribute("experiment", "A");

  في ما يلي مثال يتضمّن معلومات تحديد الهوية الشخصية (يُرجى عدم استخدام هذا النوع من السمات المخصّصة في تطبيقك):

  trace.putAttribute("email", user.getEmailAddress());

  ويخضع أي محتوى يكشف عن أي معلومات تحدّد الهوية الشخصية للحذف بدون إشعار.

Swift

ملاحظة: لا يتوفّر منتج Firebase هذا على أنظمة التشغيل macOS وMac Catalyst وwatchOS.

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

// Delete scenario.
trace.removeAttribute("experiment")

// Read attributes.
let attributes:[String, String] = trace.attributes;

Objective-C

ملاحظة: لا يتوفّر منتج Firebase هذا على أنظمة التشغيل macOS وMac Catalyst وwatchOS.

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [trace attributes];