בוחרים את הפלטפורמה:
פרוטוקול 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 |
צוין אותו שם יותר מפעם אחת בבקשה. |