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

เลือกแพลตฟอร์ม:

iOS+ Android เว็บ Flutter Unity C++

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

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

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

หากต้องการรวบรวมข้อมูลการระบุแหล่งที่มาของแคมเปญสําหรับแอปแพลตฟอร์ม Apple โปรดเพิ่มเฟรมเวิร์ก AdSupport ลงในโปรเจ็กต์

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

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

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

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

คุณดูวิธีการบันทึกสำหรับประเภทเหตุการณ์ที่แนะนำได้ในเอกสารอ้างอิง 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

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

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

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

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