מדריך ההעברה הזה מתאר מה חדש בגרסה 2 של ה-SDK, ומספק למפתחים טיפים למעבר מהטמעה של v1.x. מפתחים שלא צריכים לעבור מהטמעה של v1.x יכולים להתחיל עכשיו עם גרסה 2.
מבוא
Google Analytics פרסמה לאחרונה את הגרסה המעודכנת של ה-SDK של Google Analytics ל-Android גרסה 2. גרסה 2 של ה-SDK כוללת תמיכה בתכונות חדשות וממשק דיווח חדש שמותאם במיוחד למפתחי אפליקציות.
אנחנו ממליצים לכל המפתחים הקיימים של Google Analytics לעבור לגרסה 2 של Google Analytics SDK ל-Android כדי ליהנות מהתכונות ומהדוחות החדשים.
מה חדש בגרסה 2
גרסה 2 של Google Analytics SDK ל-Android כוללת חוויית דיווח חדשה שמיועדת למפתחי אפליקציות, מאפיינים ומדדים חדשים ויעילים ועוד. פירטנו כאן מה מפתחים מקבלים בגרסה 2:
- דוחות מתקדמים יותר למפתחי אפליקציות
- הדוחות הרגילים עוצבו מחדש עבור מפתחי אפליקציות, ונוספו דוחות חדשים כמו 'זרימת מעורבות' ו'מקורות Google Play' כדי לעזור למפתחים לקבל תובנות חדשות לגבי חווית המשתמשים וחוויית השימוש בה. לקבלת מידע נוסף על הדרכים המומלצות להגדרת הנכס לגרסה 2, אפשר לקרוא את השיטות המומלצות להגדרת חשבון.
- מאפיינים ומדדים חדשים באפליקציה
- מאפיינים ומדדים חדשים שהם ספציפיים לאפליקציה הושקו בגרסה 2 של ה-SDK, כולל שם המסך, צפיות במסך, שם האפליקציה, גרסת האפליקציה ועוד הרבה יותר.
- מדידת קריסות וחריגים
- Google Analytics SDK ל-Android כולל מדידת חריגות וסוג ההיט של החריגה. באמצעות מדידת חריגים, אפשר למדוד את המספר והסוג של קריסות ואת החריגים הלא קטלניים. למידע נוסף על הטמעה של מדידת חריגים, אפשר לעיין במדריך למפתחים של חריגים.
- מאפיינים ומדדים מותאמים אישית
- יוצרים מאפיינים מותאמים אישית כדי לפלח את הנתונים בדרכים חדשות. מידע נוסף על מאפיינים ומדדים מותאמים אישית
- מדידת אינטראקציות חברתיות
- מדידת האינטראקציות של המשתמשים עם ווידג'טים ויישומי פלאגין חברתיים מוטמעים יכול לספק תובנות חדשות לגבי הערך של הרשתות החברתיות באפליקציה שלך. למידע נוסף על מדידת אינטראקציות חברתיות.
לפני שתתחיל
כל המפתחים ירצו לבצע את שני השלבים האלה לפני תחילת ההעברה:
- הורד את ה-SDK של Google Analytics עבור Android גרסה 2
- יצירת תצוגה מפורטת של אפליקציה (פרופיל) שבה תשתמש כדי לגשת לדוחות ולנתונים החדשים של האפליקציה.
אחרי שמבצעים את השלבים שלמעלה, פועלים לפי השלבים הבאים לגבי נתיב ההעברה.
מעבר מ-EasyMonitor
יש שלושה שלבים שצריך לבצע כדי להעביר את האפליקציה מגרסה 1 לגרסה 2 של ספריית Easytracker:
- מעדכנים את הפרמטרים בקובץ המשאבים של GoogleAnalytics.xml
- עדכון שמות של שיטות
- עדכון של מקלט השידור (מעקב אחר קמפיינים ב-Google Play)
1. עדכון פרמטרים ב-GoogleAnalytics.xml
כאשר עוברים לגרסה 2, צריך לעדכן את הפרמטרים בקובץ המשאבים של GoogleAnalytics.xml, מאחר שחלק מהם השתנו מאז v1.x ופרמטרים חדשים נוספו בגרסה 2.
בטבלה הבאה מוצגים הפרמטרים שעודכנו בגרסה 2:
| שם הפרמטר v1.x | שם הפרמטר v2.x |
|---|---|
| ga_api_key | ga_trackingId |
| ga_auto_activity_tracking | ga_autoActivityTracking |
| ga_dryRun | הוצא משימוש |
למידע נוסף, ראו את הפרמטרים החדשים והמעודכנים של Easytracker.
2. עדכון שמות שיטות
למרות שחלק גדול מהתחביר נשאר זהה בגרסה 2 של EasyMonitor, יש כמה הבדלים חשובים בשמות השיטות ובתחביר שידרשו ממך לעדכן את היישום:
trackPageView()הואsendView()בגרסה 2. מידע נוסף זמין במדריך למפתחים בנושא מעקב אחר מסך- ההטמעה של מסחר אלקטרוני פשוטה יותר. איך מטמיעים מדידת מסחר אלקטרוני בגרסה 2.
- המשתנים המותאמים אישית הוחלפו במאפיינים ובמדדים מותאמים אישית. צריך לעדכן את כל השיחות אל
setCustomVar()כדי לנצל את התכונה החדשה. מידע נוסף על הטמעה של מאפיינים ומדדים מותאמים אישית
3. עדכון מקלט השידור (מעקב אחר קמפיינים ב-Google Play)
מפתחים שהטמיעו מעקב אחר קמפיינים ב-Google Play באמצעות v1.x שימו לב שנתיב המחלקה של המקבל השתנה. למידע נוסף, עיינו ב מדריך למעקב אחר קמפיינים ב-Google Play.
מעבר מהטמעה מותאמת אישית
אם לא השתמשתם בספריית Easytracker בגרסה v1.x של Analytics SDK ל-Android, מומלץ להתחיל להשתמש ב-Easytracker בגרסה 2.
ספריית Easytracker כלולה עכשיו ב-SDK והיא מומלצת לכל המפתחים. תחילת העבודה עם EasyMonitor בגרסה 2 של Google Analytics SDK.
אם יש לכם צרכים מתקדמים לאיסוף נתונים, למשל שימוש במספר מזהי נכסים בהטמעה יחידה, כדאי לקרוא את מדריך ההגדרה המתקדמת כדי לקבל מידע נוסף על השימוש בתכונות המתקדמות של ה-SDK.