Как отслеживать покупки в приложении

Выберите платформу: iOS+ Android Unity


Покупки в приложении – это цифровой контент или функции, которые можно продавать в мобильном приложении через Google Play. В этом случае приложению не нужно обрабатывать финансовые транзакции. Примеры покупок в приложении: контент по подписке или специальные игровые предметы.

Analytics показывает события покупок в приложении в отчете "Покупки в приложении".

В приложениях для Android SDK Analytics интегрируется с Google Play.

В большинстве случаев SDK Analytics автоматически собирает события, связанные с покупками в приложении, без необходимости вызывать API в приложении. Кроме того, есть и другие способы сбора таких событий:

  • Вы можете вручную регистрировать события покупок в приложении, не взаимодействуя с Google Play.

  • Вы также можете регистрировать события покупки в приложении вручную в WebView.

В этом руководстве рассказывается, как настроить автоматическое отслеживание в проекте, а также описаны особые случаи, в которых для реализации отслеживания требуется добавить несколько строк кода.

Подготовка

  • Настройте проект Firebase и базу кода приложения, как описано в статье Начало работы с Google Analytics.

  • Свяжите проект Firebase с ресурсом Google Аналитики 4.

  • Убедитесь, что вы используете последнюю версию SDK:

    • Для автоматического отслеживания покупок в приложении убедитесь, что в вашем приложении используется Analytics SDK версии 17.3.0 или более поздней (или Firebase Android BoM версии 25.2.0 или более поздней).
    • Для ручного отслеживания покупок в приложении убедитесь, что в вашем приложении используется SDK Analytics версии 23.2.0 или более поздней (или Firebase Android BoM версии 34.10.0 или более поздней).

  • Свяжите приложения Firebase с Google Play.

Реализация

В большинстве случаев SDK Аналитики автоматически регистрирует события покупки в приложении без необходимости добавлять дополнительный код.

Для приложений Android события, связанные с покупками в приложении, можно отслеживать сразу после установки связи с Google Play.

Если вам нужно отслеживать покупки в приложении, совершенные не в Google Play, вы можете регистрировать события IAP вручную, используя приведенный ниже фрагмент кода или WebView.

Чтобы вручную отслеживать покупки в приложении, убедитесь, что вы используете Analytics SDK версии 23.2.0 или более поздней (или Firebase Android BoM версии 34.10.0 или более поздней).

Kotlin 

import android.os.Bundle
import com.google.firebase.analytics.FirebaseAnalytics

class MyClass(val analytics: FirebaseAnalytics) {

  ...

  fun logInAppPurchaseEvent(itemName: String, value: Double, currency: String) {
    val params = Bundle()
    params.putString(FirebaseAnalytics.Param.ITEM_NAME, itemName)
    params.putDouble(FirebaseAnalytics.Param.VALUE, value)
    params.putString(FirebaseAnalytics.Param.CURRENCY, currency)
    analytics.logEvent(FirebaseAnalytics.Event.IN_APP_PURCHASE, params)
  }
}

Java 

import android.os.Bundle;
import com.google.firebase.analytics.FirebaseAnalytics;

public class MyClass {
  private FirebaseAnalytics analytics;

  ...

  public void logInAppPurchaseEvent(String itemName, Double value, String currency) {
    Bundle params = new Bundle();
    params.putString(FirebaseAnalytics.Param.ITEM_NAME, itemName);
    params.putDouble(FirebaseAnalytics.Param.VALUE, value);
    params.putString(FirebaseAnalytics.Param.CURRENCY, currency);
    analytics.logEvent(FirebaseAnalytics.Event.IN_APP_PURCHASE, params);
  }
}