Apple yêu cầu các nhà phát triển xuất bản ứng dụng trên App Store phải công bố một số thông tin nhất định về việc sử dụng dữ liệu trong ứng dụng của họ.
Tài liệu này chứa các hành vi của thư viện nền tảng Apple trên Firebase có thể yêu cầu công bố theo nguyên tắc của Apple. Khi cài đặt Firebase, hãy lưu ý đến các mục tiêu bản dựng mà trình quản lý phần phụ thuộc bạn chọn đã cài đặt vào ứng dụng của bạn. Đối với mỗi mục tiêu mà trình quản lý phần phụ thuộc của bạn liệt kê, hãy xem xét phần tương ứng của tài liệu này để xác định những dữ liệu mà bạn phải công bố. Số lượng mục tiêu bản dựng Firebase mà bạn đã cài đặt có thể lớn hơn số lượng bạn dự kiến vì một số mục tiêu bản dựng Firebase có các phần phụ thuộc tạm thời vào những mục tiêu khác.
Nếu bạn đang sử dụng bất kỳ tính năng sản phẩm tuỳ chọn nào cần có dữ liệu bổ sung hoặc tham gia bất kỳ thử nghiệm nào về các tính năng mới của sản phẩm cần có dữ liệu bổ sung, hãy nhớ kiểm tra xem những tính năng hoặc thử nghiệm đó có yêu cầu bạn phải công bố thông tin về dữ liệu bổ sung hay không.
Để đảm bảo thông tin công bố của ứng dụng là chính xác, bạn nên luôn sử dụng phiên bản mới nhất của từng SDK Firebase.
Tác nhân người dùng Firebase
Tác nhân người dùng Firebase là một gói thông tin được thu thập từ hầu hết các SDK Firebase và bao gồm những thông tin sau: thiết bị, hệ điều hành, mã nhận dạng gói ứng dụng và nền tảng nhà phát triển. Tác nhân người dùng không bao giờ được liên kết với một giá trị nhận dạng người dùng hoặc thiết bị và được nhóm Firebase sử dụng để xác định việc áp dụng nền tảng và phiên bản nhằm đưa ra quyết định sáng suốt hơn về các tính năng của Firebase.
FirebaseCore
- Không thu thập dữ liệu.
GoogleUtilities
- Không thu thập dữ liệu, nhưng bao gồm các tiện ích mạng mà các SDK khác có thể dùng để thu thập dữ liệu.
GoogleDataTransport
Bao gồm các tiện ích mạng mà các SDK khác có thể dùng để thu thập dữ liệu.
Luôn được thu thập
- Thu thập siêu dữ liệu về hiệu suất SDK, chẳng hạn như kích thước của bộ nhớ đệm sự kiện nhật ký máy khách và số lượng sự kiện nhật ký máy khách bị loại bỏ vì nhiều lý do, để theo dõi và duy trì chất lượng sản phẩm.
FirebaseABTesting
Thử nghiệm A/B không thu thập dữ liệu.
SDK Firebase A/B Testing thiết lập và sử dụng các thuộc tính người dùng Google Analytics để chỉ định tư cách thành viên trong các nhóm thử nghiệm cho Firebase Remote Config và Firebase In-App Messaging.
FirebaseAI
Firebase AI Logic trước đây được gọi là "Vertex AI in Firebase" với thư viện FirebaseVertexAI
.
Luôn được thu thập
- Thu thập phiên bản Firebase SDK và phiên bản ngôn ngữ Swift.
- Thu thập tên mô hình tại lệnh gọi.
Được thu thập theo mặc định
- Nếu bạn bật tính năng thu thập dữ liệu, thì SDK này sẽ thu thập mã nhận dạng ứng dụng Apple Firebase và phiên bản ứng dụng.
Tuỳ thuộc vào mức sử dụng
- Nếu bạn bật tính năng giám sát AI trong bảng điều khiển Firebase cho Vertex AI Gemini API, thì các câu lệnh và đầu ra được tạo từ mỗi yêu cầu được lấy mẫu sẽ được thu thập cùng với các chỉ số về hiệu suất và mức sử dụng.
Google Analytics
Bạn có thể tìm thấy thông tin về việc thu thập dữ liệu Google Analytics trong bài viết hỗ trợ này.
FirebaseAppCheck
Được thu thập theo mặc định
- Nếu bạn bật tính năng thu thập dữ liệu, thì tính năng này sẽ thu thập tác nhân người dùng Firebase.
Tuỳ thuộc vào mức sử dụng
- Nếu nhà cung cấp DeviceCheck được cài đặt, hãy thu thập mã thông báo
DCDevice
từ DeviceCheck. - Nếu trình cung cấp App Attest được cài đặt, hãy thu thập cả đối tượng chứng thực và đối tượng xác nhận từ App Attest.
FirebaseAppDistribution
App Distribution SDK chỉ dành cho mục đích kiểm thử beta. Đừng đưa App Distribution SDK vào ứng dụng khi gửi lên App Store.
FirebaseAuthentication
Luôn được thu thập
- Tạo và lưu trữ giá trị nhận dạng cho mục đích xác thực người dùng.
Được thu thập theo mặc định
- Nếu bạn bật tính năng thu thập dữ liệu, thì tính năng này sẽ thu thập tác nhân người dùng Firebase.
Tuỳ thuộc vào mức sử dụng
- Thu thập tên hiển thị, nếu nhà phát triển cung cấp tên hiển thị cho người dùng.
- Thu thập địa chỉ email của người dùng do nhà phát triển cung cấp khi sử dụng phương thức xác thực bằng mật khẩu email hoặc đường liên kết qua email, hoặc như được nêu trong phản hồi của một nhà cung cấp liên kết nếu nhà phát triển sử dụng danh tính được liên kết.
- Thu thập số điện thoại của người dùng do nhà phát triển cung cấp khi sử dụng tính năng xác thực bằng điện thoại hoặc nếu số điện thoại của người dùng được thêm làm phương thức xác thực. Cũng được thu thập trong quy trình xác thực bằng SMS làm yếu tố thứ hai.
- Thu thập thông tin liên hệ liên quan đến nhà cung cấp dịch vụ xác thực bên thứ ba nếu nhà phát triển sử dụng nhà cung cấp dịch vụ xác thực bên thứ ba có Firebase Authentication. Ví dụ: giá trị nhận dạng của người dùng có thể được liên kết với hồ sơ Facebook của họ nếu nhà phát triển sử dụng phương thức xác thực của Facebook, tuỳ thuộc vào các phạm vi được cấp. Hãy tham khảo tài liệu của nhà cung cấp dịch vụ xác thực để biết thêm thông tin.
- Lưu trữ mã nhận dạng Game Center của người dùng nếu ứng dụng được liên kết với Game Center.
- Thu thập mã thông báo này nếu ứng dụng của bạn dùng reCAPTCHA Enterprise để bảo vệ các luồng Authentication. Xem thêm thông tin về quyền riêng tư của Apple đối với reCAPTCHA Enterprise.
FirebaseCrashlytics
Luôn được thu thập
- Thu thập dấu vết ngăn xếp và trạng thái ứng dụng có liên quan khi ứng dụng gặp sự cố.
- Thu thập thông tin về thiết bị và hệ điều hành để hỗ trợ gỡ lỗi sự cố.
Tuỳ thuộc vào mức sử dụng
- Thu thập mọi khoá tuỳ chỉnh, nhật ký và mã nhận dạng người dùng dạng văn bản tự do mà nhà phát triển đính kèm vào báo cáo sự cố. Ngoài ra, còn thu thập mọi sự kiện không nghiêm trọng do nhà phát triển xác định bằng dấu vết ngăn xếp tuỳ chỉnh.
- Thu thập nhật ký "breadcrumb" nếu Crashlytics được dùng cùng với Google Analytics. Các nhật ký này xác định hành động của người dùng ngay trước khi xảy ra sự cố cùng với số lượng sự cố.
- Thu thập các phần do nhà phát triển xác định của Remote Configmẫu và siêu dữ liệu mẫu nếu SDK Firebase Remote Config cũng được đưa vào ứng dụng. Dữ liệu này bao gồm phiên bản mẫu Remote Config, mã nhận dạng biến thể triển khai, khoá tham số và giá trị tham số chịu ảnh hưởng của các hoạt động triển khai đang diễn ra.
FirebaseDatabase
Được thu thập theo mặc định
- Nếu bạn bật tính năng thu thập dữ liệu, thì tính năng này sẽ thu thập tác nhân người dùng Firebase.
FirebaseDataConnect
Được thu thập theo mặc định
Nếu bạn bật tính năng thu thập dữ liệu:
- Thu thập tác nhân người dùng Firebase.
- Thu thập thông tin về việc hoạt động tạo mã cục bộ cho Data Connect có đang được sử dụng hay không bằng cách kiểm tra xem các yêu cầu đối với dịch vụ Data Connect có đến từ mã do trình tạo mã tạo hay không, hoặc thay vào đó, đến từ việc sử dụng trực tiếp SDK Data Connect.
- Thu thập mã ứng dụng Firebase của ứng dụng (đây không phải là mã nhận dạng gói của ứng dụng). Giá trị này có trong tiêu đề của mỗi yêu cầu.
FirebaseDynamicLinks
Luôn được thu thập
- Tạm thời thu thập dữ liệu thiết bị, bao gồm kích thước màn hình, ngôn ngữ, phiên bản hệ điều hành, mã nhận dạng gói, địa chỉ IP và phiên bản SDK Firebase của thiết bị cho các đường liên kết sâu bị trì hoãn (đường liên kết sâu sau khi cài đặt ứng dụng).
Được thu thập theo mặc định
- Tạm thời thu thập URL đường liên kết động trong bảng tạm của thiết bị (nếu có) khi khởi chạy ứng dụng lần đầu. Nhà phát triển có thể tắt tính năng sử dụng Bảng tạm bằng cách đặt thuộc tính
FirebaseDeepLinkPasteboardRetrievalEnabled
thànhNO
trong tệpInfo.plist
của ứng dụng.
Tuỳ thuộc vào mức sử dụng
Nếu Dynamic Links được dùng cùng với Google Analytics:
- Tự động ghi lại các sự kiện tương tác với đường liên kết thông qua Google Analytics. Để tắt tính năng ghi nhật ký sự kiện tự động, hãy xoá
FirebaseAnalytics
khỏi ứng dụng.
FirebaseFirestore
Được thu thập theo mặc định
- Nếu bạn bật tính năng thu thập dữ liệu, thì tính năng này sẽ thu thập tác nhân người dùng Firebase.
FirebaseFunctions
Luôn được thu thập
- Thu thập siêu dữ liệu về lệnh gọi hàm, bao gồm cả tên hàm và địa chỉ IP của lệnh gọi hàm.
FirebaseInAppMessaging
Luôn được thu thập
- Ghi lại các lượt tương tác với thông báo trong ứng dụng. Những lượt tương tác này (lượt hiển thị, lượt nhấp, lượt loại bỏ) được ghi lại thông qua Google Analytics. Firebase cũng ghi lại các lượt tương tác để giúp nhà phát triển đánh giá hiệu quả của chiến dịch nhắn tin.
FirebaseInstallations
Được thu thập theo mặc định
- Nếu bạn bật tính năng thu thập dữ liệu, thì tính năng này sẽ thu thập tác nhân người dùng Firebase.
FirebaseMessaging
Luôn được thu thập
- Ghi lại mã thông báo APNs và liên kết mã thông báo đó với một mã nhận dạng lượt cài đặt ứng dụng đã thu thập, đóng vai trò là mã thông báo đăng ký Giải pháp gửi thông báo qua đám mây của Firebase (FCM).
- Thu thập thông tin về mẫu thiết bị, ngôn ngữ, múi giờ, phiên bản hệ điều hành, mã nhận dạng ứng dụng và phiên bản ứng dụng để đăng ký và huỷ đăng ký chủ đề.
Được thu thập theo mặc định
- Nếu bạn bật tính năng thu thập dữ liệu, thì tính năng này sẽ thu thập tác nhân người dùng Firebase.
Tuỳ thuộc vào mức sử dụng
Nếu Cloud Messaging được dùng cùng với Google Analytics:
- Tự động ghi lại các lượt tương tác với thông báo thông qua Google Analytics. Để tắt hành vi này, hãy xoá
FirebaseAnalytics
khỏi ứng dụng của bạn.
FirebaseMLModelDownloader
Luôn được thu thập
- Thu thập siêu dữ liệu tải mô hình học máy xuống, chẳng hạn như sự kiện tải xuống, sự kiện xoá và lỗi.
FirebasePerformance
Luôn được thu thập
- Thu thập địa chỉ IP để phân đoạn dữ liệu hiệu suất dựa trên vị trí địa lý.
- Thu thập các chỉ số hiệu suất của ứng dụng, chẳng hạn như thời gian chạy ứng dụng và độ trễ của yêu cầu mạng, cũng như các dấu vết tuỳ chỉnh do nhà phát triển chỉ định để đo lường hiệu suất của ứng dụng.
- Thu thập mức sử dụng CPU/bộ nhớ của ứng dụng để cung cấp chế độ xem theo dòng thời gian về hiệu suất của ứng dụng.
- Thu thập thông tin về thiết bị, thông tin về hệ điều hành và thông tin về ứng dụng để lọc dữ liệu hiệu suất theo các phân khúc thiết bị khác nhau.
FirebaseRemoteConfig
Luôn được thu thập
- Thu thập mã quốc gia, mã ngôn ngữ, múi giờ, phiên bản hệ điều hành, mã ứng dụng Apple Firebase và mã nhận dạng gói của thiết bị để nhắm đến các thông số dựa trên dữ liệu này. Phiên bản hệ điều hành và phiên bản SDK cũng được thu thập và tổng hợp để nắm bắt xu hướng sử dụng và định hướng sản phẩm.
Được thu thập theo mặc định
- Nếu bạn bật tính năng thu thập dữ liệu, thì tính năng này sẽ thu thập tác nhân người dùng Firebase.
Tuỳ thuộc vào mức sử dụng
Nếu Remote Config được dùng cùng với Google Analytics:
- Thu thập các thuộc tính người dùng do SDK Firebase thu được cho Google Analytics để nhắm đến các thông số dựa trên điều kiện thuộc tính người dùng.
- Thu thập dấu thời gian sự kiện
first_open
do Firebase SDK thu thập cho Google Analytics để nhắm đến các thông số dựa trên thời gian mở ứng dụng lần đầu.
Nếu bạn sử dụng chế độ cá nhân hoá Remote Config:
- Bạn có thể sử dụng dữ liệu do SDK Firebase Remote Config thu thập và các sự kiện do Firebase SDK cho Google Analytics thu thập để tạo các mô hình dự đoán và đo lường hiệu suất của những mô hình đó.
FirebaseSessions
Luôn được thu thập
- Thu thập siêu dữ liệu về hiệu suất ứng dụng, chẳng hạn như mã nhận dạng gói, thông tin hệ điều hành, phiên bản SDK và loại kết nối mạng để theo dõi chất lượng ứng dụng.
- Thu thập dữ liệu sử dụng, chẳng hạn như thời gian một ứng dụng được chuyển xuống nền để nhóm các chỉ số hiệu suất thành phiên người dùng nhằm lọc mức sử dụng theo phiên.
FirebaseStorage
Được thu thập theo mặc định
- Nếu bạn bật tính năng thu thập dữ liệu, thì tính năng này sẽ thu thập tác nhân người dùng Firebase.