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

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


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

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

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

คุณเข้าถึงข้อมูลนี้ได้ในหน้า Analytics ของคอนโซล Firebase

หน้าการวิเคราะห์ > เหตุการณ์จะแสดงรายงานเหตุการณ์ที่สร้างขึ้นโดยอัตโนมัติสำหรับเหตุการณ์ 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);

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