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

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

نظرة عامة

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