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

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

Google Analytics จะรวบรวมข้อมูลการใช้งานและพฤติกรรมของแอป SDK จะบันทึกข้อมูล 2 ประเภทหลัก ได้แก่

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

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

ก่อนเริ่มต้น

เพิ่ม Firebase ในโปรเจ็กต์ Apple หากยังไม่ได้ทำ และดูว่าได้เปิดใช้ Google Analytics ใน Firebase แล้ว โปรเจ็กต์:
- หากคุณกำลังสร้างโปรเจ็กต์ Firebase ใหม่ ให้เปิดใช้ Google Analytics ในระหว่างขั้นตอนการสร้างโปรเจ็กต์
- หากคุณกำลังใช้โปรเจ็กต์ Firebase ที่มีอยู่ซึ่งไม่มี เปิดใช้ Google Analytics แล้ว ให้ไปที่ การผสานรวม ของ > การตั้งค่าโปรเจ็กต์เพื่อเปิดใช้
คำเตือน: โปรเจ็กต์ Firebase ที่สร้างขึ้นก่อนวันที่ 31 กรกฎาคม 2019 ต้องอัปเกรดเป็น เต็ม ประสบการณ์การใช้งาน Google Analytics 4 หากยังไม่ได้ดำเนินการ (แบนเนอร์จะแสดงในแดชบอร์ด Analytics หาก จำเป็นต้องอัปเกรด) ข้อกำหนดในการให้บริการที่เกี่ยวข้องต้อง ยอมรับภายในวันที่ 15 กุมภาพันธ์ 2022 ในการเก็บรวบรวมข้อมูลต่อไป โปรดดูคำถามที่พบบ่อยเกี่ยวกับการสนับสนุนเกี่ยวกับการอัปเกรดเพื่อรับความช่วยเหลือ ค้นหาเจ้าของโปรเจ็กต์

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

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

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

เปิดโปรเจ็กต์แอปใน Xcode แล้วไปที่ไฟล์ > เพิ่มแพ็กเกจ
เมื่อได้รับข้อความแจ้ง ให้เพิ่มที่เก็บ SDK สำหรับแพลตฟอร์ม Firebase ของ Apple ดังนี้

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

เลือกไลบรารี Analytics
เพิ่มแฟล็ก -ObjC ลงในส่วนแฟล็ก Linker อื่นๆ ของการตั้งค่าบิลด์ของเป้าหมาย
เพื่อให้ได้ประสบการณ์การใช้งาน Analytics ที่ดีที่สุด เราแนะนํา การเปิดใช้ Google Analytics ในโปรเจ็กต์ Firebase และเพิ่ม Firebase SDK สำหรับ Google Analytics ลงในแอป คุณสามารถ ให้เลือกไลบรารีที่ไม่มีการรวบรวม IDFA หรือมีคอลเล็กชัน IDFA
เมื่อเสร็จแล้ว Xcode จะเริ่มแก้ปัญหาและดาวน์โหลด ทรัพยากร Dependency ในเบื้องหลัง

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

จากนั้น ให้ทำตามขั้นตอนการกำหนดค่าต่อไปนี้

นำเข้าโมดูล FirebaseCore ใน UIApplicationDelegate และอื่นๆ โมดูล Firebase ที่ผู้รับมอบสิทธิ์แอปใช้ เช่น วิธีใช้ Cloud Firestore และ Authentication มีดังนี้
SwiftUI
```
import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
Swift
```
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
Objective-C
```
@import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
      
```

กําหนดค่า FirebaseApp อินสแตนซ์ที่แชร์ใน เมธอด application(_:didFinishLaunchingWithOptions:):

SwiftUI

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

Swift

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

Objective-C

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

หากใช้ SwiftUI คุณต้องสร้างการมอบสิทธิ์แอปพลิเคชันและแนบการมอบสิทธิ์ ไปยังโครงสร้าง App ของคุณผ่าน UIApplicationDelegateAdaptor หรือ NSApplicationDelegateAdaptor คุณต้องปิดใช้ SWizzing ที่มอบสิทธิ์ของแอปด้วย สำหรับ สำหรับข้อมูลเพิ่มเติม โปรดดูวิธีการของ 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 (บูลีน) ใน ไฟล์ info.plist ของแอป

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

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

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

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

Swift

หมายเหตุ: ผลิตภัณฑ์ Firebase นี้ใช้ไม่ได้กับเป้าหมาย macOS

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

Objective-C

หมายเหตุ: ผลิตภัณฑ์ Firebase นี้ใช้ไม่ได้กับเป้าหมาย macOS

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

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

ใน Xcode ให้เลือก Product > รูปแบบ > แก้ไขรูปแบบ...
เลือกเรียกใช้จากเมนูด้านซ้าย
เลือกแท็บอาร์กิวเมนต์
ในส่วนอาร์กิวเมนต์ที่ผ่านเมื่อเปิดตัว ให้เพิ่ม -FIRAnalyticsDebugEnabled

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

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