Google Analytics is Firebase's analytics engine. When you use Analytics and Crashlytics together in your app, you get features that help you produce issues and keep track of crash data with more granularity, such as crash-free users, breadcrumbs that track specific events prior to a crash, and BigQuery, where you can visualize your app's key metrics.
This guide describes how to add Analytics to an app that has Crashlytics set up (if you haven't already, add Crashlytics to your app).
Step 1: Add a Firebase configuration file
- Open your Project Settings. In the Your apps card, select the bundle ID of the app for which you need a config file.
Click Download GoogleService-Info.plist to obtain your Firebase Apple platforms config file (
GoogleService-Info.plist
).You can download your Firebase Apple platforms config file again at any time.
Make sure the config filename is not appended with additional characters, like
(2)
.
Move your config file into the root of your Xcode project. If prompted, select to add the config file to all targets.
If you have multiple bundle IDs in your project, you must associate each bundle
ID with a registered app in the Firebase console so that each app can have
its own GoogleService-Info.plist
file.
Step 2: Add the Analytics SDK to your app
Use Swift Package Manager to install and manage Firebase dependencies.
- In Xcode, with your app project open, navigate to File > Swift Packages > Add Package Dependency.
- When prompted, add the Firebase Apple platforms SDK repository:
- Add the Firebase SDK for Google Analytics, selecting either the library with or the library without IDFA collection.
- When finished, Xcode will automatically begin resolving and downloading your dependencies in the background.
https://github.com/firebase/firebase-ios-sdk
Next, configure the Firebase module:
- Import the
FirebaseCore
module in yourUIApplicationDelegate
, as well as any other Firebase modules your app delegate uses. For example, to use Cloud Firestore and 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; // ...
- Configure a
FirebaseApp
shared instance in your app delegate'sapplication(_:didFinishLaunchingWithOptions:)
method: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];
- If you're using SwiftUI, you must create an application delegate and attach it
to your
App
struct viaUIApplicationDelegateAdaptor
orNSApplicationDelegateAdaptor
. You must also disable app delegate swizzling. For more information, see the SwiftUI instructions.SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
Your app is now set up to use Google Analytics.
Next steps
- Use the DebugView to verify your events.
- Explore your data in the Firebase console.
- Explore the guides on events and user properties.
- Learn how to export your data to BigQuery.