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