Google Analytics collects usage and behavior data for your app. The SDK logs two primary types of information:
- Events: What is happening in your app, such as user actions, system events, or errors.
- User properties: Attributes you define to describe segments of your user base, such as language preference or geographic location.
Analytics automatically logs some events and user properties; you don't need to add any code to enable them.
Before you begin
If you haven't already, add Firebase to your iOS project and make sure that Google Analytics is enabled in your Firebase project:
If you're creating a new Firebase project, enable Google Analytics during the project creation workflow.
If you have an existing Firebase project that doesn't have Google Analytics enabled, you can enable Google Analytics from the Integrations tab of your
. > Project settings
When you enable Google Analytics in your project, your Firebase apps are linked to Google Analytics data streams.
(Recommended). Add the AdSupport framework to your project to enable additional features such as audiences and campaign attribution.
Add the Analytics SDK to your app
- Add the dependency for Firebase to your Podfile:
pod 'Firebase/Analytics'
- Run
pod install
and open the created.xcworkspace
file. - Import the Firebase module in your
UIApplicationDelegate
:Swift
import Firebase
Objective-C
@import Firebase;
- Configure a
FirebaseApp
shared instance, typically in your app'sapplication:didFinishLaunchingWithOptions:
method:Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
(Optional) Disable Apple ad network attribution registration
For your convenience, the SDK automatically
registers
your app with Apple for ad network attribution with
SKAdNetwork.
If you wish to disable this feature, set the value of
GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
to NO
(Boolean) in
your app’s info.plist file.
Start logging events
After you have configured the FirebaseApp
instance, you can begin to log
events with the
logEvent()
method.
Certain events are recommended for all apps; others are recommended for specific business types or verticals. You should send suggested events along with their prescribed parameters, to ensure maximum available detail in your reports and to benefit from future features and integrations as they become available. This section demonstrates logging a pre-defined event, for more information on logging events, see Log events.
The following example demonstrates how to log a recommended event to indicate a user has clicked on a specific element in your app:
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" }];
To view this event in the Xcode debug console, enable Analytics debugging:
- In Xcode, select Product > Scheme > Edit scheme...
- Select Run from the left menu.
- Select the Arguments tab.
- In the Arguments Passed On Launch section, add
-FIRAnalyticsDebugEnabled
.
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.