المقاييس والسمات المخصّصة - حزمة تطوير البرامج (SDK) لنظام التشغيل Android

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

نظرة عامة

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

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

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

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

ضبط القيم وإرسالها

لضبط قيمة سمة مخصّصة وإرسالها:

// May return null if EasyTracker has not yet been initialized with a
// property ID.
EasyTracker easyTracker = EasyTracker.getInstance();

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once, so it is set on the Map,
// not the tracker.
easyTracker.send(MapBuilder
    .createAppView("Home screen")
    .set(Fields.customDimension(1), "premiumUser");
    .build()
);

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

لضبط قيمة مقياس مخصّص وإرسالها:

// May return null if EasyTracker has not yet been initialized with a
// property ID.
EasyTracker easyTracker = EasyTracker.getInstance();


// Set the custom metric to be incremented by 5 using its index.
easyTracker.set(Fields.customMetric(1), 5);


// Custom metric value sent is with this screen view.
easyTracker.send(MapBuilder
    .createAppView("Home screen")
    .build()
);

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

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

اعتبارات الأبعاد المخصّصة

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

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

الأبعاد المخصّصة وفلاتر الملفات الشخصية (الملف الشخصي)

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

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

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

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

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

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

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

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

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

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