מאפיינים ומדדים מותאמים אישית – iOS SDK

מדריך למפתחים זה מתאר כיצד ליישם מאפיינים וערכים מותאמים אישית באמצעות ה-SDK של Google Analytics עבור iOS v2.

סקירה

כאשר אתה מגדיר ערך של מאפיין או ערך מותאם אישית באמצעות Google Analytics SDK עבור iOS, הערך נשלח כפרמטר עם ההתאמה הבאה שנשלחת. ניתן להחיל את הערכים האלה על כל סוג התאמה של Google Analytics, כולל צפיות במסך, אירועים, עסקאות במסחר אלקטרוני, תזמוני משתמשים ואינטראקציות חברתיות.

יש שני שלבים עיקריים להטמעת מדד או מאפיין מותאם אישית:

  1. מגדירים את המאפיין או המדד המותאם אישית באמצעות ממשק האינטרנט של Google Analytics.
    מגדירים את האינדקס, השם וההיקף של המאפיין או המדד המותאם אישית בקטע של הגדרות הנכס בממשק האינטרנט.
    מידע נוסף על הגדרת מאפיין או מדד מותאם אישית
  2. מטמיעים קוד כדי להגדיר ולאסוף ערכים של מאפיינים ומדדים מותאמים אישית.
    מוסיפים קוד לאפליקציה כדי להגדיר ערכים של מאפיינים או מדדים מותאמים אישית להיטים של Google Analytics לפי האינדקסים שהגדרתם בשלב הקודם.

בהמשך המאמר הזה נתאר כיצד ליישם את הקוד כדי להגדיר ולשלוח ערכים של מאפיינים או מדדים מותאמים אישית אל Google Analytics.

מאפיינים מותאמים אישית

ניתן להגדיר ערכים של מאפיינים מותאמים אישית בכל סוגי ההיטים ב-Google Analytics. מגדירים ערך של מאפיין מותאם אישית ממש לפני קריאת השליחה שעליה רוצים להחיל את הערך.

ההיקף המוגדר של המאפיין המותאם אישית יקבע בזמן העיבוד אילו היטים נוספים עשויים להיות משויכים לערך הזה.

השדות הבאים נדרשים כדי להגדיר ערך למאפיין מותאם אישית:

  • NSNumber אינדקס – האינדקס של ההגדרה של המאפיין המותאם אישית. האינדקס הזה מבוסס על אחד.
  • 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.

אין לשלוח פרטים אישיים מזהים (PII) כערכים

התנאים וההגבלות של Google Analytics אוסרים על שליחת פרטים אישיים מזהים (PII) לשרתים של Google Analytics. למידע נוסף, עיינו בתנאים ובהגבלות.

מדדים מותאמים אישית

אמנם צריך להחיל בקפידה מאפיינים מותאמים אישית על התאמות ספציפיות ולנהל אותם באמצעות היקף, אבל ההתאמה שעליה חל מדד מותאם אישית בדרך כלל לא תשפיע על הדיווח, ולכן ניתן להגדיר אותם בכל פעם שהערך של המדד ידוע.

השדות הבאים נדרשים כדי להגדיר ערך של מדד מותאם אישית:

  • 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 Analytics. כתוצאה מכך, עליך להגדיר ערך מותאם אישית של 1 כדי להגדיל את הסכום המצטבר של המדד בדוחות.

מדדים מותאמים אישית ומסנני תצוגה (פרופיל)

למרות שבאופן כללי אפשר להגדיר את הערכים של מדדים מותאמים אישית מתי שנוח לכם, תוכלו להימנע מהגדרת ערכים של מדדים מותאמים אישית בהתאמות שככל הנראה יסוננו מהתצוגות (פרופילים) שלכם. אם התאמה מסוננת על ידי מסנן של תצוגה (פרופיל), כל הערכים של הערכים המותאמים אישית המשויכים יסוננו גם הם. למידע נוסף על מאפיינים ומדדים מותאמים אישית ומסנני תצוגה (פרופיל).