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

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

نظرة عامة

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

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

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

اسم الحقل	النوع	الوصف
الفهرس	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". لمزيد من المعلومات، يُرجى الاطّلاع على بنود الخدمة.