Realizar compras in-app en iOS SDK

En el SDK 3.x, el SDK llama al método delegado shouldAddStorePayment en su lugar:

• Procesar la transacción de inmediato: Devuelve true en shouldAddStorePayment. Esto activará la pantalla del sistema de compra de Apple al instante.
• Almacenar el objeto de producto para procesarlo más tarde: Devuelve false en shouldAddStorePayment y, después, llama a makePurchase con el producto almacenado cuando lo necesites.

final class YourAdaptyDelegateImplementation: AdaptyDelegate {
    nonisolated func shouldAddStorePayment(for product: AdaptyDeferredProduct) -> Bool {
        // 1a.
        // Return `true` to continue the transaction in your app. The Apple purchase system screen will show automatically.

        // 1b.
        // Store the product object and return `false` to defer or cancel the transaction.
        false
    }
    
    // 2. Continue the deferred purchase later on by passing the product to `makePurchase` when the timing is appropriate
    func continueDeferredPurchase() async {
        let storedProduct: AdaptyDeferredProduct = // get the product object from 1b.
        do {
            try await Adapty.makePurchase(product: storedProduct)
        } catch {
            // handle the error
        }
    }
}

Los códigos de oferta te permiten dar descuentos o períodos de prueba gratuitos a usuarios específicos. A diferencia de las ofertas regulares que se aplican automáticamente, los códigos de oferta se distribuyen fuera de la app — a través de campañas de correo electrónico, redes sociales o materiales impresos. Los usuarios los canjean introduciendo el código en el App Store, siguiendo una URL de canje o a través de un diálogo dentro de la app.

Para configurar códigos de oferta, abre una suscripción en App Store Connect y ve a su sección Offer Codes. Puedes crear tres tipos de códigos de oferta:

• Free — la suscripción es gratuita durante un período determinado, y la siguiente renovación se realiza al precio completo.
• Pay as you go — el usuario paga un precio con descuento en cada ciclo de facturación durante un período determinado, luego la suscripción se renueva al precio completo.
• Pay up front — el usuario paga un precio único con descuento por toda la duración de la oferta, luego la suscripción se renueva al precio completo.

No es necesario añadir los códigos de oferta a Adapty. Apple etiqueta cada transacción durante el período de la oferta con la categoría del código de oferta. Esto incluye el canje inicial y todas las renovaciones con descuento posteriores. Adapty detecta la etiqueta y registra cada transacción con la categoría de oferta offer_code. Una vez que el período de oferta termina y la suscripción se renueva al precio completo, la etiqueta ya no está presente. Puedes filtrar los análisis por el tipo de oferta Offer Code en el Adapty Dashboard.

Solución de problemas de discrepancias en ingresos

Si observas que una transacción con código de oferta aparece en Adapty al precio completo del producto en lugar del precio con descuento de la oferta, verifica lo siguiente en App Store Connect:

• El código de oferta tiene el precio correcto configurado para todas las regiones donde los usuarios pueden canjearlo.
• El precio de la oferta está establecido para el país o región específico del usuario. Apple envía el precio regional en la transacción. Si no hay ningún precio regional configurado para la oferta, Apple puede enviar el precio completo del producto en su lugar.

Puedes filtrar y verificar las transacciones con códigos de oferta en el Adapty Dashboard mediante los filtros de tipo de oferta Offer Code y Offer Discount Type.

Códigos promocionales heredados (obsoletos)

Los códigos promocionales heredados (limitados a 100 por app por versión) otorgaban acceso gratuito a una suscripción. A diferencia de los códigos de oferta, Apple no incluía información de descuento en las transacciones con códigos promocionales — enviaba el precio completo del producto en el recibo. Como resultado, Adapty registraba estas transacciones al precio completo, lo que causaba discrepancias de ingresos entre los análisis de Adapty y App Store Connect.

Si ves transacciones históricas al precio completo que deberían haber sido gratuitas, es probable que provengan de códigos promocionales heredados. Dado que estos códigos están ahora obsoletos, haz la transición a los códigos de oferta para un seguimiento preciso de los ingresos.