เริ่มต้นใช้งาน Google Analytics

iOS+ Android Web Flutter

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

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

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

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

ก่อนจะเริ่ม

1. หากคุณยังไม่ได้ดำเนินการ ให้ เพิ่ม Firebase ในโครงการ Apple ของคุณ และตรวจสอบให้แน่ใจว่าได้เปิดใช้งาน Google Analytics ในโครงการ Firebase ของคุณ:

   • หากคุณกำลังสร้างโปรเจ็กต์ Firebase ใหม่ ให้เปิดใช้ Google Analytics ระหว่างเวิร์กโฟลว์การสร้างโปรเจ็กต์

   • หากคุณกำลังใช้โปรเจ็กต์ Firebase ที่มีอยู่ซึ่งไม่ได้เปิดใช้งาน Google Analytics ให้ไปที่แท็บ การผสานการ ทำงานของ settings > การ ตั้งค่าโปรเจ็ กต์เพื่อเปิดใช้งาน

   เมื่อคุณเปิดใช้ Google Analytics ในโครงการ แอป Firebase จะลิงก์กับสตรีมข้อมูล Google Analytics

2. (แนะนำ) . เพิ่มเฟรมเวิร์ก AdSupport ในโครงการของคุณ เพื่อเปิดใช้งานคุณลักษณะเพิ่มเติม เช่น ผู้ชมและการระบุแหล่งที่มาของแคมเปญ

เพิ่ม Analytics SDK ในแอปของคุณ

ใช้ Swift Package Manager เพื่อติดตั้งและจัดการการขึ้นต่อกันของ Firebase

1. ใน Xcode เมื่อโปรเจ็กต์แอปของคุณเปิดอยู่ ให้ไปที่ File > Add Packages
2. เมื่อได้รับแจ้ง ให้เพิ่มที่เก็บ SDK ของแพลตฟอร์ม Firebase Apple:

  https://github.com/firebase/firebase-ios-sdk

3. เลือกไลบรารี Analytics
4. เพื่อประสบการณ์ที่ดีที่สุดกับ Analytics เราขอแนะนำให้ เปิดใช้ Google Analytics ในโปรเจ็กต์ Firebase และเพิ่ม Firebase SDK สำหรับ Google Analytics ในแอปของคุณ คุณสามารถเลือกไลบรารีที่ไม่มีคอลเลกชัน IDFA หรือคอลเลกชัน IDFA
5. เมื่อเสร็จแล้ว Xcode จะเริ่มแก้ไขและดาวน์โหลดการพึ่งพาของคุณในพื้นหลังโดยอัตโนมัติ

เรียนรู้เพิ่มเติมเกี่ยวกับ IDFA ซึ่งเป็นตัวระบุโฆษณาระดับอุปกรณ์ ในเอกสาร ความเป็นส่วนตัวของผู้ใช้และการใช้ข้อมูล ของ Apple และ ความโปร่งใสในการติดตาม แอปของ Apple

ถัดไป ดำเนินการขั้นตอนการกำหนดค่าบางอย่าง:

1. นำเข้าโมดูล FirebaseCore ใน UIApplicationDelegate ของคุณ รวมถึง โมดูล Firebase อื่นๆ ที่ผู้รับมอบสิทธิ์แอปของคุณใช้ ตัวอย่างเช่น ในการใช้ Cloud Firestore และการตรวจสอบสิทธิ์:

   Swift

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   วัตถุประสงค์-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. กำหนดค่าอินสแตนซ์ที่ใช้ร่วมกันของ FirebaseApp ใน application(_:didFinishLaunchingWithOptions:) ของผู้รับมอบสิทธิ์แอปของคุณ:

   Swift

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   วัตถุประสงค์-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

(ไม่บังคับ) ปิดใช้งานการลงทะเบียนการระบุแหล่งที่มาของเครือข่ายโฆษณาของ Apple

เพื่อความสะดวกของคุณ SDK จะ ลงทะเบียน แอปของคุณกับ Apple โดยอัตโนมัติสำหรับการระบุแหล่งที่มาของเครือข่ายโฆษณาด้วย SKAdNetwork หากคุณต้องการปิดใช้งานคุณลักษณะนี้ ให้ตั้งค่า GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED เป็น NO (บูลีน) ในไฟล์ info.plist ของแอป

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

หลังจากที่คุณกำหนดค่าอินสแตนซ์ FirebaseApp แล้ว คุณสามารถเริ่มบันทึกเหตุการณ์ด้วย logEvent()

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

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

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])
ViewController.swift

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];
ViewController.m

หากต้องการดูเหตุการณ์นี้ในคอนโซลดีบัก Xcode ให้เปิดใช้งานการดีบัก Analytics:

1. ใน Xcode เลือก ผลิตภัณฑ์ > โครงการ > แก้ไขรูปแบบ...
2. เลือก เรียกใช้ จากเมนูด้านซ้าย
3. เลือกแท็บ อาร์กิวเมนต์
4. ในส่วน อาร์กิวเมนต์ที่ส่งต่อเมื่อเปิด ใช้ ให้เพิ่ม -FIRAnalyticsDebugEnabled

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

• ใช้ DebugView เพื่อตรวจสอบกิจกรรมของคุณ
• สำรวจข้อมูลของคุณใน คอนโซล Firebase
• สำรวจคำแนะนำเกี่ยวกับ เหตุการณ์ และ คุณสมบัติของผู้ใช้
• เรียนรู้วิธีส่งออกข้อมูลของคุณไปยัง BigQuery