Realizar compras in-app en Unity SDK

Mostrar paywalls dentro de tu aplicación móvil es un paso esencial para ofrecer a los usuarios acceso a contenido o servicios premium. Sin embargo, simplemente mostrar estos paywalls solo es suficiente para gestionar las compras si usas Paywall Builder para personalizar tus paywalls.

Si no usas el Paywall Builder, debes usar un método independiente llamado .makePurchase() para completar una compra y desbloquear el contenido deseado. Este método es la puerta de entrada para que los usuarios interactúen con los paywalls y realicen sus transacciones. Si tu paywall tiene una oferta promocional activa para el producto que el usuario intenta comprar, Adapty la aplicará automáticamente en el momento de la compra.

Asegúrate de haber completado la configuración inicial sin saltarte ningún paso. Sin ella, no podemos validar las compras.

Realizar una compra

using AdaptySDK;

void MakePurchase(AdaptyPaywallProduct product) {
  Adapty.MakePurchase(product, (result, error) => {
    switch (result.Type) {
      case AdaptyPurchaseResultType.Pending:
        // handle pending purchase
        break;
      case AdaptyPurchaseResultType.UserCancelled:
        // handle purchase cancellation
        break;
      case AdaptyPurchaseResultType.Success:
        var profile = result.Profile;
        // handle successfull purchase
        break;
      default:
        break;
    }
  });
}

Parámetros de la solicitud:

Parámetros de respuesta:

Cambiar la suscripción al realizar una compra

Cuando un usuario elige una suscripción nueva en lugar de renovar la actual, el funcionamiento depende del store:

• En el App Store, la suscripción se actualiza automáticamente dentro del grupo de suscripciones. Si un usuario compra una suscripción de un grupo mientras ya tiene activa otra de un grupo distinto, ambas suscripciones estarán activas al mismo tiempo.
• En Google Play, la suscripción no se actualiza automáticamente. Tendrás que gestionar el cambio en el código de tu app tal como se describe a continuación. Para reemplazar la suscripción por otra en Android, llama al método .makePurchase() con el parámetro adicional:

// Create subscription update parameters
var subscriptionUpdateParams = new AdaptySubscriptionUpdateParameters(
    "old_product_id", // Product ID of the current subscription
    AdaptySubscriptionUpdateReplacementMode.WithTimeProration
);

Adapty.MakePurchase(product, subscriptionUpdateParams, (profile, error) => {
  if(error != null) {
      // Handle the error
      return;
  }

  // successful cross-grade
});

Parámetro de solicitud adicional:

Puedes leer más sobre suscripciones y modos de reemplazo en la documentación para desarrolladores de Google:

• Acerca de los modos de reemplazo
• Recomendaciones de Google para los modos de reemplazo
• Modo de reemplazo CHARGE_PRORATED_PRICE. Nota: este método solo está disponible para actualizaciones de suscripción. No se admiten cambios a un plan inferior.
• Modo de reemplazo DEFERRED. Nota: el cambio real de suscripción solo se producirá cuando finalice el período de facturación actual.

Canjear códigos de oferta en iOS

Para mostrar la hoja de canje de códigos en tu app:

Adapty.PresentCodeRedemptionSheet((error) => {
  // handle the error
});

Compras in-app desde el App Store

Cuando un usuario inicia una compra desde la página del producto en el App Store y la transacción llega a tu app, el SDK la completa automáticamente: la pantalla de compra de Apple aparece de inmediato y Adapty procesa la transacción como cualquier otra compra.

Si el producto promocionado incluye una oferta de suscripción, el SDK la aplica automáticamente en el momento de la compra. La oferta se lee del intent de compra de la App Store, que la expone en iOS 18.0 y versiones posteriores. En iOS 16.4–17.x, la compra se realiza al precio base.

Para gestionar las compras promocionadas en tu código, IAdaptyEventListener incluye el método OnReceivePromotedPurchase(AdaptyPromotedProduct) necesario, junto con Adapty.MakePromotedPurchase para completar una compra recibida:

public void OnReceivePromotedPurchase(AdaptyPromotedProduct product) {
    Adapty.MakePromotedPurchase(product, (result, error) => {
        // process the purchase result
    });
}

El SDK aún no entrega las compras promocionadas a este método, sino que las completa automáticamente, por lo que de momento no puedes aplazar una compra promocionada para mostrar algo personalizado antes. Implementa el método de todas formas (es obligatorio por la interfaz); un cuerpo vacío es una implementación válida.

Gestionar planes de prepago (Android)

Si los usuarios de tu app pueden comprar planes de prepago (por ejemplo, adquirir una suscripción no renovable durante varios meses), puedes activar las transacciones pendientes para planes de prepago.

using UnityEngine;
using AdaptySDK;

var builder = new AdaptyConfiguration.Builder("YOUR_API_KEY")
    .SetGoogleEnablePendingPrepaidPlans(true);

Adapty.Activate(builder.Build(), (error) => {
    if (error != null) {
        // handle the error
        return;
    }
});