מאפיינים ומדדים מותאמים אישית – Android SDK v2 (מדור קודם)

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

סקירה

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

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

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

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

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

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

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

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

  • Integer אינדקס – האינדקס של ההגדרה של המאפיין המותאם אישית. האינדקס הזה מבוסס על אחד.
  • String ערך – הערך של המאפיין המותאם אישית.

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

כדי להגדיר ערך של מאפיין מותאם אישית, צריך לקרוא לפונקציה setCustomDimension לפני שליחת השיחה שאליה רוצים לשייך את הערך:

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Set the dimension value for index 1.
tracker.setCustomDimension(1, "myValue");

// Dimension value is associated and sent with this hit.
tracker.sendView();

למה כדאי להטמיע מעקב אחר אירועים?

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

היקפי ההרשאות ברמת המשתמש וברמת הסשן הם 'חממנים'

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

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

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

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

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

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

הגדרת ערכים עם מדידת מסך אוטומטית

כדי להחיל ערך של מאפיין מותאם אישית על צפייה במסך שנשלחת באמצעות מדידת המסך האוטומטית של EasyMonitor, יש להגדיר את הערך לפני הקריאה ל-activityStart() במהלך onStart().

שימו לב: במקרים שבהם הערך לא ידוע בזמן ההפעלה של onStart(), מומלץ להשתמש במקום זאת במדידת מסך ידנית.

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

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

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

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

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

  • Integer אינדקס – האינדקס של ההגדרה של המדד המותאם אישית.
  • Integer ערך – הערך של המדד המותאם אישית. הערכים יכולים להיות שליליים.

הגדרת ערך מותאם אישית

כדי להגדיר ערך של מדד מותאם אישית, צריך לבצע קריאה אל setCustomMetric לפני הפעלת שליחה אחרת:

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Increment the metric at index 1.
tracker.setCustomMetric(1, 1);

// Metric value sent with this hit.
tracker.sendView();

לחלופין, כדי להגדיר מדד מותאם אישית של מטבע:

// Get the tracker.
Tracker tracker = EasyTracker.getTracker();

// Create a map for hit params.
HashMap params = new HashMap();
params.put(ModelFields.APP_SCREEN, "Product Page");

// Set currency value to custom metric slot 1.
// Currency values may be fixed decimal.
params.put("&cm1", "24.99");

// Send the custom metric value with a screen view.
tracker.send("appview", params);

למה כדאי להטמיע מעקב אחר אירועים?

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

ערכים של מדדים מותאמים אישית נצברים בדוחות

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

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

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