Оценивайте покупки в приложении

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


Встроенные покупки (IAP) — это цифровой контент или функции, которые вы можете продавать в мобильном приложении через Google Play , чтобы вашему приложению не приходилось обрабатывать финансовые транзакции. Примерами встроенных покупок являются контент по подписке или специальные игровые элементы.

Analytics отображает события внутриигровых покупок в отчете о покупках внутри приложений .

Для приложений Android SDK Analytics интегрируется с Google Play .

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

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

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

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

Прежде чем начать

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

  • Свяжите свой проект Firebase с ресурсом Google Analytics 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 .

Выполнение

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

В приложениях для Android можно отслеживать события внутриигровых покупок сразу после привязки к Google Play .

Если вам необходимо отслеживать внутриигровые покупки, совершенные вне Play Store, вы можете регистрировать события 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);
  }
}