Medir as compras no app

As compras no app consistem em conteúdo ou recursos digitais que podem ser vendidos em apps para dispositivos móveis no Google Play ou na App Store da Apple. Dessa forma, seu aplicativo não precisa processar transações financeiras. Exemplos de compras no app incluem conteúdo baseado em assinatura ou peças especiais de jogos.

O Google Analytics mostra os eventos de compra no app no relatório de compras no app.

Nos apps Android, o SDK do Analytics é integrado ao Google Play. Para apps da plataforma Apple, o SDK se integra à App Store da Apple usando as APIs StoreKit 1 e StoreKit 2 da Apple.

Na maioria dos casos, o SDK do Analytics coleta automaticamente eventos de compra no app sem exigir chamadas de API no seu app. Este guia explica como configurar seu projeto para rastreamento automático e descreve alguns casos especiais que exigem algumas linhas de código para serem implementadas.

Antes de começar

Configure o projeto do Firebase e a base de código do app conforme descrito em Primeiras etapas com o Google Analytics.
Vincule seu projeto do Firebase a uma propriedade do Google Analytics 4.
Para apps da plataforma Apple:
- Verifique se seu app usa o SDK do Analytics v6.20.0 ou versões mais recentes.
Para apps Android:
- Verifique se o app está usando o SDK do Analytics v17.3.0+ (ou a BoM do Firebase para Android v25.2.0+).
- Conectar apps do Firebase ao Google Play.

Se você estiver desenvolvendo um app Android, poderá medir os eventos de compra no app assim que fizer a vinculação ao Google Play. O restante deste guia se concentra nos aplicativos da plataforma Apple.

Se você for um desenvolvedor da Apple, conheça as APIs de compra no app Apple StoreKit 1 e StoreKit 2. Para isso, consulte a documentação da Apple.

Implementação

Swift

Se você usa o StoreKit 1, o SDK do Analytics registra automaticamente os eventos do IAP.

Se você usa o StoreKit 2, utilize o código a seguir para registrar os eventos do IAP.

import StoreKit
import FirebaseAnalytics

// A user tapped a button to purchase an item.
func userTappedPurchaseUpgradeButton() {
  let product = ...
  purchaseSomeProduct(product)
}

func purchaseSomeProduct(_ product: Product) {
  // Purchase a Product. This is mostly standard boilerplate StoreKit 2
  // code, except for the Analytics.logTransaction() call.
  let result = try await product.purchase()
  switch result {
  case .success(let verification):
      let transaction = try checkVerified(verification)

      // Call this Firebase API to log the in-app purchase event.
      Analytics.logTransaction(transaction)

      await transaction.finish()
  ...
}

Objective-C

Se você usa o StoreKit 1, o SDK do Analytics registra automaticamente os eventos do IAP.

O StoreKit 2 é somente Swift, portanto, não há suporte para implementação em Objective-C.

Kotlin+KTX

Para registrar eventos do IAP, vincule-o ao Google Play.

Java

Para registrar eventos do IAP, vincule-o ao Google Play.