หน้านี้ได้รับการแปลโดย Cloud Translation API

Switch to English

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

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

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

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

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 เพื่อติดตั้งและจัดการการอ้างอิง Firebase

ใน Xcode เมื่อโปรเจ็กต์แอปของคุณเปิดอยู่ ให้ไปที่ File > Add Packages
เมื่อได้รับแจ้ง ให้เพิ่มที่เก็บ Firebase Apple platforms SDK:

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

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

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

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

นำเข้าโมดูล 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;
// ...
      
```
กำหนดค่าอินสแตนซ์ที่ใช้ร่วมกันของ 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];
```
หากคุณใช้ 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",
])ViewController.swift

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

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

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

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

ใน Xcode เลือก Product > Scheme > Edit scheme...
เลือก เรียกใช้ จากเมนูด้านซ้าย
เลือกแท็บ อาร์กิวเมนต์
ในส่วน Arguments Passed On Launch ให้เพิ่ม -FIRAnalyticsDebugEnabled

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

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

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

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

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

หากคุณยังไม่ได้ดำเนินการ ให้ เพิ่ม 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 เพื่อติดตั้งและจัดการการอ้างอิง Firebase

ใน Xcode เมื่อโปรเจ็กต์แอปของคุณเปิดอยู่ ให้ไปที่ File > Add Packages
เมื่อได้รับแจ้ง ให้เพิ่มที่เก็บ Firebase Apple platforms SDK:

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

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

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

นำเข้าโมดูล 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;
// ...
      
```
กำหนดค่าอินสแตนซ์ที่ใช้ร่วมกันของ 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];
```
หากคุณใช้ 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

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

สวิฟต์

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

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

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

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

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

ใน Xcode เลือก Product > Scheme > Edit scheme...
เลือก เรียกใช้ จากเมนูด้านซ้าย
เลือกแท็บ อาร์กิวเมนต์
ในส่วน Arguments Passed On Launch ให้เพิ่ม -FIRAnalyticsDebugEnabled

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

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

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

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

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

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

SwiftUI

สวิฟต์

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

SwiftUI

สวิฟต์

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

SwiftUI

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

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

สวิฟต์

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

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

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

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

SwiftUI

สวิฟต์

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

SwiftUI

สวิฟต์

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

SwiftUI

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

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

สวิฟต์

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

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