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

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

نظرة عامة

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

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

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

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

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

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

// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];

// Set the custom dimension value on the tracker using its index.
[tracker set:[GAIFields customDimensionForIndex:1]
       value:@"Premium user"];

[tracker set:kGAIScreenName
       value:@"Home screen"];

// 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.

// Previous V3 SDK versions.
// [tracker send:[[[GAIDictionaryBuilder createAppView] set:@"premium"
//                                                   forKey:[GAIFields customDimensionForIndex:1]] build]];

// // SDK Version 3.08 and up.
[tracker send:[[[GAIDictionaryBuilder createScreenView] set:@"premium"
                                                     forKey:[GAIFields customDimensionForIndex:1]] build]];

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

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

// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];


// Set the custom metric to be incremented by 5 using its index.
[tracker set:[GAIFields customMetricForIndex:1]
       value:[[NSNumber numberWithInt:5] stringValue]];


[tracker set:kGAIScreenName
       value:@"Home screen"];

// Custom metric value is sent with this screen view.
// [tracker send:[[GAIDictionaryBuilder createAppView] build]];     // Previous V3 SDK versions.
[tracker send:[[GAIDictionaryBuilder createScreenView] build]];     // SDK Version 3.08 and up.

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

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

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

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

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

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

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

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

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

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

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

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

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

  • لتطبيق قيمة سمة مخصّصة على مشاهدة صفحة في التطبيق يتم إرسالها من خلال القياس التلقائي للشاشة، اضبط القيمة أثناء طريقة viewDidAppear: لوحدة التحكّم في العرض. على سبيل المثال، قد يبدو ملف .m لوحدة التحكم في العرض على النحو التالي:
#import "myViewController.h"
#import "GAI.h"

@implementation myViewController

-(void)viewDidAppear
{
    id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];  // Get the tracker object.
    [tracker set:[GAIFields customDimensionForIndex:1]
           value:@"premium"];
    [super viewDidAppear:animated];   // Custom dimension value will be sent with the screen view.

}

// The remainder of the implementation is omitted.

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

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