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

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

סקירה

מאפיינים מותאמים אישית מאפשרים שיוך של מטא-נתונים להיטים, למשתמשים ולסשנים ב-Google Analytics, ואילו מדדים מותאמים אישית מאפשרים ליצור מדדים משלך ולצבור מדדים משלך ב-Google Analytics.

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

מאפיינים ומדדים מותאמים אישית מורכבים משני שדות:

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

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

// 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 Analytics. כתוצאה מכך, אפשר להגדיר ערך מותאם אישית של 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.

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