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

ระบบจะทริกเกอร์เหตุการณ์ที่รวบรวมโดยอัตโนมัติเมื่อมีการโต้ตอบทั่วไปกับแอปและ/หรือเว็บไซต์ (ตามที่ระบุไว้ใต้ชื่อของเหตุการณ์ในตารางด้านล่าง) ตราบใดที่คุณใช้ SDK ของ Google Analytics สําหรับ Firebase หรือ gtag.js ก็ไม่จําเป็นต้องเขียนโค้ดใดๆ เพิ่มเพื่อรวบรวมเหตุการณ์เหล่านี้

Analytics จะรวบรวมเหตุการณ์สำหรับแอป Android และ iOS เว้นแต่จะระบุไว้เป็นอย่างอื่น ชื่อและพารามิเตอร์ของเหตุการณ์เหล่านี้จะมีประโยชน์เมื่อเข้าถึงข้อมูลเหตุการณ์ดิบใน BigQuery

หากต้องการทราบเกี่ยวกับพารามิเตอร์เหตุการณ์แต่ละรายการที่แสดงด้านล่าง และวิธีที่พารามิเตอร์แต่ละรายการอัปเดตมิติข้อมูลหรือเมตริกใน Google Analytics โปรดดูพารามิเตอร์เหตุการณ์ Google Analytics

หมายเหตุ

ระบบจะรวบรวมพารามิเตอร์ต่อไปนี้โดยค่าเริ่มต้นสําหรับทุกเหตุการณ์ รวมถึงเหตุการณ์ที่กำหนดเอง

  • language
  • page_location
  • page_referrer
  • page_title
  • screen_resolution

ค่าที่กําหนดให้กับพารามิเตอร์เหตุการณ์ต้องมีอักขระไม่เกิน 100 ตัว พารามิเตอร์ page_title ต้องมีอักขระไม่เกิน 300 ตัว พารามิเตอร์ page_referrer ต้องมีอักขระไม่เกิน 420 ตัว พารามิเตอร์ page_location ต้องมีอักขระไม่เกิน 1,000 ตัว

หากคุณลบล้างพารามิเตอร์ page_location ให้ตรวจสอบว่าเส้นทาง URL ถูกต้อง หากคุณกําหนดเส้นทาง URL ไม่ถูกต้อง มิติข้อมูลตําแหน่งหน้าเว็บจะว่างเปล่า คุณสามารถใช้เครื่องมือสร้าง URL ของแคมเปญเพื่อตรวจสอบว่าเส้นทาง URL ถูกต้องหรือไม่

เหตุการณ์ ทริกเกอร์อัตโนมัติ... พารามิเตอร์

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 เท่านั้น

เหตุการณ์นี้แตกต่างจากเมตริกจำนวนการถอนการติดตั้งรายวันตามอุปกรณ์และจำนวนการถอนการติดตั้งรายวันตามผู้ใช้ ซึ่งเมตริกทั้งสองนี้รายงานโดย 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

click

(เว็บ)

ทุกครั้งที่ผู้ใช้คลิกลิงก์ที่นำออกจากโดเมนปัจจุบัน

โดยค่าเริ่มต้น กิจกรรมการคลิกขาออกจะเกิดขี้นกับทุกลิงก์ที่นำออกไปจากโดเมนปัจจุบัน ลิงก์ไปที่โดเมนซึ่งกำหนดค่าไว้สำหรับการวัดผลแบบข้ามโดเมนจะไม่เรียกให้แสดงกิจกรรมการคลิกขาออก

พารามิเตอร์จะป้อนมิติข้อมูลต่อไปนี้

รวบรวมโดยค่าเริ่มต้นด้วยการวัดที่ปรับปรุงแล้ว

link_classes, link_domain, link_id, link_url, outbound (บูลีน)

เมื่อผู้ใช้เปิดแอปอีกครั้งผ่านลิงก์แบบไดนามิก

หมายเหตุ: เรากําลังจะเลิกใช้เหตุการณ์นี้เนื่องจากลิงก์แบบไดนามิกของ Firebase ได้ถูกเลิกใช้งานแล้ว ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงเหล่านี้

source, medium, campaign, link_id, accept_time

เมื่อมีการอัปเดตแอปเป็นเวอร์ชันใหม่และเปิดผ่านลิงก์แบบไดนามิก

Android เท่านั้น

หมายเหตุ: เรากําลังจะเลิกใช้เหตุการณ์นี้เนื่องจากลิงก์แบบไดนามิกของ Firebase ได้ถูกเลิกใช้งานแล้ว ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงเหล่านี้

source, medium, campaign, link_id, accept_time

เมื่อผู้ใช้เปิดแอปเป็นครั้งแรกผ่านลิงก์แบบไดนามิก

หมายเหตุ: เรากําลังจะเลิกใช้เหตุการณ์นี้เนื่องจากลิงก์แบบไดนามิกของ Firebase ได้ถูกเลิกใช้งานแล้ว ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงเหล่านี้

source, medium, campaign, link_id, accept_time

error

(แอป)

บันทึกแทนเหตุการณ์ที่บันทึกไม่ได้เนื่องจากไม่ถูกต้องในลักษณะใดลักษณะหนึ่ง

พารามิเตอร์ _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

(แอป)

เมื่อผู้ใช้ดำเนินการกับข้อความในแอป 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

* มีการส่งค่า no_ad_impression หรือสกุลเงินพร้อมการผสานรวมที่เป็นค่าเริ่มต้น

ข้อมูลนี้มีประโยชน์ไหม

เราจะปรับปรุงได้อย่างไร
ค้นหา
ล้างการค้นหา
ปิดการค้นหา
แอป Google
เมนูหลัก