תרחישים לדוגמה ב-Measurement Protocol

פלטפורמת Measurement Protocol של Google Analytics מאפשרת לשלוח נתונים ממקורות אופליין למקור נתונים של אתר או אפליקציה, בנוסף לנתונים שכבר נאספים באמצעות תיוג או Firebase SDK.

במדריך הזה מתוארים תרחישים נפוצים לדוגמה של Measurement Protocol ב-Google Analytics והדרישות שלהם.

סיכום הדרישות

בטבלה הבאה מפורטות בקצרה הדרישות לגבי כל תרחיש שימוש. הנה כמה שיטות מומלצות שכדאי לזכור:

  1. ערך ברירת המחדל שמוגדר לפרמטר timestamp_micros של האירועים ומאפייני המשתמשים הוא מועד הבקשה. כששולחים שינוי באירוע או במאפיין משתמש שהתרחש בעבר, צריך להחליף את חותמת הזמן כמו שמתואר במדריכים בנושאי שליחת אירועים ומאפייני משתמשים.

  2. כדי לקבל דוחות "פעילות בזמן אמת" ומדדי התעניינות מדויקים, צריך לכלול פרמטר של אירוע engagement_time_msec שמוגדר לאלפיות השנייה שעברו מאז האירוע הקודם.

תרחיש שימוש מזהה הסשן דרישה לגבי מועד הבקשה דרישה של timestamp_micros
הקצאת User-ID לאירועים חובה <= סוף יום העסקים שבו הסשן התחיל >= התחלת הסשן וגם <= סוף הסשן
שיוך (Attribution) הסשן חובה <= התחלת הסשן + 24 שעות >= התחלת הסשן וגם <= סוף הסשן
ייצוא אירועים לפלטפורמות הפרסום לא נדרש <= יום הסשן האחרון + 63 ימים >= מועד הבקשה פחות 72 שעות וגם <= מועד הבקשה
שליחת אירועים או מאפייני משתמשים כדי ליצור קהלים לא נדרש אתר: <= מועד האירוע האחרון אונליין + 30 ימים
אפליקציה: <= מועד האירוע האחרון אונליין + 42 ימים		 >= מועד הבקשה פחות 72 שעות וגם <= מועד הבקשה

הקצאת User-ID לאירועים

משתמשים ב-Measurement Protocol כדי לספק אירועים אונליין או אופליין עם מזהה משתמש.

הנה כמה תרחישים לדוגמה להוספת מזהה משתמש לאירוע:

  1. במדידה אונליין חסר המידע שדרוש כדי לבצע חיפוש מהיר של ה-User-ID לאירועים אונליין, אבל יש לכם פייפליין של עיבוד אירועים שיכול לשייך בין סשן אונליין לבין מזהה משתמש.

    בתרחיש הזה, אתם משתמשים ב-Measurement Protocol כדי לספק אירועים אונליין עם מזהה משתמש.

  2. אין לכם את מזהה המשתמש של האירועים שאתם שולחים באמצעות Measurement Protocol, אבל אתם רוצים שהאירועים האלה ישויכו למזהה משתמש אם המשתמש התחבר אונליין במהלך הסשן.

    בתרחיש הזה, אתם משתמשים באירועים אונליין כדי לספק לאירועי 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 ימים. האירוע צריך להגיע גם בתוך חלון השיוך של האירוע המרכזי. איך קובעים את ההגדרות של חלון השיוך (Attribution)

    לדוגמה, אם האירוע האחרון אונליין של 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 השעות האחרונות.