Hướng dẫn bắt đầu nhanh này chỉ cho bạn cách thêm Google Analytics vào ứng dụng của mình và bắt đầu ghi nhật ký sự kiện.
Google Analytics thu thập dữ liệu sử dụng và hành vi cho ứng dụng của bạn. SDK ghi lại hai loại thông tin chính:
- Sự kiện: Điều 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, sự kiện hệ thống hoặc lỗi.
- Thuộc tính người dùng: Thuộc tính bạn xác định để mô tả các phân đoạn cơ sở người dùng của mình, chẳng hạn như tùy chọn 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 bất kỳ mã nào để kích hoạt chúng.
Trước khi bắt đầu
Nếu bạn chưa có, hãy thêm Firebase vào dự án Apple của bạn và đảm bảo rằng Google Analytics được bật trong dự án Firebase của bạn:
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 dự án Firebase hiện chưa bật Google Analytics, hãy chuyển tới tab Tích hợp của
Khi bạn bật Google Analytics trong dự án của mình, ứng dụng Firebase của bạn sẽ được liên kết với luồng dữ liệu Google Analytics.
(Được khuyến nghị) . Thêm khung AdSupport vào dự án của bạn để kích hoạt các tính năng bổ sung như đối tượng và phân bổ chiến dịch.
Thêm SDK Analytics vào ứng dụng của bạn
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 của Firebase.
- Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy điều hướng đến File > Add Packages .
- Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Firebase của Apple:
- Chọn thư viện Analytics.
- Để có trải nghiệm tối ưu với Analytics, chúng tôi khuyên 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 của mình. Bạn có thể chọn thư viện không có bộ sưu tập IDFA hoặc có bộ sưu tậ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 của bạn ở chế độ nền.
https://github.com/firebase/firebase-ios-sdk
Tìm hiểu thêm về IDFA, mã nhận dạng quảng cáo cấp thiết bị, trong tài liệu về Quyền riêng tư và việc sử dụng dữ liệu và quyền riêng tư của người dùng cũng như Tính minh bạch trong việc theo dõi ứng dụng của Apple.
Tiếp theo, thực hiện một số bước cấu hình:
- Nhập mô-đun
FirebaseCore
trongUIApplicationDelegate
của bạn, cũng như bất kỳ mô-đun Firebase nào khác mà ủy quyền ứng dụng của bạn sử dụng. Ví dụ: để sử dụng Cloud Firestore và Xác thực:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Nhanh
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Mục tiêu-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Định cấu hình phiên bản chia sẻ
FirebaseApp
trong phương thứcapplication(_:didFinishLaunchingWithOptions:)
của đại biểu ứng dụng của bạn:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Nhanh
// Use Firebase library to configure APIs FirebaseApp.configure()
Mục tiêu-C
// Use Firebase library to configure APIs [FIRApp configure];
- Nếu bạn đang sử dụng SwiftUI, bạn phải tạo một đại biểu ứng dụng và đính kèm nó vào cấu trúc
App
của mình thông quaUIApplicationDelegateAdaptor
hoặcNSApplicationDelegateAdaptor
. Bạn cũng phải tắt chức năng chuyển giao ứng dụng. Để biết thêm thông tin, hãy xem hướng dẫn SwiftUI .SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
(Tùy chọn) Vô hiệu hóa đăng ký thuộc tính 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
thành NO
(Boolean) trong tệp info.plist của ứng dụng của bạn.
Bắt đầu ghi nhật ký sự kiện
Sau khi định cấu hình phiên bản FirebaseApp
, bạn có thể bắt đầu ghi nhật ký sự kiện bằng phương thức logEvent()
.
Một số sự kiện nhất định được đề xuất cho tất cả ứng dụng ; những cái 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ố được quy định của chúng để đảm bảo chi tiết có sẵn tối đa trong báo cáo của bạn và để hưởng lợi từ các tính năng và tích hợp trong tương lai khi chúng có sẵn. Phần này trình bày 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ề ghi nhật ký sự kiện, hãy xem Nhật ký sự kiện .
Ví dụ sau đây minh họa cách ghi lại 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:
Nhanh
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [ AnalyticsParameterItemID: "id-\(title!)", AnalyticsParameterItemName: title!, AnalyticsParameterContentType: "cont", ])
Mục tiêu-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 gỡ lỗi Analytics:
- Trong Xcode, chọn Sản phẩm > Lược đồ > Chỉnh sửa lược đồ...
- Chọn Chạy từ menu bên trái.
- Chọn tab Đối số .
- Trong phần Đối số được truyền khi khởi chạy , hãy thêm
-FIRAnalyticsDebugEnabled
.
Bước tiếp theo
- Hiểu từng báo cáo Analytics .
- Sử dụng DebugView để xác minh 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ề 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 của bạn sang BigQuery.