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

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];