Các hoạt động tương tác cơ bản với ứng dụng và/hoặc trang web của bạn (như được cho biết bên dưới tên sự kiện trong bảng dưới đây) sẽ kích hoạt các sự kiện được thu thập tự động. Bạn không cần viết thêm mã để thu thập những sự kiện này, miễn là bạn sử dụng thẻ Google hoặc SDK Google Analytics cho Firebase.
Analytics thu thập sự kiện cho các ứng dụng Android và iOS trừ phi có quy định khác. Tên và thông số của những sự kiện này có thể hữu ích khi bạn truy cập vào dữ liệu chưa qua xử lý về sự kiện trong BigQuery.
Để tìm hiểu từng tham số sự kiện được liệt kê bên dưới và cách mỗi tham số cập nhật một phương diện hoặc chỉ số trong Google Analytics, hãy xem bài viết Tham số sự kiện Google Analytics.
Lưu ý:
Sau đây là một vài tham số được thu thập theo mặc định với mọi sự kiện, bao gồm cả sự kiện tuỳ chỉnh:
- Luồng dữ liệu web:
- language
- page_location
- page_referrer
- page_title
- screen_resolution
- Luồng ứng dụng:
- app_version
- firebase_screen_id
- firebase_screen_class
Giá trị được chỉ định cho tham số sự kiện chỉ được có tối đa 100 ký tự. Thông số page_title chỉ được có tối đa 300 ký tự. Thông số page_referrer chỉ được có tối đa 420 ký tự. Thông số page_location chỉ được có tối đa 1.000 ký tự.
Nếu bạn ghi đè thông số page_location, hãy đảm bảo rằng đường dẫn URL là hợp lệ. Nếu bạn chỉ định một đường dẫn URL không hợp lệ, thì phương diện Vị trí trang sẽ trống. Bạn có thể sử dụng Trình tạo URL của chiến dịch để kiểm tra xem đường dẫn URL có hợp lệ hay không.
Các tham số firebase_screen_id và firebase_screen_class được tự động thu thập trừ phi bạn tắt tính năng theo dõi lượt xem màn hình.
| Sự kiện | Được tự động kích hoạt... | Tham số |
|---|---|---|
|
ad_click (ứng dụng) |
khi người dùng nhấp vào một quảng cáo Các sự kiện của nhà xuất bản bắt nguồn từ AdMob thông qua SDK Quảng cáo của Google trên thiết bị di động hoặc bắt nguồn từ Ad Manager thông qua tính năng tích hợp Ad Manager Sự kiện này không được xuất sang BigQuery. |
ad_event_id |
|
ad_exposure (ứng dụng) |
khi màn hình hiển thị ít nhất một quảng cáo do SDK quảng cáo trên thiết bị di động phân phát Sự kiện này không xuất hiện trong các báo cáo và không được xuất sang BigQuery. |
firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time |
|
ad_impression (ứng dụng) |
khi người dùng thấy một quảng cáo hiển thị Các sự kiện của nhà xuất bản bắt nguồn từ AdMob thông qua SDK Quảng cáo của Google trên thiết bị di động hoặc bắt nguồn từ Ad Manager thông qua tính năng tích hợp Ad Manager Sự kiện này không được xuất sang BigQuery. Lưu ý: Không có giá trị |
ad_event_id, value |
|
ad_query (ứng dụng) |
khi SDK quảng cáo trên thiết bị di động thực hiện một yêu cầu quảng cáo Sự kiện này không xuất hiện trong các báo cáo và không được xuất sang BigQuery. |
ad_event_id |
|
ad_reward (ứng dụng) |
khi người dùng nhận được phần thưởng từ quảng cáo có tặng thưởng do SDK quảng cáo trên thiết bị di động phân phát | ad_unit_code, reward_type, reward_value |
|
adunit_exposure (ứng dụng) |
khi màn hình hiển thị một đơn vị quảng cáo do SDK quảng cáo trên thiết bị di động phân phát Sự kiện này không xuất hiện trong các báo cáo và không được xuất sang BigQuery. |
firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time |
|
app_clear_data (ứng dụng) |
khi người dùng đặt lại/xoá dữ liệu ứng dụng, việc này cũng sẽ xoá tất cả các chế độ cài đặt và dữ liệu đăng nhập Chỉ dành cho Android |
|
|
app_exception (ứng dụng) |
khi ứng dụng gặp lỗi hoặc trả về một ngoại lệ Sự kiện này sẽ được gửi khi bạn tích hợp Firebase Crashlytics. |
fatal, timestamp, engagement_time_msec |
|
app_remove (ứng dụng) |
khi người dùng xoá (gỡ cài đặt) một gói ứng dụng khỏi một thiết bị Android Chỉ dành cho Android |
|
|
app_store_refund (ứng dụng) |
khi một lượt mua hàng trong ứng dụng được Google Play hoàn tiền Chỉ dành cho Android Sự kiện này không được xuất sang BigQuery. |
product_id, value, currency, quantity |
|
app_store_ subscription_cancel (ứng dụng) |
khi người dùng huỷ gói thuê bao có tính phí trong Google Play Chỉ dành cho Android Yêu cầu đăng ký lần đầu trong hoặc sau ngày 1 tháng 7 năm 2019. Sự kiện này không được xuất sang BigQuery. |
product_id, price, value, currency, cancellation_reason |
|
app_store_ subscription_convert (ứng dụng) |
khi người dùng chuyển đổi từ gói thuê bao dùng thử miễn phí sang gói thuê bao có tính phí Sự kiện này được đặt làm sự kiện chính mặc định. Yêu cầu đăng ký lần đầu trong hoặc sau ngày 1 tháng 7 năm 2019. Gói thuê bao dùng thử miễn phí lần đầu được ghi lại dưới dạng sự kiện in_app_purchase với thông số subscription được đặt thành true. Sự kiện này không được xuất sang BigQuery. |
product_id, price, value, currency, quantity |
|
app_store_ subscription_renew (ứng dụng) |
khi người dùng gia hạn gói thuê bao có tính phí Sự kiện này được đặt làm sự kiện chính mặc định. Yêu cầu đăng ký lần đầu trong hoặc sau ngày 1 tháng 7 năm 2019. Sự kiện này không được xuất sang BigQuery. |
product_id, price, value, currency, quantity, renewal_count |
|
app_update (ứng dụng) |
khi người dùng cập nhật ứng dụng lên một phiên bản mới và bắt đầu chạy lại Hệ thống sẽ truyền mã phiên bản trước đó của ứng dụng dưới dạng thông số. Về mặt lý thuyết, sự kiện này khác với chỉ số Số thiết bị nâng cấp ứng dụng hằng ngày do Google Play Console báo cáo. Quá trình nâng cấp là quá trình cập nhật tệp nhị phân của ứng dụng, trong đó, hệ thống sẽ kích hoạt sự kiện app_update khi người dùng bắt đầu chạy ứng dụng sau khi đã nâng cấp. |
previous_app_version |
|
nhấp chuột (web) |
mỗi khi người dùng nhấp vào một đường liên kết dẫn ra khỏi miền hiện tại Theo mặc định, các sự kiện nhấp vào đường liên kết ngoài sẽ xảy ra với tất cả đường liên kết đưa ra khỏi miền hiện tại. Các đường liên kết đến miền được thiết lập để đo lường trên nhiều miền sẽ không kích hoạt các sự kiện nhấp vào đường liên kết ngoài. Các thông số sẽ điền sẵn các phương diện sau đây:
Được thu thập theo mặc định thông qua tính năng đo lường nâng cao. |
link_classes, link_domain, link_id, link_url, outbound (boolean) |
|
dynamic_link_app_open (ứng dụng) |
khi người dùng mở lại ứng dụng thông qua một đường liên kết động Lưu ý: Chúng tôi sẽ ngừng cung cấp sự kiện này vì Đường liên kết động của Firebase hiện đã ngừng hoạt động. Tìm hiểu thêm về những thay đổi này. |
source, medium, campaign, link_id, accept_time |
|
dynamic_link_ app_update (ứng dụng) |
khi người dùng cập nhật ứng dụng lên một phiên bản mới và mở ứng dụng đó thông qua một đường liên kết động Chỉ dành cho Android Lưu ý: Chúng tôi sẽ ngừng cung cấp sự kiện này vì Đường liên kết động của Firebase hiện đã ngừng hoạt động. Tìm hiểu thêm về những thay đổi này. |
source, medium, campaign, link_id, accept_time |
|
dynamic_link_ first_open (ứng dụng) |
khi người dùng mở ứng dụng lần đầu tiên thông qua một đường liên kết động Lưu ý: Chúng tôi sẽ ngừng cung cấp sự kiện này vì Đường liên kết động của Firebase hiện đã ngừng hoạt động. Tìm hiểu thêm về những thay đổi này. |
source, medium, campaign, link_id, accept_time |
|
lỗi (ứng dụng) |
được ghi lại thay cho một sự kiện mà hệ thống không thể ghi lại vì sự kiện này không hợp lệ theo cách nào đó Sự kiện này không xuất hiện trong các báo cáo và không được xuất sang BigQuery. |
firebase_error, firebase_error_value |
|
file_download (web) |
khi người dùng nhấp vào đường liên kết dẫn đến một tệp (có đuôi tệp phổ biến) thuộc các loại sau:
Theo mặc định, sự kiện này sẽ được thu thập thông qua tính năng đo lường nâng cao. Xem những đuôi tệp kích hoạt sự kiện này |
file_extension, file_name link_classes, link_id, link_text, link_url |
|
firebase_campaign (ứng dụng) |
khi người dùng chạy ứng dụng với các thông số chiến dịch |
source, medium, campaign, term, content, gclid, aclid, cp1, anid, click_timestamp, campaign_info_source |
|
firebase_in_app_ message_action (ứng dụng) |
khi người dùng thực hiện hành động đối với một Thông báo trong ứng dụng Firebase | message_name, message_device_time, message_id |
|
firebase_in_app_ message_dismiss (ứng dụng) |
khi người dùng bỏ qua một Thông báo trong ứng dụng Firebase | message_name, message_device_time, message_id |
|
firebase_in_app_ message_impression (ứng dụng) |
khi người dùng nhìn thấy một Thông báo trong ứng dụng Firebase | message_name, message_device_time, message_id |
|
first_open (ứng dụng) |
lần đầu tiên người dùng chạy ứng dụng sau khi cài đặt hoặc cài đặt lại ứng dụng đó Sự kiện này không được kích hoạt khi người dùng tải ứng dụng xuống thiết bị, mà chỉ được kích hoạt khi người dùng sử dụng ứng dụng đó lần đầu tiên. Để xem dữ liệu chưa qua xử lý về số lượt tải xuống, hãy xem trong Google Play Console hoặc trong iTunesConnect. Hỗ trợ đo lường các sự kiện chính first_open cho những người dùng chấp nhận lời nhắc về việc theo dõi ứng dụng trên iOS 14 của Apple. |
previous_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 (ứng dụng, web) |
lần đầu tiên người dùng truy cập vào trang web hoặc chạy ứng dụng Android tức thì có bật Analytics | |
|
form_start (web) |
lần đầu tiên người dùng tương tác với một biểu mẫu trong phiên Được thu thập theo mặc định thông qua tính năng đo lường nâng cao. |
form_id, form_name, form_destination |
|
form_submit (web) |
khi người dùng gửi một biểu mẫu Được thu thập theo mặc định thông qua tính năng đo lường nâng cao. |
form_id, form_name, form_destination, form_submit_text |
|
in_app_purchase (ứng dụng) |
khi người dùng hoàn tất một giao dịch mua hàng trong ứng dụng, bao gồm cả gói thuê bao ban đầu, được xử lý qua Apple App Store hoặc Cửa hàng Google Play Hệ thống sẽ truyền mã sản phẩm, tên sản phẩm, đơn vị tiền tệ và số lượng sản phẩm dưới dạng thông số. Chỉ những phiên bản của ứng dụng có chứa SDK Google Analytics cho Firebase mới có thể kích hoạt sự kiện này. Android: Để xem dữ liệu về giao dịch mua hàng trong ứng dụng cho ứng dụng Android, hãy liên kết Analytics với Google Play. Xin lưu ý rằng Analytics không tự động đo lường doanh thu từ giao dịch mua hàng trong ứng dụng có tính phí. Ngoài ra, doanh thu được báo cáo trong Google Analytics có thể khác với các giá trị mà bạn thấy trong Google Play Console. Analytics sẽ bỏ qua các thử nghiệm hoặc những sự kiện bị gắn cờ là không hợp lệ. Tìm hiểu thêm về cách thử nghiệm dịch vụ Google Play Billing. iOS: Xin lưu ý rằng Analytics không tự động đo lường doanh thu từ giao dịch mua hàng trong ứng dụng có tính phí và lượt hoàn tiền. Analytics sẽ bỏ qua hộp cát hoặc những sự kiện bị gắn cờ là không hợp lệ. |
product_id, price, value, currency, quantity, subscription, free_trial, introductory_price |
|
notification_dismiss (ứng dụng) |
khi người dùng đóng một thông báo do Giải pháp gửi thông báo qua đám mây của Firebase (FCM) gửi Chỉ dành cho Android |
message_name, message_time, message_device_time, message_id, topic, label, message_channel |
|
notification_foreground (ứng dụng) |
khi thiết bị nhận được một thông báo gửi từ FCM trong lúc ứng dụng đang chạy trên nền trước | message_name, message_time, message_device_time, message_id, topic, label, message_channel, message_type |
|
notification_open (ứng dụng) |
khi người dùng mở một thông báo gửi từ FCM | message_name, message_time, message_device_time, message_id, topic, label, message_channel |
|
notification_receive (ứng dụng) |
khi thiết bị nhận được một thông báo gửi từ FCM trong lúc ứng dụng đang chạy trong nền Chỉ dành cho Android |
message_name, message_time, message_device_time, message_id, topic, label, message_channel, message_type |
|
os_update (ứng dụng) |
khi hệ điều hành của thiết bị được cập nhật lên phiên bản mới. Hệ thống sẽ chuyển mã phiên bản hệ điều hành trước dưới dạng thông số | previous_os_version |
|
page_view (web) |
mỗi khi trang tải hoặc trang web đang hoạt động thay đổi trạng thái lịch sử duyệt web Được thu thập theo mặc định thông qua tính năng đo lường nâng cao. |
page_location (URL trang), page_referrer (URL trang trước), engagement_time_msec |
|
screen_view (ứng dụng) |
khi một sự kiện chuyển màn hình xảy ra và đáp ứng bất kỳ tiêu chí nào sau đây:
|
firebase_screen, firebase_screen_class, firebase_screen_id, firebase_previous_screen, firebase_previous_class, firebase_previous_id, engagement_time_msec |
|
cuộn (web) |
lần đầu tiên người dùng xem đến cuối trang (tức là khi trang đã hiển thị 90% theo chiều dọc) Được thu thập theo mặc định thông qua tính năng đo lường nâng cao. |
engagement_time_msec |
|
session_start (ứng dụng, web) |
khi người dùng tương tác với ứng dụng hoặc trang web Mã phiên và số phiên được tạo tự động cho từng phiên, sau đó được liên kết với từng sự kiện trong phiên đó. Tìm hiểu thêm |
|
|
user_engagement (ứng dụng, web) |
khi ứng dụng chạy ở nền trước hoặc trang web là tiêu điểm trong ít nhất 1 giây. Tìm hiểu thêm |
engagement_time_msec |
|
video_complete (web) |
khi video kết thúc Đối với những video trên YouTube được nhúng có bật tính năng hỗ trợ JS API. Được thu thập theo mặc định thông qua tính năng đo lường nâng cao. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (boolean) |
|
video_progress (web) |
khi tiến trình video phát qua 10%, 25%, 50% và 75% thời lượng Đối với những video trên YouTube được nhúng có bật tính năng hỗ trợ JS API. Được thu thập theo mặc định thông qua tính năng đo lường nâng cao. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (boolean) |
|
video_start (web) |
khi video bắt đầu phát Đối với những video trên YouTube được nhúng có bật tính năng hỗ trợ JS API. Được thu thập theo mặc định thông qua tính năng đo lường nâng cao. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (boolean) |
|
view_search_results (web) |
mỗi khi người dùng thực hiện việc tìm kiếm trên trang web, biểu thị bằng sự hiện diện của thông số truy vấn URL Được thu thập theo mặc định thông qua tính năng đo lường nâng cao. |
search_term, tham số không bắt buộc ‘q_<additional key="">’ (trong đó <additional key=""> khớp với một tham số truy vấn khác mà bạn chỉ định để hệ thống thu thập trong phần cài đặt nâng cao) Lưu ý: Sự kiện này chỉ gửi tham số unique_search_term khi giá trị của nó là 1 (tức là khi chuỗi là giá trị dành riêng cho phiên đó). |
Lưu ý: Những đuôi tệp khớp với biểu thức chính quy sau sẽ kích hoạt sự kiện 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