אימות אירועים

בחירת הפלטפורמה:

ה-Google Analytics Measurement Protocol ל-Google Analytics 4 לא מחזיר קודי שגיאה של HTTP, גם אם האירוע שגוי או שחסרים בו פרמטרים נדרשים. כדי לוודא שהאירועים תקפים, יש לבדוק אותם מול שרת האימות של Measurement Protocol לפני הפריסה שלהם לסביבת הייצור. אחרי שמוודאים שהאירועים מובְנים בצורה תקינה, צריך לאמת את ההטמעה כדי לוודא שאתם משתמשים במפתחות הנכונים.

אפשר להפעיל את שרת האימות ישירות או להשתמש בכלי ליצירת אירועים של GA4. הכלי ליצירת אירועים של GA4 מאפשר ליצור אירועים אינטראקטיביים, ולהשתמש בשרת האימות של Measurement Protocol כדי לאמת אותם.

במדריך הזה נסביר איך לשלוח אירועים ל-Measurement Protocol עבור שרת התיקוף של Google Analytics 4 ולפרש את התגובה.

שליחת אירועים לאימות

ההבדל היחיד בין בקשות לאירועים שנשלחים ל-Measurement Protocol לבין שרת האימות של Measurement Protocol הוא כתובת ה-URL.

שרת כתובת URL
Measurement Protocol /mp/collect
שרת אימות של Measurement Protocol /debug/mp/collect

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

הקוד הבא מציג אירוע לא חוקי שנשלח לשרת האימות של Measurement Protocol:

תגובת אימות

זו התגובה של שרת האימות לאירוע הקודם:

{
  "validationMessages": [
    {
      "fieldPath": "events",
      "description": "Event at index: [0] has invalid name [_badEventName]. Names must start with an alphabetic character.",
      "validationCode": "NAME_INVALID"
    }
  ]
}

תשובה

מפתח סוג תיאור
validationMessages Array<ValidationMessage> מערך של הודעות אימות.

ValidationMessage

מפתח סוג תיאור
fieldPath מחרוזת הנתיב לשדה שלא היה חוקי.
description מחרוזת תיאור של השגיאה.
validationCode ValidationCode קוד אימות שתואם לשגיאה.

ValidationCode

תמורה לכסף תיאור
VALUE_INVALID הערך שצוין ל-fieldPath לא היה חוקי. לעיון במגבלות.
VALUE_REQUIRED לא צוין ערך נדרש עבור fieldPath.
NAME_INVALID השם שצוין לא חוקי. לעיון במגבלות.
NAME_RESERVED השם שסופק היה אחד מהשמות השמורים. ראו שמות שמורים.
VALUE_OUT_OF_BOUNDS הערך שצוין היה גדול מדי. לעיון במגבלות.
EXCEEDED_MAX_ENTITIES הבקשה כללה יותר מדי פרמטרים. לעיון במגבלות.
NAME_DUPLICATED אותו שם צוין יותר מפעם אחת בבקשה.