פתרון בעיות

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

אין אירועים

אם האירועים לא מופיעים ב-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.

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

  חשוב לוודא שאתם משתמשים במזהה של אפליקציית Firebase. אפשר למצוא את הערך הזה במסוף Firebase בקטע Project Settings (הגדרות הפרויקט) > General (כללי) > Your Apps (האפליקציות שלך) > App ID (מזהה האפליקציה).

  הערך של firebase_app_id שונה מהערך של app_instance_id.

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

  חשוב לוודא שאתם משתמשים במזהה שספציפי להתקנה של אפליקציית Firebase. צריך לאחזר את הערך הזה באמצעות Google Analytics for Firebase SDK.

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

  הערך של app_instance_id שונה מהערך של firebase_app_id.

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

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

‫Google Analytics for Firebase SDK

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

• ‫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 ולא אל מאגר התגים.