Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

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

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

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

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

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

ก่อนจะเริ่ม

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

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

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

    เมื่อคุณเปิดใช้ 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()

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

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

Swift

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

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

[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

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