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

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

סקירה

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

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

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

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

הגדרה ושליחה של ערכים

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

// May return null if EasyTracker has not yet been initialized with a
// property ID.
EasyTracker easyTracker = EasyTracker.getInstance();

// 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.
easyTracker.send(MapBuilder
    .createAppView("Home screen")
    .set(Fields.customDimension(1), "premiumUser");
    .build()
);

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

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

// May return null if EasyTracker has not yet been initialized with a
// property ID.
EasyTracker easyTracker = EasyTracker.getInstance();


// Set the custom metric to be incremented by 5 using its index.
easyTracker.set(Fields.customMetric(1), 5);


// Custom metric value sent is with this screen view.
easyTracker.send(MapBuilder
    .createAppView("Home screen")
    .build()
);

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

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

שיקולים בנוגע למאפיינים מותאמים אישית

ערכים עם היקפים ברמת המשתמש וברמת הסשן חלים על היטים קודמים

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

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

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

שיקולים לשימוש במדדים מותאמים אישית

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

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

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

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

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

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

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