פתרון בעיות

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

אין אירועים

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

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

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

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

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

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

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

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

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

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

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

מאחר ש-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 בקטע:
  Project Settings (הגדרות הפרויקט) > General (כללי) > Your Apps (האפליקציות שלך) > App ID (מזהה האפליקציה).

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

חסרים אירועים של תיוג בצד השרת

התקנה של Tag Manager בצד השרת עם לקוח Measurement Protocol מאפשרת לשלוח אירועים בפורמט של Measurement Protocol למאגר תגים. לאחר מכן, המאגר שולח את האירועים האלה ל-Google Analytics באמצעות אותו מנגנון שבו נשלחים כל שאר האירועים של SGTM.

אם רוצים ליהנות מכל התכונות של Measurement Protocol, צריך לשלוח אירועים ישירות ל-Measurement Protocol במקום למאגר.