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