Reportar transacciones en Observer Mode en Flutter SDK

En el modo Observador, el SDK de Adapty no puede rastrear por sí solo las compras realizadas a través de tu sistema de compras existente. Debes informar las transacciones desde tu app store. Es fundamental configurar esto antes de publicar tu app para evitar errores en los análisis.

Usa reportTransaction para informar explícitamente cada transacción y que Adapty pueda reconocerla.

Warning

¡No omitas el reporte de transacciones! Si no llamas a reportTransaction, Adapty no reconocerá la transacción, no aparecerá en los análisis y no se enviará a las integraciones.

Si usas flows y paywalls de Adapty, incluye el variationId al reportar una transacción. Esto vincula la compra con el flow o paywall que la originó, garantizando análisis precisos.

try {
    // every time when calling transaction.finish()
    await Adapty().reportTransaction(
        transactionId: "YOUR_TRANSACTION_ID",
        variationId: "PAYWALL_VARIATION_ID", // optional
    );
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
    // handle the error
}

Parámetros:

Parámetro	Presencia	Descripción
transactionId	requerido	Para iOS: Identificador de la transacción. Para Android: Identificador de cadena `purchase.getOrderId` de la compra, donde la compra es una instancia de la clase Purchase de la biblioteca de facturación.
variationId	opcional	El identificador de cadena de la variante. Puedes obtenerlo usando la propiedad `variationId` del objeto AdaptyPaywall.

En el modo Observer, el SDK de Adapty no puede rastrear por sí solo las compras realizadas a través de tu sistema de compras existente. Debes informar las transacciones desde tu store o restaurarlas. Es fundamental configurar esto antes de publicar tu app para evitar errores en los análisis.

Usa reportTransaction en ambas plataformas para informar explícitamente cada transacción, y usa restorePurchases en Android como paso adicional para asegurarte de que Adapty la reconozca.

Warning

¡No omitas el reporte de transacciones ni la restauración de compras! Si no llamas a estos métodos, Adapty no reconocerá la transacción, no aparecerá en los análisis y no se enviará a las integraciones.

Si usas flows y paywalls de Adapty, incluye el variationId al reportar una transacción. Esto vincula la compra con el flow o paywall que la generó, lo que garantiza un análisis preciso.

// every time when calling transaction.finish()
if (Platform.isAndroid) {
    try {
        await Adapty().restorePurchases();
    } on AdaptyError catch (adaptyError) {
        // handle the error
    } catch (e) {
    }
}

try {
    // every time when calling transaction.finish()
    await Adapty().reportTransaction(
        transactionId: "YOUR_TRANSACTION_ID",
        variationId: "PAYWALL_VARIATION_ID", // optional
    );
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
    // handle the error
}

Parámetros:

Parámetro	Presencia	Descripción
transactionId	requerido	Para iOS, StoreKit 1: un objeto SKPaymentTransaction. Para iOS, StoreKit 2: objeto Transaction. Para Android: identificador de tipo String (purchase.getOrderId de la compra, donde purchase es una instancia de la clase Purchase de la biblioteca de facturación).
variationId	opcional	El identificador de tipo String de la variante. Puedes obtenerlo usando la propiedad `variationId` del objeto AdaptyPaywall.

Notificación de transacciones Usa restorePurchases para informar una transacción a Adapty en Observer Mode, tal como se explica en la página Restaurar compras en el código móvil.

Warning

¡No omitas el reporte de transacciones! Si no llamas a restorePurchases, Adapty no reconocerá la transacción, no aparecerá en los análisis y no se enviará a las integraciones.

Asociar flows y paywalls a transacciones

El SDK de Adapty no puede determinar el origen de las compras, ya que eres tú quien las procesa. Por ello, si tienes previsto usar flows, paywalls y/o pruebas A/B en el modo Observer, necesitas asociar la transacción proveniente de tu store con el flow o paywall correspondiente en el código de tu app. Es importante hacerlo correctamente antes de publicar tu app; de lo contrario, se producirán errores en los análisis.

final transactionId = transaction.transactionIdentifier
final variationId = paywall.variationId

try {
  await Adapty().setVariationId('transactionId', variationId);
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}