Get started with Google Analytics

This article shows you how to configure an application to use Google Analytics. To configure a website to use Analytics, see Set up Analytics for a website and/or app.

iOS+ Android Web app C++ Unity

Before you begin

Add Firebase to your Apple project and make sure that Analytics is enabled in your Firebase project:

• If you're creating a new Firebase project, enable Analytics during the project creation workflow.

• If you're using an existing Firebase project that doesn't have Analytics enabled, go to the Integrations tab of your > Project settings to enable it.

  Warning: Any Firebase project created before July 31, 2019 must be upgraded to the full Google Analytics 4 experience if it hasn't already. (Banners display in the Analytics dashboard if an upgrade is required.) The associated Terms of Service must be accepted by February 15, 2022 to ensure data collection continues. See the Support FAQ on the upgrade for help finding project Owners.

  When you enable Analytics in your project, your Firebase apps are linked to 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

Use Swift Package Manager to install and manage Firebase dependencies.

Visit our installation guide to learn about the different ways you can add Firebase SDKs to your Apple project, including importing frameworks directly and using CocoaPods.

1. In Xcode, with your app project open, navigate to File > Add Packages.
2. When prompted, add the Firebase Apple platforms SDK repository:

https://github.com/firebase/firebase-ios-sdk

Note: New projects should use the default (latest) SDK version, but you can choose an older version if needed.
3. Choose the Analytics library.
4. For an optimal experience with Analytics, we recommend enabling Google Analytics in your Firebase project and adding the Firebase SDK for Google Analytics to your app. You can select either the library without IDFA collection or with IDFA collection.
5. When finished, Xcode will automatically begin resolving and downloading your dependencies in the background.
6. When finished, Xcode will automatically begin resolving and downloading your dependencies in the background.

Learn more about IDFA, the device-level advertising identifier, in Apple's User Privacy and Data Use and App Tracking Transparency documentation.

Next, perform some configuration steps:

1. Import the Firebase module in your UIApplicationDelegate:

   Swift

   import FirebaseCore
   import FirebaseAnalytics
           

   Objective-C

   @import FirebaseCore;
   @import FirebaseAnalytics;
           

2. Configure a FirebaseApp shared instance, typically in your app's application:didFinishLaunchingWithOptions: method:

   Swift

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

If you're tracking in-app purchases, you must initialize your transaction observer in application:didFinishLaunchingWithOptions: before initializing Firebase, or your observer may not receive all purchase notifications. See Apple's In-App Purchase Best Practices for more information.

(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.

Next steps

• Send events to Analytics.
• 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.