הכלי DebugView מאפשר לכם לראות את נתוני האירועים הגולמיים שתועדו על ידי האפליקציה במכשירי הפיתוח, כמעט בזמן אמת. המידע הזה שימושי מאוד למטרות אימות במהלך שלב ההטמעה של הפיתוח, ויכול לעזור לכם לגלות שגיאות וטעויות בהטמעה של Analytics ולוודא שכל האירועים ומאפייני המשתמשים מתועדים בצורה נכונה.
הפעלה של מצב ניפוי באגים
באופן כללי, אירועים שמתועדים באפליקציה נאספים יחד במשך כשעה ומועלים יחד. הגישה הזו חוסכת את הסוללה במכשירים של משתמשי הקצה ומפחיתה את השימוש בנתוני הרשת. עם זאת, כדי לאמת את ההטמעה של Analytics (ולראות את Analytics בדוח DebugView), אתם יכולים להפעיל את מצב ניפוי הבאגים במכשיר הפיתוח כדי להעלות אירועים בעיכוב מינימלי.
iOS+
כדי להפעיל את מצב ניפוי הבאגים של Analytics במכשיר הפיתוח, מציינים את הארגומנט הבא בשורת הפקודה ב-Xcode:
-FIRDebugEnabled
ההתנהגות הזו נמשכת עד שמשביתים באופן מפורש את מצב ניפוי הבאגים. לשם כך, מציינים את הארגומנט הבא בשורת הפקודה:
-FIRDebugDisabled
כדי להוסיף את הארגומנטים האלה, עורכים את הסכימה של הפרויקט ומוסיפים רשומה חדשה ל-Arguments Passed On Launch (ארגומנטים שהועברו בהפעלה).
Android
כדי להפעיל את מצב ניפוי הבאגים של Analytics במכשיר Android, מריצים את הפקודות הבאות:
adb shell setprop debug.firebase.analytics.app PACKAGE_NAME
ההתנהגות הזו נמשכת עד שמשביתים באופן מפורש את מצב ניפוי הבאגים. לשם כך, מריצים את הפקודה הבאה:
adb shell setprop debug.firebase.analytics.app .none.
אינטרנט
כדי להפעיל את מצב ניפוי הבאגים של Analytics בדפדפן, מתקינים את התוסף Google Analytics Debugger ל-Chrome.
אחרי ההתקנה צריך להפעיל את התוסף ולרענן את הדף. מאותו רגע, התוסף יתעד אירועים באפליקציה במצב ניפוי באגים.
אפשר לראות אירועים שתועדו ב-DebugView במסוף Firebase.
צפייה ב-error אירועים
בדוח DebugView מופיעים גם אירועי error שנרשמים באופן אוטומטי (שמציינים בעיות ברישום של אירועים או מאפייני משתמשים) וגם אירועים אחרים שכוללים פרמטר firebase_error.
שימו לב: אירועי error מופיעים ישירות בסטרימינג, אבל באירועים אחרים שכוללים פרמטר firebase_error, לא מוצג ב-DebugView אינדיקטור שגיאה מיוחד בסטרימינג הראשי של האירועים. כדי לראות את הפרמטר firebase_error ברשימת הפרמטרים, צריך ללחוץ על האירוע.
כדי לנפות באגים בשגיאות בהטמעה של Analytics, כדאי לבדוק את יומני המסוף של המכשיר ולחפש הודעות מ-Firebase Analytics SDK. לעיתים קרובות ההודעות האלה מספקות פרטים על הסיבה לדחייה של אירוע או פרמטר.
דיווח על נתוני אירועים
מוודאים שהפעלתם את מצב ניפוי הבאגים במכשירי הפיתוח, כפי שמתואר בקטע הקודם במדריך הזה.
במסוף Firebase, עוברים אל Analytics > DebugView.
מתחילים לבצע פעולות באפליקציה כדי לראות את האירועים באפליקציה מתועדים בדוח DebugView במסוף Firebase.
במקור הנתונים "שניות" (העמודה המרכזית) מוצגים האירועים שתועדו ב-60 השניות האחרונות. במקור הנתונים "דקות" (העמודה הימנית) מוצגת סדרת ארכיונים של אירועים שהתרחשו ב-30 הדקות האחרונות. בעמודה השמאלית מוצגים האירועים המובילים שתועדו במהלך 30 הדקות האלה, וגם מאפייני המשתמשים הנוכחיים של מכשיר הפיתוח שנבחר.
מקור הנתונים 'שניות'
כברירת מחדל, מוצגת רשימת אירועים שנרשמו ב-60 השניות האחרונות. בכל אירוע מוצגת חותמת זמן שתואמת לשעת הרישום במכשיר הפיתוח. אפשר ללחוץ על אירוע כדי לראות רשימה של הפרמטרים שמשויכים לאירוע הזה.
כשערכים של מאפייני משתמשים ישתנו במהלך השימוש באפליקציה, תופיע רשומה של השינוי הזה.
רצף הדקות
במקור הנתונים הזה מוצגת סדרה של עיגולים, שכל אחד מהם מייצג דקה אחת מתוך 30 הדקות האחרונות. המספר בעיגול מציין את מספר האירועים שהתקבלו בדקה הזו. לחיצה על אחד מהעיגולים תציג ברצף השניות את האירועים שנרשמו באותה דקה. כך אפשר לבחון בפירוט את האירועים שנרשמו ב-30 הדקות האחרונות.
אירועים מובילים ומאפייני משתמש נוכחי
הטבלה "אירועים מובילים" מציגה את האירועים המובילים שתועדו במהלך 30 הדקות האלה. בטבלה "מאפייני המשתמשים הנוכחיים" מוצגת תמונת המצב העדכנית של קבוצת מאפייני המשתמשים בשביל מכשיר הפיתוח שנבחר.
בורר מכשירים
מכיוון שאפשר להפעיל את מצב ניפוי הבאגים בהרבה מכשירי פיתוח שונים, אתם יכולים להשתמש בבורר המכשירים כדי לבחור את המכשיר הספציפי שבו יתמקד דוח DebugView. כך מפתחים שונים יכולים להתמקד בהגדרות התיוג ובפעולות האימות שלהם בלי להשפיע אחד על השני.
