Phần hướng dẫn nhanh này cho bạn biết cách thêm Google Analytics vào ứng dụng và bắt đầu ghi nhật ký sự kiện.
Google Analytics thu thập dữ liệu về hành vi và mức sử dụng cho ứng dụng của bạn. SDK ghi lại hai loại thông tin chính:
- Sự kiện: Những gì đang diễn ra trong ứng dụng, chẳng hạn như thao tác của người dùng, các sự kiện của hệ thống hoặc lỗi.
- Thuộc tính người dùng: Những thuộc tính mà bạn xác định để mô tả các phân khúc trong cơ sở người dùng, chẳng hạn như lựa chọn ưu tiên về ngôn ngữ hoặc vị trí địa lý.
Analytics tự động ghi lại một số sự kiện và thuộc tính người dùng; bạn không cần thêm mã nào để bật những thuộc tính này.
Trước khi bắt đầu
Nếu bạn chưa thực hiện, hãy thêm Firebase vào dự án Apple và đảm bảo rằng bạn đã bật Google Analytics trong dự án Firebase:
Nếu bạn đang tạo dự án Firebase mới, hãy bật Google Analytics trong quy trình tạo dự án.
Nếu bạn đang sử dụng một dự án Firebase hiện có chưa bật Google Analytics, hãy chuyển đến thẻ Tích hợp của
để bật tính năng này. > Cài đặt dự án
Khi bạn bật Google Analytics trong dự án, các ứng dụng Firebase của bạn sẽ được liên kết với luồng dữ liệu Google Analytics.
(Nên dùng). Thêm khung AdSupport vào dự án của bạn để bật các tính năng bổ sung như đối tượng và mô hình phân bổ chiến dịch.
Thêm SDK Analytics vào ứng dụng
Sử dụng Trình quản lý gói Swift để cài đặt và quản lý các phần phụ thuộc Firebase.
- Trong Xcode, khi dự án ứng dụng đang mở, hãy chuyển đến File > Add Packages (Tệp > Thêm gói).
- Khi được nhắc, hãy thêm kho lưu trữ SDK của các nền tảng Apple Firebase:
- Chọn thư viện Analytics.
- Thêm cờ
-ObjC
vào phần Other Linker Flags (Cờ trình liên kết khác) trong phần cài đặt bản dựng của mục tiêu. - Để có trải nghiệm tối ưu với Analytics, bạn nên bật Google Analytics trong dự án Firebase và thêm SDK Firebase cho Google Analytics vào ứng dụng. Bạn có thể chọn thư viện không có tính năng thu thập IDFA hoặc có tính năng thu thập IDFA.
- Khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải các phần phụ thuộc xuống ở chế độ nền.
https://github.com/firebase/firebase-ios-sdk.git
Tìm hiểu thêm về IDFA, mã nhận dạng cho quảng cáo ở cấp thiết bị, trong tài liệu của Apple về Quyền riêng tư của người dùng và việc sử dụng dữ liệu và Minh bạch về việc theo dõi ứng dụng.
Tiếp theo, hãy thực hiện một số bước định cấu hình:
- Nhập mô-đun
FirebaseCore
trongUIApplicationDelegate
, cũng như mọi mô-đun Firebase khác mà ứng dụng của bạn sử dụng. Ví dụ: để sử dụng Cloud Firestore và 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; // ...
- Định cấu hình một bản sao dùng chung
FirebaseApp
trong phương thứcapplication(_:didFinishLaunchingWithOptions:)
của uỷ quyền ứng dụng: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];
- Nếu đang sử dụng SwiftUI, bạn phải tạo một trình uỷ quyền ứng dụng và đính kèm trình uỷ quyền đó vào cấu trúc
App
thông quaUIApplicationDelegateAdaptor
hoặcNSApplicationDelegateAdaptor
. Bạn cũng phải tắt tính năng hoán đổi ứng dụng uỷ quyền. Để biết thêm thông tin, hãy xem hướng dẫn về SwiftUI.SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
(Không bắt buộc) Tắt tính năng đăng ký phân bổ mạng quảng cáo của Apple
Để thuận tiện cho bạn, SDK sẽ tự động đăng ký ứng dụng của bạn với Apple để phân bổ mạng quảng cáo bằng SKAdNetwork.
Nếu bạn muốn tắt tính năng này, hãy đặt giá trị của GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
thành NO
(Boolean) trong tệp info.plist của ứng dụng.
Bắt đầu ghi nhật ký sự kiện
Sau khi định cấu hình thực thể FirebaseApp
, bạn có thể bắt đầu ghi lại các sự kiện bằng phương thức logEvent()
.
Một số sự kiện được đề xuất cho tất cả ứng dụng; còn một số sự kiện khác được đề xuất cho các loại hình doanh nghiệp hoặc ngành dọc cụ thể. Bạn nên gửi sự kiện được đề xuất cùng với thông số được quy định cho sự kiện đó để đảm bảo báo cáo có được thông tin chi tiết tối đa, đồng thời khai thác lợi ích từ các tính năng và công cụ tích hợp sẽ ra mắt trong tương lai. Phần này minh hoạ cách ghi nhật ký một sự kiện được xác định trước. Để biết thêm thông tin về cách ghi nhật ký sự kiện, hãy xem phần Ghi nhật ký sự kiện.
Ví dụ sau đây minh hoạ cách ghi nhật ký một sự kiện được đề xuất để cho biết người dùng đã nhấp vào một phần tử cụ thể trong ứng dụng:
Swift
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [ AnalyticsParameterItemID: "id-\(title!)", AnalyticsParameterItemName: title!, AnalyticsParameterContentType: "cont", ])
Objective-C
[FIRAnalytics logEventWithName:kFIREventSelectContent parameters:@{ kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title], kFIRParameterItemName:self.title, kFIRParameterContentType:@"image" }];
Để xem sự kiện này trong bảng điều khiển gỡ lỗi Xcode, hãy bật tính năng gỡ lỗi Analytics:
- Trong Xcode, hãy chọn Product > Scheme > Edit scheme... (Sản phẩm > Lược đồ > Chỉnh sửa lược đồ…).
- Chọn Run (Chạy) trong trình đơn bên trái.
- Chọn thẻ Arguments (Đối số).
- Trong phần Arguments Passed On Launch (Đối số được truyền khi khởi chạy), hãy thêm
-FIRAnalyticsDebugEnabled
.
Các bước tiếp theo
- Tìm hiểu từng báo cáo Analytics.
- Sử dụng DebugView để xác minh các sự kiện của bạn.
- Khám phá dữ liệu của bạn trong bảng điều khiển Firebase.
- Khám phá hướng dẫn về sự kiện và thuộc tính người dùng.
- Tìm hiểu cách xuất dữ liệu sang BigQuery.