Activar compras con Flow y Paywall Builder en el SDK de Unity

Esta guía utiliza las APIs del SDK de Unity v4 (beta) de Adapty. Si usas la v3, consulta la guía de migración para los nombres de métodos correspondientes.

Para habilitar las compras in-app, necesitas entender tres conceptos clave:

• Products – todo lo que los usuarios pueden comprar (suscripciones, consumibles, acceso de por vida)
• Flows – secuencias de pantallas que presentan productos a los usuarios, creadas en el Flow & Paywall Builder sin código. El SDK las recupera mediante GetFlow. Si prefieres construir la interfaz en tu propio código, usa un paywall en su lugar — consulta Implementar paywalls manualmente.
• Placements – dónde y cuándo muestras flows en tu app (como main, onboarding, settings). Asocias flows a placements en el dashboard y luego los solicitas por ID de placement en tu código. Esto facilita ejecutar pruebas A/B y mostrar flows distintos a diferentes usuarios.

Adapty te ofrece tres formas de habilitar compras en tu app. Selecciona una según los requisitos de tu aplicación:

Para mostrar un flow creado en el Adapty Flow & Paywall Builder, en el código de tu app solo necesitas:

1. Obtén el flow: Obténlo desde Adapty.
2. Muéstralo y Adapty gestionará las compras por ti: Muestra la vista en tu app.
3. Gestiona las acciones de los botones: Asocia las interacciones del usuario con la respuesta de tu app. Por ejemplo, abre enlaces o cierra el flow cuando el usuario pulse los botones.

Antes de empezar

Antes de empezar, completa estos pasos:

1. Conecta tu app a App Store y/o Google Play en el Adapty Dashboard.
2. Crea tus productos en Adapty.
3. Crea un flow y añade productos a él.
4. Crea un placement y añade tu flow a él.
5. Instala y activa el SDK de Adapty en el código de tu app.

1. Obtener el flow

Tus flows están asociados a placements configurados en el dashboard. Los placements te permiten ejecutar diferentes flows para distintas audiencias o realizar pruebas A/B.

Para obtener un flow creado en el Adapty Flow & Paywall Builder, debes:

1. Obtener el objeto flow por el ID del placement usando el método GetFlow.

2. Crear la vista del flow usando el método CreateFlowView. La vista contiene los elementos de UI y el estilo necesarios para mostrar el flow. Si el flow no tiene ninguna vista configurada, CreateFlowView devuelve un error — trátalo en el callback.

Adapty.GetFlow("YOUR_PLACEMENT_ID", (flow, error) => {
    if (error != null) {
        // handle the error
        return;
    }

    // Create the flow view
    AdaptyUI.CreateFlowView(flow, (view, error) => {
        if (error != null) {
            // the flow has no view configured, or view creation failed
            return;
        }

        // view - the flow view ready to be presented
    });
});

2. Mostrar el flow

Ahora que tienes la vista del flow, basta con añadir unas pocas líneas para mostrarlo.

Para mostrar el flow, usa el método view.Present() sobre el view creado por el método CreateFlowView. Cada view solo puede usarse una vez: después de cerrarlo, llama a CreateFlowView de nuevo para mostrar el flow otra vez.

view.Present((error) => {
    // handle the error
});

3. Gestionar las acciones de los botones

Cuando los usuarios hacen clic en los botones del flow, el SDK de Unity gestiona automáticamente las compras y la restauración. Sin embargo, otros botones tienen IDs personalizados o predefinidos y requieren gestionar las acciones en tu código.

Por ejemplo, tu flow probablemente tiene un botón de cierre y URLs que abrir (por ejemplo, los términos de uso y la política de privacidad). Para gestionar estas acciones, tu clase necesita implementar la interfaz IAdaptyFlowsEventsListener y registrarse como oyente.

Ten en cuenta que el flow permanece abierto después de una compra exitosa. Si quieres cerrarlo una vez que la compra finalice, cierra la vista en el callback FlowViewDidFinishPurchase.

public class YourClass : MonoBehaviour, IAdaptyFlowsEventsListener
{
    void Start()
    {
        // Register this class as the flows events listener
        Adapty.SetFlowsEventsListener(this);
    }

    // IAdaptyFlowsEventsListener method - handles button actions
    public void FlowViewDidPerformAction(
        AdaptyUIFlowView view,
        AdaptyUIUserAction action
    ) {
        switch (action.Type) {
            case AdaptyUIUserActionType.Close:
                view.Dismiss(null);
                break;
            case AdaptyUIUserActionType.OpenUrl:
                AdaptyUI.OpenUrl(action.Value, AdaptyWebPresentation.ExternalBrowser, null);
                break;
            default:
                break;
        }
    }

    // IAdaptyFlowsEventsListener method - dismiss the flow after a purchase
    public void FlowViewDidFinishPurchase(
        AdaptyUIFlowView view,
        AdaptyPaywallProduct product,
        AdaptyPurchaseResult purchasedResult
    ) {
        if (purchasedResult.Type != AdaptyPurchaseResultType.UserCancelled) {
            view.Dismiss(null);
        }
    }
}

Pasos siguientes

Tu flow está listo para mostrarse en la app. Prueba tus compras en el sandbox de App Store o en Google Play Store para asegurarte de que puedes completar una compra de prueba desde el flow.

Ahora necesitas verificar el nivel de acceso de los usuarios para asegurarte de mostrar un flow o dar acceso a las funciones de pago a los usuarios correctos.

Ejemplo completo

Así es como todos esos pasos pueden integrarse juntos en tu app.

using System;
using System.Collections.Generic;
using UnityEngine;
using AdaptySDK;

public class FlowManager : MonoBehaviour, IAdaptyFlowsEventsListener
{
    [SerializeField] private string placementId = "YOUR_PLACEMENT_ID";

    void Start()
    {
        // Register for flow events
        Adapty.SetFlowsEventsListener(this);
        GetAndDisplayFlow();
    }

    private void GetAndDisplayFlow()
    {
        Adapty.GetFlow(placementId, (flow, error) => {
            if (error != null) {
                Debug.LogError("Error getting flow: " + error.Message);
                return;
            }

            CreateAndPresentFlowView(flow);
        });
    }

    private void CreateAndPresentFlowView(AdaptyFlow flow)
    {
        AdaptyUI.CreateFlowView(flow, (view, error) => {
            if (error != null) {
                // the flow has no view configured — use custom logic
                Debug.LogError("Error creating flow view: " + error.Message);
                return;
            }

            view.Present((presentError) => {
                if (presentError != null) {
                    Debug.LogError("Error presenting flow: " + presentError.Message);
                    return;
                }

                Debug.Log("Flow presented successfully");
            });
        });
    }

    // IAdaptyFlowsEventsListener implementation
    public void FlowViewDidPerformAction(
        AdaptyUIFlowView view,
        AdaptyUIUserAction action
    ) {
        switch (action.Type) {
            case AdaptyUIUserActionType.Close:
                Debug.Log("Close button pressed");
                view.Dismiss(null);
                break;
            case AdaptyUIUserActionType.OpenUrl:
                AdaptyUI.OpenUrl(action.Value, AdaptyWebPresentation.ExternalBrowser, null);
                break;
            default:
                break;
        }
    }

    public void FlowViewDidFinishPurchase(
        AdaptyUIFlowView view,
        AdaptyPaywallProduct product,
        AdaptyPurchaseResult purchasedResult
    ) {
        if (purchasedResult.Type != AdaptyPurchaseResultType.UserCancelled) {
            view.Dismiss(null);
        }
    }

    // Required interface methods (implement as needed)
    public void FlowViewDidAppear(AdaptyUIFlowView view) { }
    public void FlowViewDidDisappear(AdaptyUIFlowView view) { }
    public void FlowViewDidSelectProduct(AdaptyUIFlowView view, string productId) { }
    public void FlowViewDidStartPurchase(AdaptyUIFlowView view, AdaptyPaywallProduct product) { }
    public void FlowViewDidFailPurchase(AdaptyUIFlowView view, AdaptyPaywallProduct product, AdaptyError error) { }
    public void FlowViewDidStartRestore(AdaptyUIFlowView view) { }
    public void FlowViewDidFinishRestore(AdaptyUIFlowView view, AdaptyProfile profile) { }
    public void FlowViewDidFailRestore(AdaptyUIFlowView view, AdaptyError error) { }
    public void FlowViewDidReceiveError(AdaptyUIFlowView view, AdaptyError error) { }
    public void FlowViewDidFailLoadingProducts(AdaptyUIFlowView view, AdaptyError error) { }
    public void FlowViewDidFinishWebPaymentNavigation(AdaptyUIFlowView view, AdaptyPaywallProduct product, AdaptyError error) { }
    public void FlowViewDidReceiveAnalyticEvent(AdaptyUIFlowView view, string name, IDictionary<string, object> @params) { }

    public void ShowFlow()
    {
        GetAndDisplayFlow();
    }
}