Hướng dẫn bắt đầu nhanh này sẽ hướng dẫn bạn 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ề mức sử dụng và hành vi cho ứng dụng của bạn. SDK ghi nhật ký hai loại thông tin chính:
- Sự kiện: Những gì đang xảy ra trong ứng dụng của bạn, chẳng hạn như hành động của người dùng, 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 người dùng cơ sở người dùng, chẳng hạn như ngôn ngữ ưu tiên hoặc vị trí địa lý.
Analytics tự động ghi lại một số nhật ký sự kiện và thuộc tính người dùng; bạn không cần thêm bất kỳ mã nào để bật chúng.
Trước khi bắt đầu
Thêm Firebase vào dự án Apple của bạn nếu bạn chưa thêm và đảm bảo bạn đã bật Google Analytics trong Firebase dự án:
Nếu bạn đang tạo một 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 không có Đã bật Google Analytics, hãy chuyển đến Các công cụ tích hợp trong số
để 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 được liên kết với Google Analytics luồng dữ liệu.
(Nên dùng). Thêm khung AdSupport vào project để bật các tính năng bổ sung chẳng hạn 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 của bạn đang mở, hãy chuyển đến Tệp > Thêm gói.
- Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Apple của Firebase:
- Chọn thư viện Analytics.
- Thêm cờ
-ObjC
vào mục Cờ trình liên kết khác trong chế độ 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 Firebase SDK cho Google Analytics vào ứng dụng của bạn. Bạn có thể hãy chọn thư viện không thu thập IDFA hoặc có thu thập IDFA.
- Khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải xuống các phần phụ thuộc trong 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 Apple Quyền riêng tư và việc sử dụng dữ liệu của người dùng 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ư bất kỳ tên nào khác Các mô-đun Firebase mà người được uỷ quyề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
FirebaseApp
thực thể dùng chung trong Phương thứcapplication(_: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];
- Nếu đang sử dụng SwiftUI, bạn phải tạo một ứng dụng uỷ quyền và đính kèm nó
đến cấu trúc
App
của bạn thông quaUIApplicationDelegateAdaptor
hoặcNSApplicationDelegateAdaptor
. Bạn cũng phải tắt tính năng uỷ quyền ứng dụng. Để hãy xem hướng dẫn về SwiftUI để biết thêm thông tin.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 với
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
đến 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 cho thực thể FirebaseApp
, bạn có thể bắt đầu ghi nhật ký
sự kiện với
logEvent()
.
Một số sự kiện được đề xuất cho tất cả các ứng dụng; các phương pháp khác được đề xuất cho các loại hình kinh doanh hoặc ngành dọc cụ thể. Bạn nên gửi các sự kiện được đề xuất cùng với các thông số quy định của sự kiện đó, để đảm bảo tối đa thông tin chi tiết có sẵn trong báo cáo của bạn, cũng như để hưởng lợi từ các tính năng và khi có thể sử dụng. Phần này minh hoạ việc ghi nhật ký một sự kiện được xác định trước, để biết thêm thông tin về ghi nhật ký sự kiện, hãy xem bài viết Ghi nhật ký sự kiện.
Ví dụ sau minh hoạ cách ghi lại một sự kiện được đề xuất để cho biết người dùng đã nhấp vào một thành phần cụ thể trong ứng dụng của bạn:
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 của Xcode, hãy bật tính năng gỡ lỗi Analytics:
- Trong Xcode, hãy chọn Sản phẩm > Lược đồ > Chỉnh sửa lược đồ...
- Chọn Run (Chạy) trên trình đơn bên trái.
- Chọn thẻ Arguments (Đối số).
- Trong phần Đối số đã thông qua 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.
- Hãy khám phá hướng dẫn về các 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.