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

+iOS نظام التشغيل Android الويب

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

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

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

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

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

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

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

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

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

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

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

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

• نوع MIME

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

جمع بيانات المستخدمين: لا يجمع Performance Monitoring نفسه أي معلومات لتحديد الهوية الشخصية (PII)، مثل الأسماء أو عناوين البريد الإلكتروني أو العناوين أو أرقام الهواتف. يمكن للمطوّرين جمع بيانات إضافية باستخدام 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 نفسه أي معلومات لتحديد الهوية الشخصية (PII)، مثل الأسماء أو عناوين البريد الإلكتروني أو العناوين أو أرقام الهواتف. يمكن للمطوّرين جمع بيانات إضافية باستخدام 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];