เหตุการณ์ที่รวบรวมโดยอัตโนมัติจะทริกเกอร์เมื่อมีการโต้ตอบทั่วไปกับแอปและ/หรือเว็บไซต์ (ตามที่ระบุไว้ใต้ชื่อของเหตุการณ์ในตารางด้านล่าง) ตราบใดที่คุณใช้แท็ก Google หรือ SDK ของ Google Analytics สำหรับ Firebase ก็ไม่ต้องเขียนโค้ดใดๆ เพิ่มเพื่อรวบรวมเหตุการณ์เหล่านี้
Analytics จะรวบรวมเหตุการณ์สำหรับแอป Android และ iOS เว้นแต่จะระบุไว้เป็นอย่างอื่น ชื่อและพารามิเตอร์ของเหตุการณ์เหล่านี้จะมีประโยชน์เมื่อเข้าถึงข้อมูลเหตุการณ์ดิบใน BigQuery
หากต้องการทราบเกี่ยวกับพารามิเตอร์เหตุการณ์แต่ละรายการที่แสดงด้านล่าง และวิธีที่พารามิเตอร์แต่ละรายการอัปเดตมิติข้อมูลหรือเมตริกใน Google Analytics โปรดดูพารามิเตอร์เหตุการณ์ Google Analytics
หมายเหตุ
ต่อไปนี้เป็นพารามิเตอร์บางส่วนที่ระบบรวบรวมโดยค่าเริ่มต้นสําหรับทุกเหตุการณ์ รวมถึงเหตุการณ์ที่กําหนดเอง
- สตรีมเว็บ:
- ภาษา
- 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 (แอป) |
เมื่อโฆษณาอย่างน้อย 1 รายการที่แสดงโดย 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 |
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 โดยตั้งค่าพารามิเตอร์การสมัครใช้บริการเป็น "จริง" เหตุการณ์นี้จะไม่ส่งออกไปยัง 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 |
|
คลิก (เว็บ) |
ทุกครั้งที่ผู้ใช้คลิกลิงก์ที่นำออกจากโดเมนปัจจุบัน โดยค่าเริ่มต้น กิจกรรมการคลิกขาออกจะเกิดขี้นกับทุกลิงก์ที่นำออกไปจากโดเมนปัจจุบัน ลิงก์ไปที่โดเมนซึ่งกำหนดค่าไว้สำหรับการวัดผลแบบข้ามโดเมนจะไม่เรียกให้แสดงกิจกรรมการคลิกขาออก พารามิเตอร์จะป้อนมิติข้อมูลต่อไปนี้
รวบรวมโดยค่าเริ่มต้นด้วยการวัดที่ปรับปรุงแล้ว |
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 |
|
ข้อผิดพลาด (แอป) |
บันทึกแทนเหตุการณ์ที่บันทึกไม่ได้เนื่องจากไม่ถูกต้องในลักษณะใดลักษณะหนึ่ง เหตุการณ์นี้จะไม่ปรากฏในรายงานและไม่ส่งออกไปยัง 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 (แอป) |
เมื่อผู้ใช้ดำเนินการกับข้อความในแอป Firebase | message_name, message_device_time, message_id |
|
firebase_in_app_ message_dismiss (แอป) |
เมื่อผู้ใช้ปิดข้อความในแอป Firebase | message_name, message_device_time, message_id |
|
firebase_in_app_ message_impression (แอป) |
เมื่อผู้ใช้เห็นข้อความในแอป Firebase | message_name, message_device_time, message_id |
|
first_open (แอป) |
ครั้งแรกที่ผู้ใช้เปิดแอปทั้งหลังจากติดตั้งใหม่หรือติดตั้งอีกครั้ง เหตุการณ์นี้จะไม่ทริกเกอร์เมื่อผู้ใช้ดาวน์โหลดแอปในอุปกรณ์ แต่จะทริกเกอร์เมื่อผู้ใช้ใช้งานแอปเป็นครั้งแรก ดูข้อมูลดิบเกี่ยวกับจำนวนครั้งที่ดาวน์โหลดได้ใน Google Play Console หรือ iTunesConnect รองรับการวัดเหตุการณ์สำคัญ first_open ของผู้ใช้ที่ยอมรับข้อความแจ้งการติดตามแอปใน iOS 14 ของ 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 (แอป เว็บ) |
ครั้งแรกที่ผู้ใช้เข้าชมเว็บไซต์หรือเปิด Android Instant App ที่เปิดใช้ Analytics | |
|
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 Store ระบบจะส่งรหัสผลิตภัณฑ์ ชื่อผลิตภัณฑ์ สกุลเงิน และจำนวนในรูปของพารามิเตอร์ เหตุการณ์นี้จะทริกเกอร์เฉพาะในแอปเวอร์ชันที่มี SDK ของ Google Analytics สําหรับ Firebase Android หากต้องการดูข้อมูลการซื้อในแอปสำหรับแอป Android ให้ลิงก์ Analytics กับ Google Play โปรดทราบว่า Analytics จะไม่วัดรายได้จากการซื้อแอปที่ต้องซื้อให้โดยอัตโนมัติ นอกจากนี้ รายได้ที่รายงานใน Google Analytics อาจแตกต่างจากค่าที่เห็นใน Google Play Console Analytics ไม่สนใจเหตุการณ์ที่มีการแจ้งว่าไม่ถูกต้องหรือการทดสอบ ดูข้อมูลเพิ่มเติมเกี่ยวกับการทดสอบการเรียกเก็บเงินของ Google Play iOS โปรดทราบว่า Analytics จะไม่วัดรายได้จากการซื้อและการคืนเงินของแอปที่ต้องซื้อให้โดยอัตโนมัติ Analytics ไม่สนใจเหตุการณ์ที่มีการแจ้งว่าไม่ถูกต้องหรือแซนด์บ็อกซ์ |
product_id, price, value, currency, quantity, subscription, free_trial, introductory_price |
|
notification_dismiss (แอป) |
เมื่อผู้ใช้ปิดการแจ้งเตือนที่ส่งมาจาก Firebase Cloud Messaging (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 (URL ของหน้า), page_referrer (URL ของหน้าก่อนหน้านี้), 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 (แอป เว็บ) |
เมื่อผู้ใช้มีส่วนร่วมกับแอปหรือเว็บไซต์ ระบบจะสร้างรหัสและหมายเลขสําหรับแต่ละเซสชันโดยอัตโนมัติ และจะเชื่อมโยงกับแต่ละเหตุการณ์ในเซสชัน ดูข้อมูลเพิ่มเติม |
|
|
user_engagement (แอป เว็บ) |
เมื่อแอปทํางานอยู่เบื้องหน้า หรือหน้าเว็บอยู่ในโฟกัสเป็นเวลาอย่างน้อย 1 วินาที ดูข้อมูลเพิ่มเติม |
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 (กล่าวคือ เมื่อสตริงเป็นค่าเฉพาะสําหรับเซสชันนั้น) |
หมายเหตุ: นามสกุลไฟล์ที่ตรงกันกับนิพจน์ทั่วไปต่อไปนี้จะเรียกให้แสดงเหตุการณ์ 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
* ไม่มีการส่งค่า ad_impression หรือสกุลเงินพร้อมการผสานรวมที่เป็นค่าเริ่มต้น