الأبعاد والمقاييس المخصصة

يصف دليل المطوّر هذا كيفية استخدام الإصدار 4 من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google"، وذلك لنظام التشغيل Android لتنفيذ مكوّنات ومقاييس مخصّصة.

نظرة عامة

يمكنك إجراء ما يلي:

تتألف المقاييس والمكوّنات المخصّصة من حقلين:

اسم الحقل النوع الوصف
الفهرس Integer مؤشر المكوّن أو المقياس المخصّص. هذا الفهرس يستند إلى 1.
القيمة String قيمة السمة أو المقياس المخصّص. في هذه الحالة للمقاييس، سيتم تحليلها على أنها عدد صحيح أو قيمة عشرية ثابتة، في حال ضبط المقياس على نوع عملة.

إعداد القيم وإرسالها

لإعداد قيمة مكون مخصّص وإرسالها:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("Home Screen");

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once.
t.send(new HitBuilders.ScreenViewBuilder()
    .setCustomDimension(1, "premiumUser")
    .build()
);

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

لإعداد قيمة مقياس مخصّص وإرسالها:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("Home Screen");

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once.
t.send(new HitBuilders.ScreenViewBuilder()
    .setCustomMetric(1, 5)
    .build()
);

راجِع الإعدادات المتقدِّمة للحصول على تفاصيل عن طريقة getTracker.

اعتبارات التنفيذ

يوضّح هذا القسم اعتبارات إضافية يجب وضعها في الاعتبار عند تنفيذ السمات أو المقاييس المخصّصة.

اعتبارات للمكوّنات المخصّصة

تنطبق القيم مع النطاقات على مستوى المستخدم والجلسة على النتائج السابقة.

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

فلاتر المكوّنات المخصصة والملف الشخصي

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

اعتبارات المقاييس المخصّصة

يتم تجميع قيم المقاييس المخصّصة في التقارير

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

فلاتر المقاييس المخصّصة والملفات الشخصية للملف الشخصي

ضبط القيم باستخدام قياس الشاشة التلقائي

  • لتطبيق قيمة سمة مخصّصة على مشاهدة شاشة يتم إرسالها من خلال قياس الشاشة التلقائي، حدِّد القيمة قبل أن يتم استدعاء activityStart() أثناء onStart(). ملاحظة: في الحالات التي تكون فيها القيمة غير معروفة في وقت تنفيذ onStart()، ننصحك بقياس الشاشة يدويًا بدلاً من ذلك.

عدم إرسال معلومات تحديد الهوية الشخصية كقيم

  • وتحظر بنود خدمة "إحصاءات Google" إرسال أي معلومات تحديد هوية شخصية إلى خوادم "إحصاءات Google". لمزيد من المعلومات، يُرجى الاطّلاع على بنود الخدمة.