הכלי 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. כך מפתחים שונים יכולים להתמקד בהגדרות התיוג ובפעולות האימות שלהם בלי להשפיע אחד על השני.
