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

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

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

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

ก่อนจะเริ่ม

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

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

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

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

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

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

1. เพิ่มการพึ่งพา Firebase ให้กับ Podfile ของคุณ:

   pod 'Firebase/Analytics'
   
   # For Analytics without IDFA collection capability, use this pod instead
   # pod ‘Firebase/AnalyticsWithoutAdIdSupport’
   

   เรียนรู้เพิ่มเติมเกี่ยวกับ IDFA ตัวระบุโฆษณาระดับอุปกรณ์ ในเอกสารเกี่ยวกับ ความเป็นส่วนตัว ของ ผู้ใช้และการใช้ข้อมูล ของ Apple และ ความโปร่งใสในการติดตามแอป
2. เรียกใช้การ pod install และเปิดไฟล์ . .xcworkspace สร้างขึ้น
3. นำเข้าโมดูล Firebase ใน UIApplicationDelegate ของคุณ:

   Swift

   import Firebase

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

   @import Firebase;

4. กำหนดค่าอินสแตนซ์ที่ใช้ร่วมกันของ 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"
  ])

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

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

1. ใน Xcode เลือก Product > Scheme > Edit scheme...
2. เลือก เรียกใช้ จากเมนูด้านซ้าย
3. เลือกแท็บ อาร์กิวเมนต์
4. ในส่วน อาร์กิวเมนต์ที่ส่งต่อเมื่อเปิด ใช้ ให้เพิ่ม -FIRAnalyticsDebugEnabled

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

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