פתרון בעיות

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

No events

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

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

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

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

• האם ה-api_secret עדיין תקף?

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

• האם ה-api_secret הועתק נכון?

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

• אין להשתמש באמצעי התשלום advertising_id.

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

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

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