เหตุการณ์ในบันทึก

คู่มือนี้แสดงวิธีบันทึกเหตุการณ์ในแอป

Analytics จะบันทึกเหตุการณ์บางอย่างให้คุณโดยอัตโนมัติ คุณจึงไม่ต้องเพิ่มโค้ดใดๆ เพื่อรับเหตุการณ์เหล่านั้น หากแอปจําเป็นต้องรวบรวมข้อมูลเพิ่มเติม คุณสามารถบันทึกประเภทเหตุการณ์ Analytics ที่ต่างกันได้สูงสุด 500 ประเภทในแอป โดยไม่มีขีดจํากัดของจํานวนเหตุการณ์ทั้งหมดที่แอปบันทึก โปรดทราบว่าชื่อเหตุการณ์จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ และการบันทึกเหตุการณ์ 2 รายการที่มีชื่อเหมือนกันแต่ต่างกันที่ตัวพิมพ์เล็กและตัวพิมพ์ใหญ่จะส่งผลให้ระบบบันทึกเหตุการณ์ 2 รายการแยกกัน

ก่อนเริ่มต้น

ตรวจสอบว่าคุณได้ตั้งค่าโปรเจ็กต์และเข้าถึง Analytics ได้ตามที่อธิบายไว้ในเริ่มต้นใช้งาน Analytics

เหตุการณ์บันทึก

หลังจากสร้างอินสแตนซ์ FirebaseAnalytics แล้ว คุณจะใช้อินสแตนซ์ดังกล่าวเพื่อบันทึกเหตุการณ์ด้วยเมธอด log ของไลบรารีได้

เหตุการณ์ที่กําหนดไว้ล่วงหน้า

Analytics SDK กําหนดเหตุการณ์ที่แนะนําจํานวนหนึ่งซึ่งพบได้ทั่วไปในแอปประเภทต่างๆ เพื่อช่วยให้คุณเริ่มต้นใช้งานได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับเหตุการณ์เหล่านี้และกรณีที่ควรใช้ได้ที่เหตุการณ์ที่แนะนํา

คุณดูเมธอดบันทึกสําหรับประเภทเหตุการณ์ที่แนะนําได้ในเอกสารอ้างอิง API

ตัวอย่างต่อไปนี้แสดงวิธีบันทึกเหตุการณ์ select_content

await FirebaseAnalytics.instance.logSelectContent(
    contentType: "image",
    itemId: itemId,
);

หรือจะบันทึกเหตุการณ์เดียวกันโดยใช้ logEvent() ก็ได้ โดยทำดังนี้

await FirebaseAnalytics.instance.logEvent(
    name: "select_content",
    parameters: {
        "content_type": "image",
        "item_id": itemId,
    },
);

ซึ่งจะมีประโยชน์หากคุณต้องการระบุพารามิเตอร์เพิ่มเติมนอกเหนือจากพารามิเตอร์ที่ระบุ (ต้องระบุ) คุณเพิ่มพารามิเตอร์ต่อไปนี้ในเหตุการณ์ใดก็ได้

พารามิเตอร์ที่กําหนดเอง: พารามิเตอร์ที่กําหนดเองสามารถใช้เป็นมิติข้อมูลหรือเมตริกในรายงาน Analytics คุณสามารถใช้มิติข้อมูลที่กําหนดเองสําหรับข้อมูลพารามิเตอร์เหตุการณ์ที่ไม่ใช่ตัวเลข และเมตริกที่กําหนดเองสําหรับข้อมูลพารามิเตอร์ที่แสดงเป็นตัวเลขได้ดีกว่า หลังจากบันทึกพารามิเตอร์ที่กําหนดเองโดยใช้ SDK แล้ว ให้บันทึกมิติข้อมูลหรือเมตริกเพื่อให้แน่ใจว่าพารามิเตอร์ที่กําหนดเองเหล่านั้นจะปรากฏในรายงาน Analytics โดยทําดังนี้ Analytics > เหตุการณ์ > จัดการคําจํากัดความที่กําหนดเอง > สร้างมิติข้อมูลที่กําหนดเอง

พารามิเตอร์ที่กําหนดเองสามารถใช้ในการกําหนดกลุ่มเป้าหมายซึ่งอาจนําไปใช้กับทุกรายงานได้ พารามิเตอร์ที่กำหนดเองจะรวมอยู่ในข้อมูลที่ส่งออกไปยัง BigQuery ด้วยหากแอปลิงก์กับโปรเจ็กต์ BigQuery ดูตัวอย่างการค้นหาและอีกมากมายได้ที่ BigQuery Export ของ Google Analytics 4
พารามิเตอร์ value: พารามิเตอร์สําหรับวัตถุประสงค์ทั่วไปที่มีประโยชน์ในการรวบรวมเมตริกหลักที่เกี่ยวข้องกับเหตุการณ์ เช่น รายได้ ระยะทาง เวลา และคะแนน
ชื่อพารามิเตอร์มีความยาวได้สูงสุด 40 อักขระ โดยต้องขึ้นต้นด้วยอักขระที่เป็นตัวอักษรและประกอบด้วยอักขระที่เป็นตัวอักษรและตัวเลขคละกันและขีดล่างเท่านั้น ระบบรองรับประเภทสตริงและตัวเลข ค่าพารามิเตอร์สตริงมีความยาวได้สูงสุด 100 อักขระ คำนำหน้า "firebase", "google" และ "ga_" เป็นคำนำหน้าที่สงวนไว้และไม่ควรใช้สำหรับชื่อพารามิเตอร์

เหตุการณ์ที่กำหนดเอง

หากแอปพลิเคชันมีความต้องการเฉพาะที่ไม่ได้ครอบคลุมโดยประเภทเหตุการณ์ที่แนะนํา คุณสามารถบันทึกเหตุการณ์ที่กําหนดเองของคุณเองได้ดังที่แสดงในตัวอย่างนี้

await FirebaseAnalytics.instance.logEvent(
    name: "share_image",
    parameters: {
        "image_name": name,
        "full_text": text,
    },
);

ตั้งค่าพารามิเตอร์เหตุการณ์เริ่มต้น

คุณสามารถบันทึกพารามิเตอร์ในเหตุการณ์ต่างๆ ได้โดยใช้ setDefaultEventParameters() พารามิเตอร์เริ่มต้นจะเชื่อมโยงกับเหตุการณ์ในอนาคตทั้งหมดที่บันทึกไว้

เช่นเดียวกับพารามิเตอร์ที่กําหนดเอง ให้บันทึกพารามิเตอร์เหตุการณ์เริ่มต้นเพื่อให้ปรากฏในรายงาน Analytics

ค่าพารามิเตอร์ที่ใช้ได้มีสตริงและตัวเลข การตั้งค่าของคีย์เป็น nullจะเป็นการล้างพารามิเตอร์นั้น การส่งค่า Null จะล้างพารามิเตอร์ทั้งหมด

// Not supported on web
await FirebaseAnalytics.instance
  .setDefaultEventParameters({
    version: '1.2.3'
  });

หากระบุพารามิเตอร์ในเมธอด logEvent() หรือ log ระบบจะใช้ค่านั้นแทนค่าเริ่มต้น

หากต้องการล้างพารามิเตอร์เริ่มต้น ให้เรียกใช้setDefaultEventParameters()วิธีที่มีการตั้งค่าพารามิเตอร์เป็น null

ดูเหตุการณ์ในหน้าแดชบอร์ด

คุณสามารถดูสถิติแบบรวมเกี่ยวกับกิจกรรมในFirebaseแดชบอร์ดคอนโซล แดชบอร์ดเหล่านี้จะอัปเดตเป็นระยะตลอดทั้งวัน หากต้องการทดสอบทันที ให้ใช้เอาต์พุต logcat ตามที่อธิบายไว้ในส่วนก่อนหน้า

คุณสามารถเข้าถึงข้อมูลนี้ได้จากแดชบอร์ดเหตุการณ์ในคอนโซล Firebase แดชบอร์ดนี้แสดงรายงานเหตุการณ์ที่สร้างขึ้นโดยอัตโนมัติสําหรับเหตุการณ์แต่ละประเภทที่แตกต่างกันซึ่งบันทึกโดยแอป