feat(analytics): add 'logScreenView' API and deprecate setCurrentScreen API.

docs/analytics/screen-tracking.md

@@ -22,12 +22,12 @@ import { NavigationContainer } from '@react-navigation/native';
 
 <NavigationContainer
   ref={navigationRef}
-  onStateChange={state => {
+  onStateChange={async (state) => {
     const previousRouteName = routeNameRef.current;
     const currentRouteName = getActiveRouteName(state);
 
     if (previousRouteName !== currentRouteName) {
-      analytics().logScreenView({
+      await analytics().logScreenView({
         screen_name: currentRouteName,
       });
     }
@@ -46,9 +46,9 @@ for React Native apps. To manually track screens, you need to setup a `component
 import analytics from '@react-native-firebase/analytics';
 import { Navigation } from 'react-native-navigation';
 
-Navigation.events().registerComponentDidAppearListener(({ componentName, componentType }) => {
+Navigation.events().registerComponentDidAppearListener(async ({ componentName, componentType }) => {
   if (componentType === 'Component') {
-    analytics().logScreenView({
+    await analytics().logScreenView({
         screen_name: componentName,
         screen_class: componentName,
       });

packages/analytics/lib/index.d.ts

@@ -662,6 +662,26 @@ export namespace FirebaseAnalyticsTypes {
      * @param enabled A boolean value representing whether Analytics collection is enabled or disabled. Analytics collection is enabled by default.
      */
     setAnalyticsCollectionEnabled(enabled: boolean): Promise<void>;
+
+    /**
+     * Sets the current screen name.
+     *
+     * #### Example
+     *
+     * ```js
+     * await firebase.analytics().setCurrentScreen('ProductScreen', 'ProductScreen');
+     * ```
+     *
+     * > Whilst screenClassOverride is optional, it is recommended it is
+     * always sent as your current class name. For example on Android it will always
+     * show as 'MainActivity' if you do not specify it.
+     *
+     * @param screenName A screen name, e.g. Product.
+     * @param screenClassOverride On Android, React Native runs in a single activity called
+     * @deprecated
+     * 'MainActivity'. Setting this parameter overrides the default name shown on logs.
+     */
+    setCurrentScreen(screenName: string, screenClassOverride?: string): Promise<void>;
     /**
      * Sets the minimum engagement time required before starting a session.
      *

packages/analytics/lib/index.js

@@ -102,10 +102,14 @@ class FirebaseAnalyticsModule extends FirebaseModule {
     return this.native.setAnalyticsCollectionEnabled(enabled);
   }
 
-  setCurrentScreen() {
+  setCurrentScreen(screenName, screenClassOverride) {
     console.warn(
       'firebase.analytics().setCurrentScreen(), is now deprecated. Please use firebase.analytics().logScreenView() instead',
     );
+    return this.logScreenView({
+      screen_name: screenName,
+      screen_class: screenClassOverride,
+    });
   }
 
   setMinimumSessionDuration(milliseconds = 10000) {