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

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

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