رویدادهای جمع‌آوری‌شده به‌صورت خودکار در Google Analytics
رویدادهای خودکار (Automatically collected events) زمانی فعال می‌شوند که کاربر تعاملات پایه‌ای با اپلیکیشن یا وب‌سایت شما داشته باشد. به‌محض اینکه از Google Tag در سایت یا Firebase SDK در اپلیکیشن خود استفاده کنید، این رویدادها بدون نیاز به نوشتن کد اضافه جمع‌آوری می‌شوند.
Google Analytics این رویدادها را برای اپلیکیشن‌های Android و iOS (مگر در موارد خاص) به‌صورت پیش‌فرض جمع‌آوری می‌کند. نام و پارامترهای این رویدادها هنگام دسترسی به داده‌های خام در BigQuery نیز قابل استفاده هستند.
برای آشنایی بیشتر با هر پارامتر رویداد و تأثیر آن بر ابعاد (Dimensions) و شاخص‌ها (Metrics) در Analytics، به صفحه پارامترهای رویداد در گوگل آنالیتیکس مراجعه کنید.
پارامترهای پیش‌فرض جمع‌آوری‌شده با هر رویداد
این پارامترها حتی با رویدادهای سفارشی (Custom Events) نیز به‌صورت پیش‌فرض جمع‌آوری می‌شوند:
برای وب‌سایت‌ها (Web Stream):
-
language– زبان مرورگر کاربر -
page_location– آدرس صفحه -
page_referrer– صفحه ارجاع‌دهنده -
page_title– عنوان صفحه -
screen_resolution– وضوح صفحه‌نمایش
برای اپلیکیشن‌ها (App Stream):
-
app_version– نسخه اپ -
firebase_screen_id– شناسه صفحه در Firebase -
firebase_screen_class– کلاس صفحه در Firebase
محدودیت‌های اندازه پارامترها
-
مقدار هر پارامتر رویداد نباید بیشتر از ۱۰۰ کاراکتر باشد.
-
مقدار پارامتر
page_titleحداکثر ۳۰۰ کاراکتر -
مقدار پارامتر
page_referrerحداکثر ۴۲۰ کاراکتر -
مقدار پارامتر
page_locationحداکثر ۱,۰۰۰ کاراکتر
اگر پارامتر
page_locationرا به‌صورت دستی مقداردهی می‌کنید، حتماً مطمئن شوید که مسیر URL معتبر باشد. مسیرهای نامعتبر باعث می‌شوند مقدار بُعد Page location خالی بماند.
برای بررسی اعتبار URL می‌توانید از ابزار Campaign URL Builder استفاده کنید.
پارامترهای firebase_screen_id و firebase_screen_class نیز به‌صورت خودکار جمع‌آوری می‌شوند، مگر اینکه ردیابی صفحات (screenview tracking) را غیرفعال کرده باشید.
| رویداد (Event) | زمان فعال‌سازی خودکار | پارامترها |
|---|---|---|
ad_click |
کلیک کاربر روی یک تبلیغ (AdMob یا Ad Manager) | ad_event_id |
ad_exposure |
نمایش حداقل یک تبلیغ روی صفحه | firebase_screen، firebase_screen_id، firebase_screen_class، exposure_time |
ad_impression |
زمانی که کاربر یک تبلیغ را ببیند | ad_event_id، value |
ad_query |
درخواست تبلیغ توسط SDK موبایل | ad_event_id |
ad_reward |
زمانی که یک پاداش توسط تبلیغ ارائه شود | ad_unit_code، reward_type، reward_value |
adunit_exposure |
زمانی که یک واحد تبلیغاتی روی صفحه ظاهر شود | firebase_screen، firebase_screen_id، firebase_screen_class، exposure_time |
app_clear_data |
کاربر اطلاعات برنامه را ریست یا پاک‌سازی می‌کند (فقط اندروید) | — |
app_exception |
اپلیکیشن کرش می‌کند یا خطایی رخ می‌دهد (نیازمند Firebase Crashlytics) | fatal، timestamp، engagement_time_msec |
app_remove |
حذف بسته اپلیکیشن از دستگاه اندرویدی | — |
app_store_refund |
بازپرداخت خرید درون‌برنامه‌ای توسط Google Play (فقط اندروید) | product_id، value، currency، quantity |
app_store_subscription_cancel |
لغو اشتراک پولی در Google Play (از ۱ جولای ۲۰۱۹ به بعد) | product_id، price، value، currency، cancellation_reason |
app_store_subscription_convert |
تبدیل اشتراک آزمایشی رایگان به اشتراک پولی | product_id، price، value، currency، quantity |
app_store_subscription_renew |
تمدید اشتراک پولی (از ۱ جولای ۲۰۱۹ به بعد) | product_id، price، value، currency، quantity، renewal_count |
| رویداد (Event) | زمان فعال‌سازی خودکار | پارامترها |
|---|---|---|
app_update |
به‌روزرسانی و اجرای مجدد اپلیکیشن | previous_app_version |
click |
کلیک روی لینک‌هایی که به دامنه دیگر هدایت می‌شوند | link_classes، link_domain، link_id، link_url، outbound |
dynamic_link_app_open |
باز شدن اپ از طریق لینک داینامیک (در حال منسوخ شدن) | source، medium، campaign، link_id، accept_time |
dynamic_link_app_update |
باز شدن نسخه جدید اپ از طریق لینک داینامیک (اندروید) | همانند بالا |
dynamic_link_first_open |
اولین باز کردن اپ از طریق لینک داینامیک | همانند بالا |
error |
در صورت بروز خطا در ثبت رویداد | 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 و سایر پارامترها |
firebase_in_app_message_action |
تعامل کاربر با پیام داخل اپ (FIAM) | message_name، message_device_time، message_id |
firebase_in_app_message_dismiss |
رد پیام داخل اپ توسط کاربر | همانند بالا |
firebase_in_app_message_impression |
مشاهده پیام داخل اپ توسط کاربر | همانند بالا |
first_open |
اولین بار که اپ اجرا می‌شود (پس از نصب) | previous_gmp_app_id، engagement_time_msec و سایر پارامترها |
first_visit |
اولین بازدید از وب‌سایت یا اجرای اپلیکیشن آنی | client_id، ga_session_id، page_location و ... |
form_start |
اولین تعامل کاربر با یک فرم | form_id، form_name، form_destination |
form_submit |
ارسال فرم توسط کاربر | form_id، form_name، form_destination، form_submit_text |
in_app_purchase |
خرید درون‌برنامه‌ای (اپل یا گوگل پلی) | product_id، price، value، currency، subscription و ... |
notification_dismiss |
رد اعلان FCM توسط کاربر (اندروید) | message_name، message_time، message_id و ... |
notification_foreground |
دریافت اعلان در حین اجرای اپ | همانند بالا با پارامتر message_type |
| رویداد (Event) | زمان فعال‌سازی خودکار | پارامترها |
|---|---|---|
notification_open |
کاربر یک اعلان ارسال‌شده توسط FCM را باز می‌کند | message_name، message_time، message_device_time، message_id، topic، label، message_channel |
notification_receive |
دریافت اعلان توسط دستگاه هنگام پس‌زمینه بودن اپ (فقط اندروید) | همانند بالا به همراه message_type |
os_update |
به‌روزرسانی سیستم عامل دستگاه | previous_os_version |
page_view |
بارگذاری یا تغییر وضعیت صفحه (وب) | page_location، page_referrer، engagement_time_msec |
screen_view |
تغییر صفحه در اپ در صورت تغییر نام، کلاس یا ID صفحه | firebase_screen، firebase_screen_class، firebase_screen_id، firebase_previous_screen و سایر پارامترها |
scroll |
رسیدن کاربر به انتهای صفحه (۹۰٪ عمودی) | engagement_time_msec |
session_start |
شروع تعامل کاربر با سایت یا اپ | client_id، ga_session_id، ga_session_number و ... |
user_engagement |
فعال بودن اپ یا صفحه برای حداقل ۱ ثانیه | engagement_time_msec |
video_complete |
پایان یافتن پخش ویدیو (یوتیوب با JS API) | video_current_time، video_duration، video_percent، video_provider، video_title، video_url، visible |
video_progress |
پیشرفت ویدیو از ۱۰٪، ۲۵٪، ۵۰٪، ۷۵٪ | همانند بالا |
video_start |
شروع پخش ویدیو | همانند بالا |
view_search_results |
جستجوی سایت با پارامتر در URL | search_term، اختیاری: q_<کلید اضافی> |
نکات مهم درباره استفاده از پارامترها و رویداد فایل دانلود (file_download)
📌 استفاده از پارامترها در گزارش‌ها
برای اینکه بتوانید از پارامترهای سفارشی (Custom Parameters) در گزارش‌های Google Analytics استفاده کنید، ابتدا باید آن‌ها را به‌عنوان ابعاد سفارشی (Custom Dimensions) تعریف کنید.
همچنین می‌توانید از ابزار Explorations در بخش گزارش‌ساز استفاده کرده و با ساخت سگمنت‌هایی مبتنی بر پارامترهای رویداد، گزارش‌های دقیق‌تری بسازید.
اطلاعات بیشتر درباره Segment Builder
📌 الگوی فایل‌هایی که رویداد دانلود را فعال می‌کنند
رویداد file_download به‌صورت خودکار زمانی فعال می‌شود که کاربر روی لینکی به فایل‌هایی با فرمت‌های زیر کلیک کند. این فرمت‌ها با الگوی regex زیر تطابق دارند:
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
