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

เลือกแพลตฟอร์ม: iOS+ Android เว็บ Flutter Unity C++

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

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

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

วิธีเข้าถึงข้อมูลนี้

  1. ในคอนโซล Firebase เปิดโปรเจ็กต์
  2. เลือก Analytics จากเมนูเพื่อดูแดชบอร์ดการรายงาน Analytics

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

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

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

คุณต้องดำเนินการต่อไปนี้ก่อนจึงจะใช้ Google Analytics, ได้

  • ลงทะเบียนโปรเจ็กต์ C++ และกำหนดค่าให้ใช้ Firebase

    หากโปรเจ็กต์ C++ ใช้ Firebase อยู่แล้ว แสดงว่าโปรเจ็กต์นั้นได้ลงทะเบียนและกำหนดค่าสำหรับ Firebase แล้ว

  • เพิ่ม Firebase C++ SDK ลงในโปรเจ็กต์ C++

โปรดทราบว่าการเพิ่ม Firebase ลงในโปรเจ็กต์ C++ เกี่ยวข้องกับงานทั้งใน Firebaseคอนโซลและในโปรเจ็กต์ C++ ที่เปิดอยู่ (เช่น คุณดาวน์โหลด ไฟล์กำหนดค่า Firebase จากคอนโซล แล้วย้ายไฟล์เหล่านั้นไปยังโปรเจ็กต์ C++)

สร้างและเริ่มต้นใช้งานแอป Firebase

คุณต้องสร้างและเริ่มต้นใช้งานแอป Firebase ก่อนที่จะเริ่ม

iOS+

สร้างแอป Firebase โดยทำดังนี้

app = ::firebase::App::Create(::firebase::AppOptions());

เริ่มต้นใช้งานไลบรารี Analytics โดยทำดังนี้ 

::firebase::analytics::Initialize(app);

Android

สร้างแอป Firebase โดยส่งผ่านสภาพแวดล้อม JNI และการอ้างอิง jobject ไปยังกิจกรรม Java เป็นอาร์กิวเมนต์ โดยทำดังนี้

app = ::firebase::App::Create(::firebase::AppOptions(), jni_env, activity);

เริ่มต้นใช้งานไลบรารี Analytics โดยทำดังนี้ 

::firebase::analytics::Initialize(app);

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

หลังจากกำหนดค่าอินสแตนซ์ firebase::App แล้ว คุณจะ เริ่มบันทึกเหตุการณ์ด้วยเมธอด LogEvent() ได้

ตัวอย่างต่อไปนี้จะอัปเดตคะแนนของผู้ใช้

analytics::LogEvent(analytics::kEventPostScore, analytics::kParameterScore, 42);

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