Las compras directas desde la aplicación (CDA) son contenido digital o funciones que puedes vender en una app para dispositivos móviles a través de Google Play o la App Store de Apple, de modo que tu aplicación no tenga que procesar transacciones financieras. Algunos ejemplos de compras directas desde la aplicación incluyen contenido basado en suscripciones o artículos especiales de videojuegos.
Analytics muestra los eventos de IAP en el informe de compras directas desde la aplicación.
En el caso de las apps para Android, el SDK de Analytics se integra en Google Play. En el caso de las apps para plataformas de Apple, el SDK se integra en la App Store de Apple mediante las APIs de StoreKit 1 y StoreKit 2 de Apple.
En la mayoría de los casos, el SDK de Analytics recopila eventos de IAP automáticamente sin requerir llamadas a la API en tu app. En esta guía, se explica cómo configurar el seguimiento automático de tu proyecto y se describen algunos casos especiales que requieren algunas líneas de código para implementarse.
Antes de comenzar
Configura el proyecto de Firebase y la base de código de la app como se describe en Comienza a usar Google Analytics.
Vincula tu proyecto de Firebase a una propiedad Google Analytics 4.
En el caso de las apps para plataformas de Apple:
- Asegúrate de que tu app use la versión 6.20.0 o una posterior del SDK de Analytics.
En el caso de las apps para Android:
- Asegúrate de que tu app use la versión 17.3.0 o una posterior del SDK de Analytics (o la versión 25.2.0 o una posterior de la BoM de Firebase para Android).
- Conecta tus apps de Firebase a Google Play.
Si estás desarrollando una app para Android, puedes medir los eventos de CDA en cuanto te vincules a Google Play. El resto de esta guía se enfoca en las apps para plataformas de Apple.
Si eres desarrollador de Apple, consulta la documentación de Apple para asegurarte de conocer las APIs de compra directa desde la aplicación de Apple StoreKit 1 y StoreKit 2.
Implementación
Swift
Si usas StoreKit 1, el SDK de Analytics registra automáticamente los eventos de IAP.
Si usas StoreKit 2, usa el siguiente código para registrar eventos de 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
Si usas StoreKit 1, el SDK de Analytics registra automáticamente los eventos de IAP.
StoreKit 2 es solo para Swift, por lo que no se admite una implementación de Objective-C.
Kotlin+KTX
Para registrar eventos de IAP, vincula tu cuenta a Google Play.
Java
Para registrar eventos de IAP, vincula tu cuenta a Google Play.