المكوّنات والمقاييس المخصّصة، المقاييس - حزمة تطوير البرامج (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 لزيادة إجمالي المقياس/المقياس في تقاريرك.

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

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