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

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

نظرة عامة

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

هناك خطوتان أساسيتان لتنفيذ سمة مخصّصة أو مقياس مخصّصَين:

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

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

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

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

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

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

  • NSNumber الفهرس: فهرس تعريف السمة المخصّصة. يعتمد هذا الفهرس على الرقم 1.
  • NSString القيمة – قيمة السمة المخصّصة.

إعداد قيمة بُعد مخصّص

لضبط قيمة سمة مخصّصة، عليك استدعاء setCustom:dimension: قبل استدعاء الإرسال الذي تريد ربط القيمة به:

// Get the tracker object.
id tracker = [[GAI sharedInstance].defaultTracker;

// Set the dimension value for index 1.
[tracker setCustom:1
         dimension:@"myValue"];

// Dimension value is associated and sent with this hit.
[tracker sendView:screenName];

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

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

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

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

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

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

سيستمر تطبيق قيم السمات المخصصة على مستوى المستخدم أو الجلسة على جميع النتائج في الجلسة الحالية و/أو الجلسات المستقبلية حتى إذا تمت تصفية النتيجة التي تم إرسالها معها من ملف شخصي.

عند الفلترة حسب قيمة بُعد مخصّص، تتم فلترة النتائج وفقًا لنطاق قيمة البُعد المخصّص تلك.

اطّلِع على مزيد من المعلومات عن كيفية تفاعل الفلاتر وقيم السمات المخصّصة عند معالجة بياناتك.

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

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

#import "myViewController.h"
#import "GAI.h"

@implementation myViewController

-(void)viewDidAppear
{
    id tracker = [[GAI sharedInstance].defaultTracker;  // Get the tracker object.
    [tracker setCustom:1
             dimension:@"myValue"];  // Set the custom dimension value.
    [super viewDidAppear:animated]   // Custom dimension value will be sent with the screen view.

}

// The remainder of the implementation is omitted.

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

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

المقاييس المخصّصة

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

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

  • NSInteger الفهرس: فهرس تعريف المقياس المخصّص.
  • NSNumber القيمة – قيمة المقياس المخصّص. قد تكون القيم سالبة.

ضبط قيمة مقياس مخصّص

لضبط قيمة مقياس مخصّص، عليك استدعاء setCustom:metric: قبل مكالمة إرسال أخرى:

// Get the tracker object.
id tracker = [GAI sharedInstance].defaultTracker;

// Increment the metric at index 1.
[tracker setCustom:1
            metric:[NSNumber numberWithLongLong:1]];

// Metric value sent with this hit.
[tracker sendView:screenName];

أو لضبط مقياس مخصّص للعملة:

// Get the tracker.
id tracker = [GAI sharedInstance].defaultTracker;

// Create a dictionary for hit params.
NSDictionary *params = [[NSDictionary alloc] initWithObjectsAndKeys:
    @"Product Page", @"&cd",
   // Set currency value to custom metric slot 1.
   // Currency values may be fixed decimal.
    @"24.99", @"&cm1", nil];

// Send the custom metric value with a screen view.
[tracker send:@"appview"
       params:params];

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

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

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

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

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

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