Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

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

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

ก่อนจะเริ่ม

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

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

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

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

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

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

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

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

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

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

  1. นำเข้าโมดูล Firebase ในของคุณ UIApplicationDelegate :

    Swift

    import Firebase

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

    @import Firebase;
  2. กำหนดค่า FirebaseApp ที่ใช้ร่วมกันเช่นปกติในของแอป application:didFinishLaunchingWithOptions: วิธีการ:

    Swift

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

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

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


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

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

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

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

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

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

Swift

หมายเหตุ: สินค้า 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 เลือกสินค้า> โครงการ> แก้ไขรูปแบบ ...
  2. เลือกเรียกใช้จากเมนูด้านซ้าย
  3. เลือกข้อโต้แย้งแท็บ
  4. ในการขัดแย้งที่ผ่านมาในส่วนของการเปิดตัวเพิ่ม -FIRAnalyticsDebugEnabled

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