เหตุการณ์ที่รวบรวมโดยอัตโนมัติ

เหตุการณ์ที่รวบรวมโดยอัตโนมัติจะทริกเกอร์เมื่อมีการโต้ตอบทั่วไปกับแอปและ/หรือเว็บไซต์ (ตามที่ระบุไว้ใต้ชื่อของเหตุการณ์ในตารางด้านล่าง) ตราบใดที่คุณใช้แท็ก 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_impression หรือสกุลเงินพร้อมการผสานรวมที่เป็นค่าเริ่มต้น	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 เท่านั้น เหตุการณ์นี้แตกต่างจากเมตริกจำนวนการถอนการติดตั้งรายวันตามอุปกรณ์และจำนวนการถอนการติดตั้งรายวันตามผู้ใช้ ซึ่งเมตริกทั้งสองนี้รายงานโดย Google Play Console เหตุการณ์ app_remove จะนับการนำแพ็กเกจแอปพลิเคชันออก โดยไม่คำนึงถึงแหล่งที่มาของการติดตั้ง และจำนวนที่นับจะเปลี่ยนแปลงไปตามช่วงวันที่เลือกในรายงาน เมตริกจำนวนการถอนการติดตั้งรายวันตามอุปกรณ์และจำนวนการถอนการติดตั้งรายวันตามผู้ใช้จะนับการนำแพ็กเกจแอปพลิเคชันออกเฉพาะเมื่อผู้ใช้ติดตั้งแอปเหล่านั้นจาก Google Play และระบบจะรายงานเป็นประจำทุกวัน
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) URL ของลิงก์ (จาก link_url) ขาออก (จาก outbound) รวบรวมโดยค่าเริ่มต้นด้วยการวัดที่ปรับปรุงแล้ว	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
ข้อผิดพลาด (แอป)	บันทึกแทนเหตุการณ์ที่บันทึกไม่ได้เนื่องจากไม่ถูกต้องในลักษณะใดลักษณะหนึ่ง พารามิเตอร์ _err (firebase_error), _ev (firebase_error_value) และ _el (firebase_error_length) มีข้อมูลเพิ่มเติม เหตุการณ์นี้จะไม่ปรากฏในรายงานและไม่ส่งออกไปยัง 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 ของ 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	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 Store ระบบจะส่งรหัสสินค้า ชื่อสินค้า สกุลเงิน และจำนวนในรูปของพารามิเตอร์ เหตุการณ์นี้จะทริกเกอร์เฉพาะในแอปเวอร์ชันที่มี Google Analytics สำหรับ Firebase SDK Analytics จะไม่วัดรายได้จากการซื้อและการคืนเงินของแอปที่ต้องซื้อให้โดยอัตโนมัติ รายได้ที่รายงานใน Google Analytics อาจแตกต่างจากค่าใน Google Play Console Analytics ไม่สนใจเหตุการณ์ที่มีการแจ้งว่าไม่ถูกต้อง การทดสอบ หรือการซื้อในแซนด์บ็อกซ์ ดูข้อมูลเพิ่มเติมเกี่ยวกับการทดสอบ Google Play Billing หากการติดตามการซื้ออัตโนมัติไม่พร้อมใช้งาน เช่น เมื่อคุณวัดการซื้อนอก App Store หรือ Google Play คุณสามารถบันทึกเหตุการณ์ in_app_purchase ด้วยตนเองได้โดยใช้ Google Analytics สำหรับ Firebase SDK หรือ Measurement Protocol ที่มีชื่อเหตุการณ์ in_app_purchase ที่ไม่ได้สงวนไว้ ตรวจสอบว่าคำขอมี app_instance_id ที่ถูกต้องเพื่อลิงก์ธุรกรรมอย่างถูกต้อง ดูข้อมูลเพิ่มเติมเกี่ยวกับเหตุการณ์ในบันทึก หมายเหตุ: หากคุณส่งทั้งเหตุการณ์ in_app_purchase ที่รวบรวมโดยอัตโนมัติและบันทึกด้วยตนเองสําหรับการซื้อเดียวกัน ระบบอาจรายงานเหตุการณ์ที่ซ้ำกัน ตรวจสอบการติดตั้งใช้งานเพื่อให้แน่ใจว่าระบบจะบันทึกการซื้อแต่ละครั้งเพียงครั้งเดียว	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 (แอป เว็บ)	เมื่อผู้ใช้มีส่วนร่วมกับแอปหรือเว็บไซต์ ระบบจะสร้างรหัสและหมายเลขสําหรับแต่ละเซสชันโดยอัตโนมัติ และจะเชื่อมโยงกับแต่ละเหตุการณ์ในเซสชัน ดูข้อมูลเพิ่มเติม	client_id, ga_session_id, ga_session_number, ignore_referrer, page_location, page_referrer, page_title, traffic_type
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