בוחרים את הפלטפורמה:
Measurement Protocol של Google Analytics לא מחזיר קודי שגיאה HTTP
, גם אם האירוע מוגדר בצורה שגויה או שחסרים בו פרמטרים נדרשים. כדי לוודא שהאירועים תקינים, אתם צריכים לבדוק אותם מול שרת האימות של Measurement Protocol לפני שתפרסו אותם בסביבת הייצור.
אחרי שמוודאים שהמבנה של האירועים תקין, צריך לאמת את ההטמעה כדי לוודא שמשתמשים במפתחות הנכונים.
אפשר להפעיל את שרת האימות ישירות, או להשתמש בכלי ליצירת אירועים של Google Analytics. הכלי ליצירת אירועים ב-Google Analytics מאפשר ליצור אירועים באופן אינטראקטיבי, והוא משתמש בשרת האימות של 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": []
}
תשובה
מפתח | סוג | תיאור |
---|---|---|
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 |
אותו שם צוין יותר מפעם אחת בבקשה. |