אירועים שנאספים באופן אוטומטי מתועדים כשהמשתמשים מבצעים פעולות בסיסיות באפליקציה או באתר שלכם (בהתאם למה שמופיע מתחת לשם של כל אירוע בטבלה שבהמשך). כל עוד משתמשים ב-Google Tag או ב-Google Analytics for Firebase SDK, אין צורך לכתוב קוד נוסף כדי שהאירועים האלה ייאספו.
אלא אם צוין אחרת, מערכת Analytics אוספת את נתוני האירועים האלה מאפליקציות ל-Android וגם מאפליקציות ל-iOS. השמות והפרמטרים של האירועים האלה יכולים להועיל כשניגשים לנתוני האירועים הגולמיים ב-BigQuery.
כדי לקבל מידע נוסף על כל פרמטר של אירוע שמפורט בהמשך, ולהבין איך כל פרמטר מעדכן מאפיין או מדד ב-Google Analytics, אפשר לעיין במאמר פרמטרים של אירועים ב-Google Analytics.
הערה:
בהמשך מפורטים כמה מהפרמטרים שנאספים כברירת מחדל עם כל אירוע, כולל אירועים מותאמים אישית:
- המקור לנתוני האתר:
- language
- page_location
- page_referrer
- page_title
- screen_resolution
- המקור לנתוני האפליקציה:
- app_version
- firebase_screen_id
- firebase_screen_class
האורך המקסימלי של הערך שמוקצה לפרמטרים של אירועים הוא 100 תווים. האורך המקסימלי של ערך הפרמטר page_title הוא 300 תווים. האורך המקסימלי של ערך הפרמטר page_referrer הוא 420 תווים. האורך המקסימלי של ערך הפרמטר page_location הוא 1,000 תווים.
אם משנים את הפרמטר page_location מברירת המחדל, צריך לוודא שנתיב כתובת ה-URL תקין. אם מקצים נתיב כתובת URL לא תקין, המאפיין מיקום הדף יהיה ריק. כדי לבדוק אם נתיב כתובת ה-URL תקין, אפשר להשתמש בכלי ליצירת כתובות URL בקמפיינים.
הפרמטרים firebase_screen_id ו-firebase_screen_class נאספים באופן אוטומטי, אלא אם משביתים את המעקב אחרי צפיות במסכים.
| אירוע | מופעל באופן אוטומטי... | פרמטרים |
|---|---|---|
|
ad_click (אפליקציות) |
כשמשתמשים לוחצים על מודעה אירועים של בעלי אפליקציות שמגיעים מ-AdMob דרך Google Mobile Ads SDK או מ-Ad Manager דרך השילוב של Ad Manager. האירוע הזה לא מיוצא ל-BigQuery. |
ad_event_id |
|
ad_exposure (אפליקציות) |
כשמודעה אחת לפחות שהוצגה על ידי Mobile Ads SDK מופיעה במסך האירוע הזה לא מופיע בדוחות ולא מיוצא ל-BigQuery. |
firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time |
|
ad_impression (אפליקציות) |
כשמשתמש נחשף למודעה אירועים של בעלי אפליקציות שמגיעים מ-AdMob דרך Google Mobile Ads SDK או מ-Ad Manager דרך השילוב של Ad Manager. האירוע הזה לא מיוצא ל-BigQuery. הערה: הפרמטרים value או currency של |
ad_event_id, value |
|
ad_query (אפליקציות) |
כשנשלחת בקשה מ-Mobile Ads SDK להצגת מודעה האירוע הזה לא מופיע בדוחות ולא מיוצא ל-BigQuery. |
ad_event_id |
|
ad_reward (אפליקציות) |
כשמשתמש מקבל תגמול על צפייה במודעה מתגמלת שהוצגה דרך Mobile Ads SDK. | ad_unit_code, reward_type, reward_value |
|
adunit_exposure (אפליקציות) |
כשיחידת מודעות שהוצגה על ידי Mobile Ads SDK מופיעה במסך האירוע הזה לא מופיע בדוחות ולא מיוצא ל-BigQuery. |
firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time |
|
app_clear_data (אפליקציות) |
כשמשתמש מאפס או מוחק את נתוני האפליקציה ומסיר את כל ההגדרות ופרטי הכניסה ב-Android בלבד |
|
|
app_exception (אפליקציות) |
כשהאפליקציה קורסת או מקפיצה הודעת שגיאה האירוע הזה מופיע כשמשלבים את Firebase Crashlytics. |
fatal, timestamp, engagement_time_msec |
|
app_remove (אפליקציות) |
כשמשתמש מסיר חבילה של אפליקציה ממכשיר Android Android בלבד |
|
|
app_store_refund (אפליקציות) |
כשניתן החזר כספי מ-Google Play על רכישה מתוך האפליקציה ב-Android בלבד האירוע הזה לא מיוצא ל-BigQuery. |
product_id, value, currency, quantity |
|
app_store_subscription_cancel (אפליקציות) |
כשמינוי בתשלום מבוטל ב-Google Play ב-Android בלבד נדרש מינוי ראשוני שנרכש ב-1 ביולי 2019 או בתאריך מאוחר יותר. האירוע הזה לא מיוצא ל-BigQuery. |
product_id, price, value, currency, cancellation_reason |
|
app_store_subscription_convert (אפליקציות) |
כשמינוי לתקופת ניסיון בחינם מומר למינוי בתשלום האירוע הזה הוא אירוע מרכזי שמוגדר כברירת מחדל במערכת. נדרש מינוי ראשוני שנרכש ב-1 ביולי 2019 או בתאריך מאוחר יותר. מינוי ראשוני לתקופת ניסיון בחינם נרשם בתור in_app_purchase, ופרמטר המינוי מוגדר כ-true. האירוע הזה לא מיוצא ל-BigQuery. |
product_id, price, value, currency, quantity |
|
app_store_subscription_renew (אפליקציות) |
כשמחדשים מינוי בתשלום האירוע הזה הוא אירוע מרכזי שמוגדר כברירת מחדל במערכת. נדרש מינוי ראשוני שנרכש ב-1 ביולי 2019 או בתאריך מאוחר יותר. האירוע הזה לא מיוצא ל-BigQuery. |
product_id, price, value, currency, quantity, renewal_count |
|
app_update (אפליקציות) |
כשמתבצע עדכון של האפליקציה לגרסה חדשה, והיא מופעלת שוב המזהה הקודם של גרסת האפליקציה מועבר כפרמטר. האירוע הזה שונה במהותו מהמדד "מספר השדרוגים היומי לפי מכשיר", שמדווח דרך Google Play Console. שדרוג מתייחס לעדכון הקובץ הבינארי של האפליקציה. לעומת זאת, אירוע app_update מופעל כשהאפליקציה נפתחת אחרי שהיא משודרגת. |
previous_app_version |
|
click (אתר) |
בכל פעם שמשתמש לוחץ על קישור שמוביל אל מחוץ לדומיין הנוכחי כברירת מחדל, אירועים מסוג קליק יוצא יתרחשו בכל הקישורים שמובילים אל מחוץ לדומיין הנוכחי. קישורים לדומיינים שהוגדרו למדידה בכמה דומיינים לא יפעילו אירועי קליק יוצא. הפרמטרים מאכלסים את המאפיינים הבאים:
נאסף כברירת מחדל באמצעות התכונה מדידה משופרת. |
link_classes, link_domain, link_id, link_url, outbound (ערכים בוליאניים) |
|
dynamic_link_app_open (אפליקציות) |
כשמשתמש פותח מחדש את האפליקציה באמצעות קישור דינמי הערה: אנחנו מוציאים משימוש את האירוע הזה בגלל שהתמיכה בקישורים הדינמיים ב-Firebase הופסקה. בקישור הבא אפשר לקבל מידע נוסף על השינויים. |
source, medium, campaign, link_id, accept_time |
|
dynamic_link_app_update (אפליקציות) |
כשמתבצע עדכון של האפליקציה לגרסה חדשה, והמשתמש פותח אותה באמצעות קישור דינמי ב-Android בלבד הערה: אנחנו מוציאים משימוש את האירוע הזה בגלל שהתמיכה בקישורים הדינמיים ב-Firebase הופסקה. בקישור הבא אפשר לקבל מידע נוסף על השינויים. |
source, medium, campaign, link_id, accept_time |
|
dynamic_link_first_open (אפליקציות) |
כשמשתמש פותח את האפליקציה בפעם הראשונה באמצעות קישור דינמי הערה: אנחנו מוציאים משימוש את האירוע הזה בגלל שהתמיכה בקישורים הדינמיים ב-Firebase הופסקה. בקישור הבא אפשר לקבל מידע נוסף על השינויים. |
source, medium, campaign, link_id, accept_time |
|
error (אפליקציות) |
במקום אירוע שאי אפשר לתעד מפני שהוא לא תקין מסיבה כלשהי האירוע הזה לא מופיע בדוחות ולא מיוצא ל-BigQuery. |
firebase_error, firebase_error_value |
|
file_download (אתר) |
כשמשתמש לוחץ על קישור שמוביל לקובץ (עם סיומת קובץ נפוצה) מאחד הסוגים הבאים:
האירוע הזה נאסף כברירת מחדל באמצעות מדידה משופרת. סיומות הקבצים שמפעילות את האירוע |
file_extension, file_name, link_classes, link_id, link_text, link_url |
|
firebase_campaign (אפליקציות) |
כשהאפליקציה מופעלת עם פרמטרים של קמפיין |
source, medium, campaign, term, content, gclid, aclid, cp1, anid, click_timestamp, campaign_info_source |
|
firebase_in_app_message_action (iOS) fiam_action (Android) |
כשהמשתמש מקיים אינטראקציה עם הודעה מ-Firebase שמוצגת בתוך האפליקציה | message_name, message_device_time, message_id |
|
firebase_in_app_message_dismiss (iOS) fiam_dismiss (Android) |
כשמשתמש סוגר הודעה מ-Firebase שמוצגת בתוך האפליקציה | message_name, message_device_time, message_id |
|
firebase_in_app_message_impression (iOS)
fiam_impression (Android) |
כשמשתמש רואה הודעה שנשלחה מ-Firebase בתוך האפליקציה | message_name, message_device_time, message_id |
|
first_open (אפליקציות) |
בפעם הראשונה שבה משתמש מפעיל אפליקציה אחרי שהוא התקין אותה או התקין אותה מחדש האירוע הזה לא מופעל כשהמשתמש מוריד את האפליקציה למכשיר, אלא כשהוא משתמש בה בפעם הראשונה. נתונים גולמיים על הורדות זמינים ב-Google Play Console או ב-iTunesConnect. אפשר למדוד באמצעותו אירועים מרכזיים מסוג first_open ב-iOS 14, אם המשתמש אישר את הבקשה של אפל לאסוף נתוני אפליקציות. |
previoius_gmp_app_id, updated_with_analytics, previous_first_open_count, system_app, system_app_update, deferred_analytics_collection, reset_analytics_cause, engagement_time_msec |
|
first_visit (אפליקציה, אתר) |
בפעם הראשונה שבה משתמש נכנס לאתר או מפעיל אפליקציה ללא התקנה ל-Android בזמן ש-Analytics מופעל | client_id, ga_session_id, ga_session_number, ignore_referrer, page_location, page_referrer, page_title, traffic_type |
|
form_start (אתר) |
באינטראקציה הראשונה של המשתמש עם טופס במהלך סשן מסוים נאסף כברירת מחדל באמצעות התכונה מדידה משופרת. |
form_id, form_name, form_destination |
|
form_submit (אתר) |
כשהמשתמש שולח טופס נאסף כברירת מחדל באמצעות התכונה מדידה משופרת. |
form_id, form_name, form_destination, form_submit_text |
|
in_app_purchase (אפליקציות) |
כשמשתמש משלים רכישה מתוך האפליקציה, כולל מינוי ראשוני, והרכישה הזו עוברת עיבוד על ידי Apple App Store או חנות Google Play מזהה המוצר, שם המוצר, המטבע והכמות מועברים כפרמטרים. האירוע הזה מופעל רק על ידי גרסאות של האפליקציה שכוללות את Google Analytics for Firebase SDK. Android: כדי לראות נתונים של רכישות מתוך אפליקציות ל-Android, צריך לקשר את Analytics ל-Google Play. לתשומת ליבכם: מערכת Analytics לא מודדת באופן אוטומטי את ההכנסות מרכישות פריטים מתוך אפליקציות בתשלום. כמו כן, ייתכן שההכנסות שמדווחות ב-Google Analytics יהיו שונות מהערכים שמוצגים ב-Google Play Console. מערכת Analytics מתעלמת מאירועים שמסומנים כלא תקפים או כבדיקות. מידע נוסף על בדיקות חיוב ב-Google Play iOS: לתשומת ליבכם: מערכת Analytics לא מודדת באופן אוטומטי את ההכנסות מרכישות פריטים מתוך אפליקציות בתשלום, ואת ההחזרים הכספיים על רכישות כאלה. מערכת Analytics מתעלמת מאירועים שמסומנים כלא חוקיים או כ-Sandbox. |
product_id, price, value, currency, quantity, subscription, free_trial, introductory_price |
|
notification_dismiss (אפליקציות) |
כשמשתמש סוגר הודעה שנשלחה דרך הכלי "העברת הודעות בענן ב-Firebase" (FCM) ב-Android בלבד |
message_name, message_time, message_device_time, message_id, topic, label, message_channel |
|
notification_foreground (אפליקציות) |
כשהודעה שנשלחה דרך FCM מתקבלת בזמן שהאפליקציה פועלת בחזית | message_name, message_time, message_device_time, message_id, topic, label, message_channel, message_type |
|
notification_open (אפליקציות) |
כשמשתמש פותח הודעה שנשלחה דרך FCM | message_name, message_time, message_device_time, message_id, topic, label, message_channel |
|
notification_receive (אפליקציות) |
כשהודעה שנשלחה דרך FCM מתקבלת במכשיר בזמן שהאפליקציה פועלת ברקע ב-Android בלבד |
message_name, message_time, message_device_time, message_id, topic, label, message_channel, message_type |
|
os_update (אפליקציות) |
כאשר מערכת ההפעלה של המכשיר מעודכנת לגרסה חדשה. מזהה הגרסה הקודמת של מערכת ההפעלה מועבר כפרמטר. | previous_os_version |
|
page_view (אתר) |
בכל טעינה של הדף או בכל פעם שהאתר הַפָּעִיל משנה את מצב היסטוריית הגלישה נאסף כברירת מחדל באמצעות התכונה מדידה משופרת. |
page_location (כתובת הדף), page_referrer (הכתובת הקודמת של הדף), engagement_time_msec |
|
screen_view (אפליקציות) |
כשמשתמש עובר בין מסכים ומתקיים קריטריון כלשהו מבין מהקריטריונים הבאים:
|
firebase_screen, firebase_screen_class, firebase_screen_id, firebase_previous_screen, firebase_previous_class, firebase_previous_id, engagement_time_msec |
|
scroll (אתר) |
בפעם הראשונה שהמשתמש מגיע לתחתית של כל דף (כלומר כשהוא מגיע ל-90% מאורך הדף) נאסף כברירת מחדל באמצעות התכונה מדידה משופרת. |
engagement_time_msec |
|
session_start (אפליקציה, אתר) |
כשמשתמש יוצר אינטראקציה עם האפליקציה או האתר מזהה סשן ומספר סשן נוצרים באופן אוטומטי לכל סשן ומשויכים לכל אירוע בסשן. מידע נוסף |
client_id, ga_session_id, ga_session_number, ignore_referrer, page_location, page_referrer, page_title, traffic_type |
|
user_engagement (אפליקציה, אתר) |
כשהאפליקציה פתוחה בחזית המכשיר או כשהמיקוד הוא על דף האינטרנט למשך שנייה אחת לפחות מידע נוסף |
engagement_time_msec |
|
video_complete (אתר) |
כשהסרטון מסתיים לסרטוני YouTube מוטמעים שהופעלה בהם תמיכה ב-JS API. נאסף כברירת מחדל באמצעות התכונה מדידה משופרת. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (ערכים בוליאניים) |
|
video_progress (אתר) |
כשסרטון שהופעל מגיע ל-10%, 25%, 50% ו-75% מהאורך שלו. לסרטוני YouTube מוטמעים שהופעלה בהם תמיכה ב-JS API. נאסף כברירת מחדל באמצעות התכונה מדידה משופרת. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (ערכים בוליאניים) |
|
video_start (אתר) |
כשהסרטון מופעל לסרטוני YouTube מוטמעים שהופעלה בהם תמיכה ב-JS API. נאסף כברירת מחדל באמצעות התכונה מדידה משופרת. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (ערכים בוליאניים) |
|
view_search_results (אתר) |
בכל פעם שמשתמש מבצע חיפוש באתר. המערכת מזהה זאת על פי נוכחות של פרמטר שאילתה בכתובת URL. נאסף כברירת מחדל באמצעות התכונה מדידה משופרת. |
search_term, וייתכן שגם ‘q_<additional key="">’ (כאשר <additional key=""> תואם לפרמטר שאילתה נוסף שתציינו בהגדרות המתקדמות כפרמטר שיש לאסוף) הערה: האירוע הזה שולח את הפרמטר unique_search_term רק אם הערך של הפרמטר הזה הוא 1 (כלומר כשהמחרוזת הזו ייחודית לסשן הרלוונטי). |
הערה: סיומות קבצים התואמות לביטוי הרגולרי (regex) הבא יפעילו את האירוע file_download:
pdf|xlsx?|docx?|txt|rtf|csv|exe|key|pp(s|t|tx)|7z|pkg|rar|gz|zip|avi|mov|mp4|mpe?g|wmv|midi?|mp3|wav|wma