spm/firebase-ios-sdk
1
0 Fork 0
mirror of https://github.com/firebase/firebase-ios-sdk synced 2026-11-09 22:36:01 +05:45
Code Issues Packages Projects Releases Wiki Activity

docs(analytics): explain the three SPM products (#16249)

Browse Source
This commit is contained in:
tsushanth authored and GitHub committed 2026-07-17 17:15:42 -07:00
1 parent 01d057a567
commit b2749e1259
1 file changed
+20
Download Patch File Download Diff File Expand all files Collapse all files
FirebaseAnalytics/README.md
+20
View File
@@ -1,5 +1,25 @@
# Firebase Analytics SDK
## Choosing the Right Analytics Product
The Firebase iOS SDK ships **three** Swift Package products for Analytics. Pick the one whose ad-identifier and data-collection posture matches what your app is allowed to do — adding more than one is unnecessary and surface area you don't need.
| Package product | Underlying measurement library | IDFA / advertising | When to use |
|-----------------|--------------------------------|--------------------|-------------|
| **`FirebaseAnalytics`** | `GoogleAppMeasurement` | Yes — collects IDFA when ATT-authorized; includes on-device conversion measurement | Default for consumer apps that want full Analytics, audience targeting, and ad-network attribution |
| **`FirebaseAnalyticsCore`** | `GoogleAppMeasurementCore` | No | Apps that must avoid IDFA collection entirely (e.g., kids apps, restricted enterprise distributions, or apps whose privacy posture rules out any advertising-related data) |
| **`FirebaseAnalyticsIdentitySupport`** | `GoogleAppMeasurementCore` + `GoogleAppMeasurementIdentitySupport` | Yes - collects IDFA when ATT-authorized; excludes on-device conversion measurement | Apps that collect IDFA, but don't run any Google Ad campaigns |
**Rule of thumb:** start with `FirebaseAnalytics` unless your app's privacy or store policy specifically requires you to avoid advertising features. Add `FirebaseAnalyticsCore` or `FirebaseAnalyticsIdentitySupport` instead — not in addition.
All three depend on `FirebaseCore` and `FirebaseInstallations` transitively, so you don't need to add those manually.
For the full setup steps (registering an app, adding the `GoogleService-Info.plist`, calling `FirebaseApp.configure()`), see the [Get started with Google Analytics](https://firebase.google.com/docs/analytics/get-started?platform=ios) guide.
---
## Manual Screen View Logging API
Introduce a manual screen view event logging API that enable developers to log individual views in SwiftUI lifecycle.
## Code Samples