Firebase y Google Analytics

Si utilizas productos de Google como Google Analytics y Firebase, puedes enriquecer tus datos analíticos con eventos de Adapty mediante la integración descrita en este artículo. Los eventos se envían a través de Google Analytics a Firebase y pueden usarse en cualquiera de estos servicios.

Esta función te permite relacionar el comportamiento de tus usuarios con su historial de pagos en Firebase, lo que te facilita tomar decisiones de producto bien fundamentadas.

Cómo configurar la integración con Firebase

1. Configura Firebase

Primero, debes habilitar la integración entre Firebase y Google Analytics. Puedes hacerlo en tu Firebase Console, en la pestaña Integrations.

2. Integra con Adapty

A continuación, Adapty necesita tu Firebase App ID y el API Secret de Google Analytics para enviar eventos y propiedades de usuario. Puedes encontrar estos parámetros en la Firebase Console y en la pestaña Data Streams de Google Analytics, respectivamente.

A continuación, accede a la página de detalles del Stream de la app dentro de la sección Data Streams de la configuración de administrador en Google Analytics.

En Additional settings, ve a la página Measurement Protocol API secrets y crea un nuevo API Secret si no existe. Copia el valor.

El siguiente paso será ajustar la integración en el Adapty Dashboard. Deberás proporcionarnos el Firebase App ID y el API Secret de Google Analytics para tus plataformas iOS, Android y/o Stripe.

Configuración del SDK

A continuación, debes configurar el SDK de Adapty para asociar a tus usuarios con Firebase. Para cada usuario, debes enviar el firebase_app_instance_id a Adapty. A continuación puedes ver un ejemplo del código que se puede usar para integrar el SDK de Firebase y el SDK de Adapty.

FirebaseApp.configure()
        
if let appInstanceId = Analytics.appInstanceID() {            
    do {
        try await Adapty.setIntegrationIdentifier(
            key: "firebase_app_instance_id", 
            value: appInstanceId
        )
    } catch {
        // handle the error
    }
}

//after Adapty.activate()

FirebaseAnalytics.getInstance(context).appInstanceId.addOnSuccessListener { appInstanceId ->
    Adapty.setIntegrationIdentifier("firebase_app_instance_id", appInstanceId) { error ->
        if (error != null) {
            // handle the error
        }
    }
}

//after Adapty.activate()

FirebaseAnalytics.getInstance(context).getAppInstanceId().addOnSuccessListener(appInstanceId -> {
    Adapty.setIntegrationIdentifier("firebase_app_instance_id", appInstanceId, error -> {
        if (error != null) {
            // handle the error
        }
    });
});

final appInstanceId = await FirebaseAnalytics.instance.appInstanceId;

try {
    await Adapty().setIntegrationIdentifier(
        key: "firebase_app_instance_id", 
        value: appInstanceId,
    );
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
    // handle the error
}

using AdaptySDK;

// We suppose FirebaseAnalytics Unity Plugin is already installed

Firebase.Analytics
  .FirebaseAnalytics
  .GetAnalyticsInstanceIdAsync()
  .ContinueWithOnMainThread((task) => {
    if (!task.IsCompletedSuccessfully) {
      // handle error
      return;
    }

    var firebaseId = task.Result
    var builder = new Adapty.ProfileParameters.Builder();
    
    Adapty.SetIntegrationIdentifier(
      "firebase_app_instance_id", 
      firebaseId, 
      (error) => {
        // handle the error
    });
  });

try {
  const appInstanceId = await analytics().getAppInstanceId();

  await adapty.setIntegrationIdentifier("firebase_app_instance_id", appInstanceId);
} catch (error) {
  // handle `AdaptyError`
}

Envío de eventos y propiedades de usuario

Ahora es el momento de decidir qué eventos recibirás en Firebase y Google Analytics.

Verás que algunos eventos tienen nombres específicos, como “Purchase”, mientras que otros son eventos habituales de Adapty. Esta diferencia se debe a los tipos de eventos de Google Analytics. Actualmente, los eventos compatibles son Refund y Purchase. El resto son eventos personalizados. Por lo tanto, asegúrate de que los nombres de tus eventos sean compatibles con Google Analytics.
También puedes configurar el envío de propiedades de usuario desde el Adapty Dashboard.

Esto significa que Adapty enriquecerá tus eventos con subscription_state y subscription_product_id. Sin embargo, también debes habilitar esta función en Google Analytics. Para usar User properties en tus análisis, empieza por asignarlas a una dimensión personalizada en la Firebase Console, a través de Custom Definitions, seleccionando el ámbito User, y asignándoles un nombre y una descripción.

Asegúrate de que los nombres de tus propiedades de usuario sean subscription_state y subscription_product_id. De lo contrario, no podremos enviarte los datos del estado de la suscripción.

¡Y eso es todo! Espera a recibir nuevos insights de Google.

Solución de problemas

Discrepancia de datos

Si existe una discrepancia de datos entre Adapty y Firebase, puede deberse a que no todos tus usuarios utilizan la versión de la app que incluye el SDK de Adapty. Para garantizar la consistencia de los datos, puedes obligar a tus usuarios a actualizar la app a una versión que incluya el SDK de Adapty.

Además, los eventos de sandbox se envían a Firebase por defecto y esto no se puede deshabilitar. Por eso, en situaciones en las que una app tiene pocos eventos de producción y muchos de sandbox, puede haber una discrepancia notable entre los datos de Analytics de Adapty y los de Firebase.

Los eventos aparecen como entregados en Adapty pero no están disponibles en Firebase

Existe un retraso entre el momento en que Adapty envía los eventos y el momento en que aparecen en el dashboard de Google Analytics. Se recomienda consultar el Realtime Dashboard de tu cuenta de Google Analytics para ver los eventos más recientes en tiempo real.