Firebase и Google Analytics

Если вы используете продукты Google — Google Analytics и Firebase, — вы можете обогатить аналитические данные событиями из Adapty с помощью интеграции, описанной в этой статье. События отправляются через Google Analytics в Firebase и могут использоваться в любом из этих сервисов.

Эта возможность позволяет сопоставить поведение пользователей с историей их платежей в Firebase и принимать обоснованные продуктовые решения.

Как настроить интеграцию с Firebase

1. Настройте Firebase

Прежде всего нужно включить интеграцию между Firebase и Google Analytics. Это можно сделать в Firebase Console на вкладке Integrations.

2. Настройте интеграцию с Adapty

Для отправки событий и пользовательских свойств Adapty потребует Firebase App ID и Google Analytics API Secret. Эти параметры можно найти в Firebase Console и во вкладке Data Streams в Google Analytics соответственно.

Затем откройте страницу с деталями потока приложения (Stream details) в разделе Data Streams настроек Admin в Google Analytics.

В разделе Additional settings перейдите на страницу Measurement Protocol API secrets и создайте новый API Secret, если его ещё нет. Скопируйте значение.

Следующий шаг — настройка интеграции в дашборде Adapty. Вам нужно предоставить Firebase App ID и Google Analytics API Secret для платформ iOS, Android и/или Stripe.

Настройка SDK

После этого настройте SDK Adapty для привязки пользователей к Firebase. Для каждого пользователя необходимо передавать в Adapty firebase_app_instance_id. Ниже приведён пример кода для интеграции Firebase SDK и SDK 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`
}

Отправка событий и пользовательских свойств

Теперь нужно решить, какие события вы хотите получать в Firebase и Google Analytics.

Вы заметите, что некоторые события имеют специальные названия, например «Purchase», а другие — обычные события Adapty. Это связано с типами событий Google Analytics. На данный момент поддерживаются события Refund и Purchase. Остальные события являются кастомными. Убедитесь, что названия ваших событий поддерживаются Google Analytics.

Также в дашборде Adapty можно настроить отправку пользовательских свойств.

Это значит, что Adapty будет дополнять ваши события свойствами subscription_state и subscription_product_id. Однако эту функцию также нужно включить в Google Analytics. Чтобы использовать User properties в аналитике, сначала назначьте их пользовательскому измерению через Custom Definitions в Firebase Console: выберите область User scope, задайте название и описание.

Убедитесь, что названия пользовательских свойств — subscription_state и subscription_product_id. Иначе данные о статусе подписки передаваться не будут.

Всё готово! Ждите новых инсайтов от Google.

Решение проблем

Расхождение данных

Если данные в Adapty и Firebase расходятся, скорее всего, не все ваши пользователи используют версию приложения со встроенным SDK Adapty. Чтобы обеспечить согласованность данных, можно принудительно обновить приложение у пользователей до версии с SDK Adapty.

Кроме того, события из песочницы по умолчанию отправляются в Firebase, и отключить это невозможно. Поэтому, если в приложении мало продакшн-событий и много sandbox-событий, между аналитикой Adapty и Firebase может наблюдаться заметное расхождение в цифрах.

События отображаются как доставленные в Adapty, но не появляются в Firebase

Между отправкой событий из Adapty и их появлением на дашборде Google Analytics есть временная задержка. Для просмотра актуальных событий в реальном времени рекомендуем следить за Realtime Dashboard в вашем аккаунте Google Analytics.