במדריך הזה מוסבר איך לשלוח אירועים של מקורות נתונים מאתרים ומאפליקציות ב-Google Analytics Measurement Protocol לשרת של Google Analytics, כדי שתוכלו לצפות באירועי Measurement Protocol בדוחות ב-Google Analytics.
מומלץ לבחור את הפלטפורמה שאותה אתם רוצים לראות במדריך הזה:
עיצוב הבקשה
Measurement Protocol ל-Google Analytics 4 תומך רק בבקשות POST מסוג HTTP.
כדי לשלוח אירוע, צריך להשתמש בפורמט הבא:
POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>
עליכם לכלול את הפרטים הבאים בכתובת ה-URL של הבקשה:
api_secret: ה-API SECRET שנוצר בממשק המשתמש של Google Analytics.כדי ליצור סוד חדש, עוברים לקטע ניהול > מקורות נתונים > בוחרים את מקור הנתונים > Measurement Protocol > יצירה.
measurement_id: מזהה המדידה שמשויך למקור נתונים. המזהה מופיע בממשק המשתמש של Google Analytics בקטע ניהול > מקורות נתונים > בוחרים את מקור הנתונים > מזהה המדידה.measurement_idהוא לא מזהה מקור הנתונים שלכם.
לעיון המלא, ראו פרמטרים של שאילתה.
עליכם לכלול את הפרטים הבאים בגוף הבקשה:
client_id: מזהה ייחודי של לקוח. היא שונה מ-app_instance_idשל Firebase. משתמשים ב-gtag.js('get').
user_id: אופציונלי. מזהה ייחודי של המשתמש. יכול להכיל רק תווי utf-8. למידע נוסף על המזהה הזה, ראו User-ID לניתוח בפלטפורמות שונות.
consent: אופציונלי. איך קובעים את הגדרות ההסכמהevents: מערך פריטים באירועים. אפשר לכלול מספר אירועים בבקשה אחת.כדי שפעילות המשתמשים תופיע בדוחות כמו זמן אמת, צריך לציין את
engagement_time_msecואתsession_idכחלק מה-paramsשלevent. הפרמטרengagement_time_msecצריך לשקף את משך ההתעניינות של האירוע באלפיות השנייה.לדוגמה:
{
"client_id": "123456.7654321",
"events": [
{
"name": "campaign_details",
"params": {
"campaign_id": "google_1234",
"campaign": "Summer_fun",
"source": "google",
"medium": "cpc",
"term": "summer+travel",
"content": "logolink",
"session_id": "123",
"engagement_time_msec": "100"
}
}
]
}
session_start הוא שם אירוע שמור, אבל יצירה של session_id חדש יוצרת סשן חדש בלי שיהיה צורך לשלוח את
session_start. איך הסשנים נספרים.
אני רוצה לנסות
דוגמה לשליחת אירוע tutorial_begin לשרת Google Analytics:
const measurement_id = `G-XXXXXXXXXX`;
const api_secret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurement_id}&api_secret=${api_secret}`, {
method: "POST",
body: JSON.stringify({
client_id: 'XXXXXXXXXX.YYYYYYYYYY',
events: [{
name: 'tutorial_begin',
params: {},
}]
})
});
מגבלות
המגבלות הבאות חלות על שליחת אירועי Measurement Protocol ל-Google Analytics:
- הבקשות יכולות לכלול 25 אירועים לכל היותר.
- מותר לכלול באירועים עד 25 פרמטרים.
- מותר לכלול באירועים עד 25 מאפייני משתמשים.
- שמות של מאפייני משתמשים צריכים להיות באורך של עד 24 תווים.
- ערכים של מאפייני משתמשים צריכים להיות באורך של עד 36 תווים.
- שמות של אירועים צריכים להיות באורך של עד 40 תווים, יכולים לכלול רק תווים אלפאנומריים וקווים תחתונים והם חייבים להתחיל בתו אלפביתי.
- שמות של פרמטרים שכוללים פרמטרים של פריטים צריכים להיות באורך של עד 40 תווים, יכולים לכלול רק תווים אלפאנומריים וקווים תחתונים והם חייבים להתחיל בתו אלפביתי.
- ערכי פרמטרים שכוללים ערכי פרמטרים של פריטים צריכים להיות באורך של 100 תווים או פחות בנכס Google Analytics 4 רגיל, ו-500 תווים או פחות בנכס Google Analytics 360.
- פרמטרים של פריטים יכולים לכלול עד 10 פרמטרים מותאמים אישית.
- גוף הפוסט חייב להיות קטן מ-130kB.
- יש תמיכה בשיוך ברמת האירוע מאירועי Measurement Protocol עד 63 ימים אחרי האירוע האחרון של תיוג ההמרות אונליין שמשמש לייצוא אל Google Ads ושילובי מדיה אחרים, גם אם חלון ההמרות של אירוע ההמרה גדול מ-63 ימים. לעומת זאת, בשיוך ברמת האירוע לצורך תיוג אירועים אונליין יש תמיכה בכל חלון ההמרות.
- למטרות רימרקטינג, אפשר להצטרף לאירועי Measurement Protocol עד מספר הימים הבא אחרי האירוע האחרון באינטרנט, עם קובץ Cookie או מזהה מכשיר שמשויכים לקובץ:
- מקור נתוני אתר: 30 ימים
- מקור נתוני אפליקציה: 42 ימים
- אירועי Measurement Protocol באפליקציה שנשלחים ל-Google Analytics 4 לא מאכלסים קהלים ברשת החיפוש ב-Google Ads עבור משתמשי אפליקציה.