Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

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

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

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

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

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

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

ก่อนที่คุณจะเริ่มต้น

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

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

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

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

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

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

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

  1. ใน Xcode เมื่อโปรเจ็กต์แอปของคุณเปิดอยู่ ให้ไปที่ File > Add Packages
  2. เมื่อได้รับแจ้ง ให้เพิ่มที่เก็บ Firebase Apple platforms SDK:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. เลือกไลบรารี Analytics
  5. เพื่อประสบการณ์ที่ดีที่สุดกับ Analytics เราขอแนะนำให้ เปิดใช้ Google Analytics ในโครงการ Firebase และเพิ่ม Firebase SDK สำหรับ Google Analytics ลงในแอปของคุณ คุณสามารถเลือกห้องสมุดที่ไม่มีการรวบรวม IDFA หรือมีการรวบรวม IDFA
  6. เมื่อเสร็จแล้ว Xcode จะเริ่มแก้ไขและดาวน์โหลดการอ้างอิงของคุณโดยอัตโนมัติในเบื้องหลัง

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

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

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

    SwiftUI

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    สวิฟต์

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

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

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

    SwiftUI

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

    สวิฟต์

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

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

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. หากคุณใช้ SwiftUI คุณต้องสร้างตัวแทนแอปพลิเคชันและแนบกับโครงสร้าง App ของคุณผ่าน UIApplicationDelegateAdaptor หรือ NSApplicationDelegateAdaptor คุณต้องปิดใช้งานการ swizzling ของผู้รับมอบสิทธิ์แอปด้วย สำหรับข้อมูลเพิ่มเติม โปรดดู คำแนะนำ SwiftUI

    SwiftUI

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          


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

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

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

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

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

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

สวิฟต์

หมายเหตุ: ผลิตภัณฑ์ Firebase นี้ไม่พร้อมใช้งานบนเป้าหมาย macOS
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

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

หมายเหตุ: ผลิตภัณฑ์ Firebase นี้ไม่พร้อมใช้งานบนเป้าหมาย macOS
[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. ในส่วน Arguments Passed On Launch ให้เพิ่ม -FIRAnalyticsDebugEnabled

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

ตัวยึดตำแหน่ง 136 ,

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

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

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

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

ก่อนที่คุณจะเริ่มต้น

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

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

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

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

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

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

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

  1. ใน Xcode เมื่อโปรเจ็กต์แอปของคุณเปิดอยู่ ให้ไปที่ File > Add Packages
  2. เมื่อได้รับแจ้ง ให้เพิ่มที่เก็บ Firebase Apple platforms SDK:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. เลือกไลบรารี Analytics
  5. เพื่อประสบการณ์ที่ดีที่สุดกับ Analytics เราขอแนะนำให้ เปิดใช้ Google Analytics ในโครงการ Firebase และเพิ่ม Firebase SDK สำหรับ Google Analytics ลงในแอปของคุณ คุณสามารถเลือกห้องสมุดที่ไม่มีการรวบรวม IDFA หรือมีการรวบรวม IDFA
  6. เมื่อเสร็จแล้ว Xcode จะเริ่มแก้ไขและดาวน์โหลดการอ้างอิงของคุณโดยอัตโนมัติในเบื้องหลัง

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

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

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

    SwiftUI

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    สวิฟต์

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

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

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

    SwiftUI

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

    สวิฟต์

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

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

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. หากคุณใช้ SwiftUI คุณต้องสร้างตัวแทนแอปพลิเคชันและแนบกับโครงสร้าง App ของคุณผ่าน UIApplicationDelegateAdaptor หรือ NSApplicationDelegateAdaptor คุณต้องปิดใช้งานการ swizzling ของผู้รับมอบสิทธิ์แอปด้วย สำหรับข้อมูลเพิ่มเติม โปรดดู คำแนะนำ SwiftUI

    SwiftUI

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          


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

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

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

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

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

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

สวิฟต์

หมายเหตุ: ผลิตภัณฑ์ Firebase นี้ไม่พร้อมใช้งานบนเป้าหมาย macOS
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

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

หมายเหตุ: ผลิตภัณฑ์ Firebase นี้ไม่พร้อมใช้งานบนเป้าหมาย macOS
[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. ในส่วน Arguments Passed On Launch ให้เพิ่ม -FIRAnalyticsDebugEnabled

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

ตัวยึดตำแหน่ง 136