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

Выберите платформу: 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 или выше).
    • Для ручного отслеживания покупок в приложении убедитесь, что в нем используется Analytics SDK версии 23.2.0 или более поздней (или Firebase Android BoM версии 34.10.0 или более поздней).

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

Реализация

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

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

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

Чтобы вручную отслеживать покупки в приложении, убедитесь, что вы используете SDK Analytics версии 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);
  }
}