เริ่มต้นใช้งาน Google Analytics สำหรับ Flutter

เลือกแพลตฟอร์ม iOS+ Android Web Flutter Unity C++


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

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

  • เหตุการณ์: สิ่งที่เกิดขึ้นในแอป เช่น การกระทำของผู้ใช้ เหตุการณ์ของระบบ หรือข้อผิดพลาด
  • พร็อพเพอร์ตี้ผู้ใช้: แอตทริบิวต์ที่คุณกำหนดเพื่ออธิบายกลุ่มต่างๆ ในฐานผู้ใช้ เช่น ค่ากำหนดภาษาหรือสถานที่ตั้งทางภูมิศาสตร์

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

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

  1. ติดตั้ง firebase_core และเพิ่มโค้ดการเริ่มต้นลงในแอป หากยังไม่ได้ทำ

  2. ลงทะเบียนแอปในโปรเจ็กต์ Firebase โดยใช้คอนโซล Firebase

  3. (แนะนำ) เพิ่มเฟรมเวิร์ก AdSupport ลงในโปรเจ็กต์เพื่อเปิดใช้ฟีเจอร์เพิ่มเติม เช่น กลุ่มเป้าหมายและการระบุแหล่งที่มาของแคมเปญ

เพิ่ม Analytics SDK ลงในแอป

  1. จากรูทของโปรเจ็กต์ Flutter ให้เรียกใช้คำสั่งต่อไปนี้เพื่อติดตั้งปลั๊กอิน

    flutter pub add firebase_analytics

  2. เมื่อเสร็จแล้ว ให้สร้างแอปพลิเคชัน Flutter อีกครั้งโดยทำดังนี้

    flutter run

  3. เมื่อติดตั้งแล้ว คุณจะเข้าถึงปลั๊กอิน firebase_analytics ได้โดยการนำเข้าในโค้ด Dart ดังนี้

    import 'package:firebase_analytics/firebase_analytics.dart';

  4. สร้างอินสแตนซ์ Firebase Analytics ใหม่โดยเข้าถึงพร็อพเพอร์ตี้ instance ใน FirebaseAnalytics ดังนี้

    FirebaseAnalytics analytics = FirebaseAnalytics.instance;

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

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

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

โค้ดต่อไปนี้จะบันทึกเหตุการณ์การชําระเงิน

await FirebaseAnalytics.instance
  .logBeginCheckout(
    value: 10.0,
    currency: 'USD',
    items: [
      AnalyticsEventItem(
        itemName: 'Socks',
        itemId: 'xjw73ndnw',
        price: '10.0'
      ),
    ],
    coupon: '10PERCENTOFF'
  );

ขั้นตอนถัดไป