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 Analytics mostra os eventos de compra no app no relatório de compras no app.

Nos apps Android, o SDK 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. No iOS, você também pode registrar eventos de compra no app manualmente em uma WebView além dos eventos de compra no app coletados automaticamente. 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 Google Analytics.
Vincule seu projeto do Firebase a uma propriedade do Google Analytics 4.

Apps Android

Verifique se o app está usando o SDK Analytics v17.3.0 ou mais recente (ou Firebase Android BoM v25.2.0 ou mais recente).
Vincule seus apps do Firebase ao Google Play.

Observação: para apps Android, é possível medir eventos de compra no app assim que você fizer a vinculação ao Google Play. O restante deste guia se concentra nos aplicativos da plataforma Apple.

Apps da plataforma Apple

Verifique se você está usando o SDK mais recente:
- Para o rastreamento automático de compras no app, verifique se o app está usando o SDK do Analytics v6.20.0 ou versões mais recentes.
- Para o rastreamento manual de compras no app, verifique se o app está usando o SDK do Analytics v12.5.0 ou mais recente.
Conheça as APIs de compra no app Apple StoreKit 1 e StoreKit 2. Para isso, consulte a documentação da Apple.

Implementação

Na maioria dos casos, o SDK do Analytics registra automaticamente eventos de compra no app sem exigir código adicional.

Implementação em apps Android

Para apps Android, é possível medir os eventos de compra no app assim que você vincular ao Google Play.

Implementação em apps da plataforma Apple

Para apps iOS, se você usa o StoreKit 1, o SDK do Analytics registra automaticamente os eventos do IAP. Se você usa o StoreKit 2, pode registrar eventos de compra no app verificados usando o snippet de código abaixo.

Como alternativa, se você precisar rastrear compras no app feitas fora da App Store, registre eventos de compra no app manualmente em uma WebView. O SDK vai continuar registrando automaticamente as compras no app sempre que possível, sem remover a duplicação de eventos registrados manualmente. Verifique se você está usando o SDK do Analytics v12.5.0 ou mais recente ao rastrear manualmente as compras no app.

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