Firebase

If you’re using the Firebase iOS device mode v1.0.2, update to the latest version to get the latest updates, bug fixes, and performance enhancements.

1. Register your app in the Firebase console. It will then prompt you to download the GoogleServices-Info.plist file.
2. Add the file to the root of your XCode project.
3. Go to your Podfile and add the Rudder-Firebase extension along with the core SDK using the following code:

pod 'Rudder-Firebase', '~> 2.0.5'

Rudder-Firebase version 2.0.5 is tested and fully compatible with Firebase/Analytics version 8.15.0.

#import "RudderFirebaseFactory.h"

5. Finally, change the SDK initialization, as shown in the following snippet:

RSConfigBuilder *builder = [[RSConfigBuilder alloc] init];
[builder withDataPlaneUrl:<data_plane_url>];
[builder withFactory:[RudderFirebaseFactory instance]];
[builder withLoglevel:RSLogLevelDebug];
[RSClient getInstance:<write_key> config:[builder build]];

This device mode integration is supported for Firebase v8.15.0 and above.

1. Add Firebase as a destination in the RudderStack dashboard.
2. Register your app in the Firebase console. It will then prompt you to download the GoogleServices-Info.plist file.
3. Download and place this file in your project.
4. Install RudderFirebase (available through CocoaPods) by adding the following line to your Podfile:

pod 'RudderFirebase', '~> 1.0.0'

5. Run the pod install command.
6. Then, import the SDK depending on your preferred platform:

import RudderFirebase

@import RudderFirebase;

7. Next, add the imports to your AppDelegate file under the didFinishLaunchingWithOptions method:

RSConfig *config = [[RSConfig alloc] initWithWriteKey:WRITE_KEY];
[config dataPlaneURL:DATA_PLANE_URL];
[[RSClient sharedInstance] configureWith:config];
[[RSClient sharedInstance] addDestination:[[RudderFirebaseDestination alloc] init]];

let config: RSConfig = RSConfig(writeKey: WRITE_KEY)
            .dataPlaneURL(DATA_PLANE_URL)
RSClient.sharedInstance().configure(with: config)
RSClient.sharedInstance().addDestination(RudderFirebaseDestination())

Follow these steps to add Firebase to your Unity project:

1. Register your project in the Firebase Console. Currently, RudderStack supports only Android and iOS platforms for Unity.
2. After adding the project, Firebase will prompt you to download the google-services.json for Android and GoogleServices-Info.plist for iOS.
3. Add those two files to your project’s Assets folder.
4. Integrate the RudderStack core SDK with your project. For more information, refer to the Unity SDK documentation.
5. Download and import the Firebase Unity SDK and follow the instructions to add the Firebase SDK (specifically, FirebaseAnalytics.unitypackage) to your project.
6. Download the RudderStack Firebase Extension from the GitHub page and import it in your project.
7. Attach the RudderPreferbs.prefab file from Rudder to your main GameObject
8. Finally, change the SDK initialization using the following code snippet:

// Build your config
RudderConfigBuilder configBuilder = new RudderConfigBuilder()
    .WithEndPointUrl(<data_plane_url>)
    .WithFactory(RudderFirebaseIntegrationFactory.GetFactory());

// get instance for RudderClient
RudderClient rudderClient = RudderClient.GetInstance(
    <source_write_key>,
    configBuilder.Build()
);

Use the latest version of the Firebase React Native device mode to get the latest updates and performance enhancements.

1. Register your Android and iOS applications in the Firebase console.
2. Once you have successfully created the applications in the Firebase console, you will be prompted to download the google-services.json and GoogleServices-Info.plist files.
3. Add the RudderStack React Native SDK to your app by referring to the React Native SDK documentation.
4. Add the RudderStack-Firebase React Native module to your app using the following command:

npm install @rudderstack/rudder-integration-firebase-react-native
// OR //
yarn add @rudderstack/rudder-integration-firebase-react-native

5. Next, import the module you added above and add it to your SDK initialization code as shown:

import rudderClient from '@rudderstack/rudder-sdk-react-native';
import firebase from "@rudderstack/rudder-integration-firebase-react-native";

const config = {
    dataPlaneUrl: <data_plane_url>,
    trackAppLifecycleEvents: true,
    withFactories: [firebase]
};

rudderClient.setup(<source_write_key>, config);

6. Navigate to your app’s android folder and follow the steps below:

• Copy the google-services.json file in the app folder of your Android project. This file contains all necessary information about the project and the integration.
• Add the classpath under dependencies to your project level build.gradle file:

buildscript {
  repositories {
    google()
  }
  dependencies {
    // add this line
    classpath 'com.google.gms:google-services:4.3.3'
  }
}

• Once you have completed the steps above, you can add the plugins and dependencies to your app/build.gradle file:

apply plugin: 'com.android.application'
apply plugin: 'com.google.gms.google-services'

• Then, add the necessary permissions under AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET"></uses-permission>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>

7. For React-Native Firebase version 1.0.16 and above, if you encounter any static libraries issue while installing the Rudder-Firebase pods, add the below lines in your iOS app’s Podfile:

pod 'FirebaseCore', :modular_headers => true
pod 'GoogleUtilities', :modular_headers => true

8. Finally, navigate to your app’s iOS folder and follow these steps:

• Install all required pods using the pod install command.
• Add the GoogleServices-Info.plist file to the root of your XCode project.

Follow the below steps to add Firebase to your Flutter Project:

1. Add the following dependency to the dependencies section of your pubspec.yaml file.

rudder_integration_firebase_flutter: ^1.0.1

2. Run the below command to install the dependency added in the above step:

flutter pub get

3. Import the RudderIntegrationFirebaseFlutter in your application where you are initializing the SDK.

import 'package:rudder_integration_firebase_flutter/rudder_integration_firebase_flutter.dart';

4. Change the initialization of your RudderClient as shown:

final RudderController rudderClient = RudderController.instance;
RudderConfigBuilder builder = RudderConfigBuilder();
builder.withFactory(RudderIntegrationFirebaseFlutter());
rudderClient.initialize(<write_key>, config: builder.build(), options: null);

5. Navigate to your app’s android folder and follow the below steps:

• Copy the google-services.json file in the app folder of your Android project. This file contains all necessary information about the project and the integration.
• Add the classpath under dependencies to your project level build.gradle file:

buildscript {
  repositories {
    google()
  }
  dependencies {
    // add this line
    classpath 'com.google.gms:google-services:4.3.3'
  }
}

• Add mavenCentral() as a repository under buildscript.repositories and allprojects.repositories to your project level build.gradle file:

buildscript {
  repositories {
    google()
    // should be added
    mavenCentral()
  }
  dependencies {
    classpath 'com.google.gms:google-services:4.3.3'
  }
}
allprojects {
  repositories {
      google()
      // should be added
      mavenCentral()
  }
}

• Next, add the plugins and dependencies to your app/build.gradle file:

apply plugin: 'com.android.application'
apply plugin: 'com.google.gms.google-services'

• Add the necessary permissions under AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET"></uses-permission>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>

6. Finally, navigate to your app’s iOS folder and add the GoogleServices-Info.plist file to the root of your XCode project.