เริ่มต้นใช้งาน Google Analytics สําหรับ iOS+

เลือกแพลตฟอร์ม iOS+ Android เว็บ Flutter Unity C++


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

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

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

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

หากต้องการความช่วยเหลือจาก AI ให้คัดลอกพรอมต์ด้านล่างลงใน Agent การเขียนโค้ด AI (เช่น Antigravity, Claude Code, Codex และ Cursor) คุณสามารถปรับแต่งพรอมต์และทำซ้ำกับ Agent ได้ ดูข้อมูลการติดตั้งโดยละเอียดได้ที่ทักษะเอเจนต์ Firebase 

Help me use Firebase in my app.
1. Make sure that **Firebase agent skills** are installed and updated. For Claude Code, Codex, or Cursor agents, help me install the Firebase plugin. For other agents, run `npx skills add firebase/agent-skills`.  Always try to use **Firebase agent skills** for Firebase-related tasks.
2. Help me set up Google Analytics for Firebase and log screen view events in my app.

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

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

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

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

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

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

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

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

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

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

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

  1. นำเข้าโมดูล FirebaseCore ใน UIApplicationDelegate รวมถึงโมดูล Firebase อื่นๆ ที่ App Delegate ของคุณใช้ ตัวอย่างเช่น หากต้องการใช้ 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;
// ...
  2. กำหนดค่าอินสแตนซ์ที่ใช้ร่วมกันของ FirebaseApp ในเมธอด application(_:didFinishLaunchingWithOptions:) ของ App Delegate ดังนี้

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

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

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

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

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