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

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

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

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

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

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

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

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

หลังจากสร้างอินสแตนซ์ 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 ดูตัวอย่างการค้นหาและอื่นๆ อีกมากมาย ได้ที่ Google Analytics 4 BigQuery Export

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