במדריך הזה מפורטים שלבים נפוצים לפתרון בעיות כדי לתקן שגיאות נפוצות בהטמעה.
אין אירועים
אם האירועים לא מופיעים ב-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:
אין להשתמש באפשרויות הבאות:
firebase_instance_id
– אין לכלול את המזהה הזה בבקשה. המזהה הזה משמש לזיהוי מופע מסוים של האפליקציה, אבל הוא ספציפי ל-Firebase. הוא משמש למשימות כמו שליחת הודעות FCM.
gtag.js
אם אתם משתמשים ב-gtag.js, המזהים שבהם צריך להשתמש הם:
measurement_id
– צריך לכלול את המזהה הזה בפרמטרים של השאילתה לבקשה. המזהה הזה משמש לזיהוי ייחודי של מקור נתונים. לכל המשתמשים באתר יהיה אותוmeasurement_id
. המזהה מופיע בממשק המשתמש של Google Analytics בקטע:
ניהול > מקורות נתונים > בחירת מקור הנתונים > מזהה מדידהclient_id
– צריך לכלול את המזהה הזה בגוף הבקשה ב-POST. המזהה הזה מזהה באופן ייחודי מופע משתמש נתון של לקוח אינטרנט. הערך הזה יהיה שונה לכל משתמש באפליקציה. בדוגמאות האלה מוסבר איך לאחזר את הערך הזה.