בחירת הפלטפורמה:
ה-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:
const firebase_app_id = `X:XX:XX:XX`;
const api_secret = `<secret_value>`;
fetch(`https://www.google-analytics.com/debug/mp/collect?firebase_app_id=${firebase_app_id}&api_secret=${api_secret}`, {
method: "POST",
body: JSON.stringify({
app_instance_id: 'app_instance_id',
events: [{
// Event names must start with an alphabetic character.
name: '_badEventName',
params: {},
}]
})
});
תגובת אימות
זו התגובה של שרת האימות לאירוע הקודם:
{
"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 |
string | הנתיב לשדה שלא היה חוקי. |
description |
string | תיאור של השגיאה. |
validationCode |
ValidationCode | קוד אימות שתואם לשגיאה. |
ValidationCode
ערך | תיאור |
---|---|
VALUE_INVALID |
הערך שצוין ל-fieldPath לא היה חוקי. לעיון במגבלות.
|
VALUE_REQUIRED |
לא צוין ערך נדרש עבור fieldPath . |
NAME_INVALID |
השם שצוין לא חוקי. לעיון במגבלות. |
NAME_RESERVED |
השם שסופק היה אחד מהשמות השמורים. ראו שמות שמורים. |
VALUE_OUT_OF_BOUNDS |
הערך שצוין היה גדול מדי. לעיון במגבלות. |
EXCEEDED_MAX_ENTITIES |
הבקשה כללה יותר מדי פרמטרים. לעיון במגבלות. |
NAME_DUPLICATED |
אותו שם צוין יותר מפעם אחת בבקשה. |