פתרון בעיות

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

אין אירועים

אם האירועים לא מופיעים ב-Google Analytics, יש כמה בעיות נפוצות שכדאי לבדוק.

קודם צריך לבחור את הלקוח:

• האם השתמשת ב-api_secret הנכון?

  ודאו שאתם משתמשים ב-api_secret לשידור הנכון. אם מגדירים את פרוטוקול המדידה למספר מקורות נתונים, לכל מקור נתונים יהיה סוד משלו.

• האם המפתח api_secret עדיין תקף?

  כדי לעזור במאבק בספאם, אתם יכולים לבטל api_secret. חשוב לוודא שה-api_secret שבו אתם משתמשים עדיין תקף. ייתכן שמשתמש אחר שיש לו גישה לשידור שלכם ביטל בטעות את הגישה אליו.

• האם השדה api_secret הועתק בצורה נכונה?

  השדה api_secret הוא תלוי אותיות רישיות. מוודאים שהקוד של api_secret בממשק המשתמש של Google Analytics זהה בדיוק לקוד שבו אתם משתמשים.

• אין להשתמש ב-advertising_id.

  המאפיין advertising_id לא נתמך כמזהה מכשיר תקין. אם משתמשים ב-Firebase, צריך להשתמש ב-app_instance_id. אם משתמשים ב-gtag.js, צריך להשתמש ב-client_id.

מזהים לא חוקיים

מאחר ש-Measurement Protocol תומך במזהים מ-Google Analytics for Firebase SDK ומ-gtag.js, חשוב לוודא שאתם משתמשים במזהה הנכון. המזהים שבהם צריך להשתמש משתנים בהתאם לשימוש ב-SDK של Google Analytics for Firebase או ב-gtag.js. בהמשך מפורטים המזהים שבהם כדאי להשתמש:

Google Analytics for Firebase SDK

אם אתם משתמשים ב-SDK של Google Analytics for Firebase, אלה המזהים שצריך להשתמש בהם:

• firebase_app_id – צריך לכלול את המזהה הזה בפרמטרים של השאילתה לבקשה. המזהה הזה מזהה באופן ייחודי את אפליקציית Firebase שלכם. לכל המשתמשים באפליקציה יהיה אותו firebase_app_id. נמצאים במסוף Firebase בקטע:
  הגדרות הפרויקט > כללי > האפליקציות שלך > מזהה האפליקציה

• app_instance_id – צריך לכלול את המזהה הזה בגוף הבקשה ב-POST. המזהה הייחודי של אפליקציה ב-Firebase משמש לזיהוי ייחודי של כל התקנה של האפליקציה. הערך הזה ישתנה לכל התקנה של האפליקציה. כך תוכלו לבקש את הערך הזה בכל פלטפורמת Firebase:

  • Android – getAppInstanceId()‎
  • Kotlin – getAppInstanceId()
  • Swift –‏ appInstanceID()‎
  • Objective-C – appInstanceID
  • C++ – GetAnalyticsInstanceId()
  • Unity – GetAnalyticsInstanceIdAsync()

אין להשתמש באפשרויות הבאות:

• firebase_instance_id – אין לכלול את המזהה הזה בבקשה. המזהה הזה משמש לזיהוי מופע מסוים של האפליקציה, אבל הוא ספציפי ל-Firebase. הוא משמש למשימות כמו שליחת הודעות FCM.

gtag.js

אם אתם משתמשים ב-gtag.js, המזהים שבהם צריך להשתמש הם:

• measurement_id – צריך לכלול את המזהה הזה בפרמטרים של השאילתה לבקשה. המזהה הזה משמש לזיהוי ייחודי של מקור נתונים. לכל המשתמשים באתר יהיה אותו measurement_id. המזהה מופיע בממשק המשתמש של Google Analytics בקטע:
  ניהול > מקורות נתונים > בחירת מקור הנתונים > מזהה מדידה
• client_id – צריך לכלול את המזהה הזה בגוף הבקשה ב-POST. המזהה הזה מזהה באופן ייחודי מופע משתמש נתון של לקוח אינטרנט. הערך הזה יהיה שונה לכל משתמש באפליקציה. בדוגמאות האלה מוסבר איך לאחזר את הערך הזה.