As compras no aplicativo (IAP) são conteúdos ou recursos digitais que você pode vender em um aplicativo móvel por meio do Google Play ou da Apple App Store para que seu aplicativo não precise processar transações financeiras. Exemplos de compras no aplicativo incluem conteúdo baseado em assinatura ou peças de jogos especiais.
O Analytics mostra eventos de IAP no relatório de compras no aplicativo .
Para aplicativos Android, o SDK do Analytics se integra ao Google Play. Para aplicativos da plataforma Apple, o SDK se integra à Apple App Store usando as APIs StoreKit 1 e StoreKit 2 da Apple.
Na maioria dos casos, o SDK do Analytics coleta automaticamente eventos de IAP sem exigir chamadas de API no seu aplicativo. Este guia explica como configurar seu projeto para rastreamento automático e descreve alguns casos especiais que requerem algumas linhas de código para serem implementados.
Antes de você começar
Configure seu projeto do Firebase e a base de código do seu aplicativo conforme descrito em Primeiros passos com o Google Analytics .
Vincule seu projeto do Firebase a uma propriedade do Google Analytics 4.
Para aplicativos da plataforma Apple:
- Certifique-se de que seu aplicativo esteja usando o SDK do Analytics v6.20.0+.
Para aplicativos Android:
- Verifique se seu aplicativo está usando o Analytics SDK v17.3.0+ (ou Firebase Android BoM v25.2.0+).
- Vincule seus aplicativos do Firebase ao Google Play .
Se estiver desenvolvendo um aplicativo Android, você poderá medir eventos de IAP assim que vincular ao Google Play. O restante deste guia concentra-se nos aplicativos da plataforma Apple.
Se você é um desenvolvedor Apple, certifique-se de estar familiarizado com as APIs de compra no aplicativo Apple StoreKit 1 e StoreKit 2 revisando a documentação da Apple .
Implementação
Rápido
Se você estiver usando o StoreKit 1, o SDK do Analytics registrará automaticamente eventos de IAP.
Se você estiver usando o StoreKit 2, use o código a seguir para registrar eventos 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()
...
}
Objetivo-C
Se você estiver usando o StoreKit 1, o SDK do Analytics registrará automaticamente eventos de IAP.
StoreKit 2 é apenas Swift, portanto, uma implementação de Objective-C não é suportada.
Kotlin+KTX
Para registrar eventos IAP, acesse o Google Play .
Java
Para registrar eventos IAP, acesse o Google Play .