פלטפורמת Google Analytics Measurement Protocol מאפשרת לכם לשלוח נתונים ממקורות אופליין למקור לנתוני אתר או למקור לנתוני אפליקציה, בנוסף לנתונים שכבר נאספים באמצעות תיוג או Firebase SDK.
במדריך הזה מתוארים תרחישי שימוש נפוצים ב-Measurement Protocol של Google Analytics והדרישות שלהם.
סיכום הדרישות
בטבלה הזו מפורטות בקצרה הדרישות לגבי כל תרחיש שימוש. כדאי לזכור את השיטות המומלצות הבאות:
ערך ברירת המחדל שמוגדר לפרמטר
timestamp_microsשל האירועים ומאפייני המשתמשים הוא מועד הבקשה. כששולחים שינוי באירוע או במאפיין משתמש שהתרחש בעבר, צריך להחליף את חותמת הזמן כמו שמתואר במדריכים בנושאי שליחת אירועים ומאפייני משתמשים.כדי לקבל דוחות 'פעילות בזמן אמת' ומדדי התעניינות מדויקים, צריך לכלול פרמטר אירוע
engagement_time_msecשמוגדר לאלפיות השנייה שעברו מאז האירוע הקודם.
| תרחיש שימוש | מזהה הסשן | דרישה לגבי מועד הבקשה | דרישת timestamp_micros |
|---|---|---|---|
| הקצאת User-ID לאירועים | חובה | <= סוף יום העסקים שבו הסשן התחיל | >= התחלת הסשן וגם <= סוף הסשן |
| שיוך (Attribution) הסשן | חובה | <= התחלת הסשן + 24 שעות | >= התחלת הסשן וגם <= סוף הסשן |
| ייצוא אירועים לפלטפורמות הפרסום | לא נדרש | <= היום של הסשן האחרון + 63 ימים | >= מועד הבקשה פחות 72 שעות וגם <= מועד הבקשה |
| שליחת אירועים או מאפייני משתמשים כדי ליצור קהלים | לא נדרש | אתר: <= מועד האירוע האחרון אונליין + 30 ימים אפליקציה: <= מועד האירוע האחרון אונליין + 42 ימים |
>= מועד הבקשה פחות 72 שעות וגם <= מועד הבקשה |
הקצאת User-ID לאירועים
משתמשים ב-Measurement Protocol כדי לספק מזהה משתמש לאירועים אונליין או אופליין.
הנה כמה תרחישי שימוש לדוגמה להוספת User-ID לאירוע:
למדידה שלכם אונליין חסר המידע הדרוש כדי לחפש את מזהה המשתמש לאירועים אונליין, אבל יש לכם צינור לעיבוד אירועים שיכול ליצור את הקשר בין סשן אונליין לבין מזהה משתמש.
בתרחיש הזה, אתם משתמשים ב-Measurement Protocol כדי לספק אירועים אונליין עם User-ID.
אין לכם User-ID לאירועים שאתם שולחים באמצעות Measurement Protocol, אבל אתם רוצים שהאירועים האלה ישויכו ל-User-ID אם המשתמש התחבר לחשבון באינטרנט במהלך הסשן.
בתרחיש הזה, אתם משתמשים באירועים אונליין כדי לספק אירועים של Measurement Protocol עם מזהה משתמש.
אלה הדרישות להוספת User-ID לאירוע:
- כוללים את הפרמטר
session_idברשימת הפרמטרים של האירוע. - שולחים את האירועים של Measurement Protocol באותו יום עסקים שבו התקיים הסשן אונליין.
- אם אתם מבטלים את ברירת המחדל של
timestamp_micros, צריך להגדיר אותו כחותמת זמן בין שעת ההתחלה לשעת הסיום של הסשן אונליין. - אם המטרה שלכם היא לספק User-ID לאירועים אונליין, צריך להגדיר את
user_idבבקשה. - אם המטרה שלכם היא שלכל אירוע Measurement Protocol יהיה מזהה משתמש מהסשן התואם אונליין, אתם לא צריכים להגדיר את
user_id.
שיוך (Attribution) הסשן
אירועי Measurement Protocol שעומדים בדרישות ספציפיות מופיעים בדוחות עם אותם מאפייני סשן (כמו מידע גיאוגרפי, מקור, אמצעי הגעה וקמפיין) כמו אירועים אונליין מאותו סשן.
אלה הדרישות לשיוך סשנים:
- כוללים את
session_idברשימת הפרמטרים של האירוע. הבקשה צריכה להישלח תוך 24 שעות ממועד תחילת הפגישה באינטרנט.
לדוגמה, אם הסשן התחיל ב-11:15 בבוקר ביום שני באזור הזמן של הנכס, צריך לשלוח את הבקשה לפני 11:15 בבוקר ביום שלישי.
אם אתם מבטלים את ברירת המחדל של
timestamp_micros, צריך להגדיר אותו כחותמת זמן בין שעת ההתחלה לשעת הסיום של הסשן אונליין.
ייצוא אירועים לפלטפורמות הפרסום
מערכת Google Analytics כוללת את האירועים שאתם שולחים באמצעות Measurement Protocol בייצוא למוצרי פרסום מקושרים כמו Google Ads או Campaign Manager 360.
הנה כמה תרחישים נפוצים שבהם התכונה הזו שימושית:
- לעסק שלכם יש אירועים אופליין שאתם רוצים לכלול בשיוך (Attribution) ובדיווח של פרסום.
- יש לכם אירועים נוספים במערכת שלא זמינה לתיוג או ל-Firebase SDK, אבל אתם עדיין רוצים לכלול את האירועים האלה במוצרים מקושרים.
אלה הדרישות לייצוא אירועים לפלטפורמות פרסום:
שולחים את הבקשה תוך 63 ימים ממועד האירוע האחרון אונליין, גם אם חלון השיוך של האירוע המרכזי ארוך מ-63 ימים. האירוע צריך להתרחש גם בתוך חלון השיוך של האירוע המרכזי. איך מגדירים את חלון השיוך
לדוגמה, אם האירוע האחרון אונליין של
client_idאוapp_instance_idהתרחש ב-1 במרץ, צריך לשלוח את האירוע של Measurement Protocol עד 3 במאי.אם משנים את הערך של
timestamp_micros, צריך להגדיר אותו לחותמת זמן מ-72 השעות האחרונות.
שליחת אירועים או מאפייני משתמשים כדי ליצור קהלים
אירועים ומאפייני משתמשים שנשלחים באמצעות Measurement Protocol נכללים בהערכה של תנאי קהל אם עומדים בכמה דרישות.
אלה הדרישות לשליחת אירועים או מאפייני משתמשים לצורך יצירת קהלים:
שולחים את הבקשה למקור לנתוני האתר תוך 30 ימים ממועד האירוע האחרון אונליין עבור אותו
client_id.לדוגמה, אם האירוע האחרון באינטרנט של
client_idהתרחש ב-1 במרץ, צריך לשלוח את האירוע של Measurement Protocol עד 31 במרץ.צריך לשלוח את הבקשה למקור נתוני אפליקציה תוך 42 ימים ממועד האירוע האחרון אונליין עבור אותו
app_instance_id.לדוגמה, אם האירוע האחרון אונליין של
app_instance_idהתרחש ב-1 במרץ, צריך לשלוח את האירוע של Measurement Protocol עד 12 באפריל.אם משנים את הערך של
timestamp_micros, צריך להגדיר אותו לחותמת זמן מ-72 השעות האחרונות.