Mostrar flows y paywalls - Unity

Display flows and paywalls
✦
Flows Creados en el Flow & Paywall Builder — se renderizan de forma nativa en el dispositivo, sin WebView
✦
Paywalls del antiguo Paywall Builder Todo el contenido creado en el antiguo Paywall Builder

Si has creado un flow o un paywall en el antiguo Paywall Builder, no necesitas preocuparte por renderizarlo en el código de tu app para mostrárselo al usuario. Ese flow o paywall ya incluye tanto lo que se debe mostrar como la forma en que se debe mostrar.

Warning

Esta guía cubre flows y paywalls renderizados por Adapty. El proceso es diferente para paywalls personalizados y el modo Observer.

Para obtener el objeto view que se usa a continuación, consulta Obtener flows y paywalls.

Para mostrar un flow o un paywall, usa el método view.Present() sobre el view creado por el método CreateFlowView. Por defecto, un view descartado se destruye. Para mostrar el flow de nuevo, llama a CreateFlowView otra vez para crear una nueva instancia de view, o conserva el view al descartarlo.

Warning

Reutilizar un view destruido provoca un error.

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

¿Quieres ver un ejemplo real de cómo se integra el SDK de Adapty en una app móvil? Echa un vistazo a nuestras apps de ejemplo, que muestran la configuración completa, incluyendo la visualización de paywalls, la realización de compras y otras funcionalidades básicas.

Mantén la vista para mostrarla de nuevo

Info

Las vistas guardadas están disponibles a partir de la versión 4.3.0 del SDK.

view.Dismiss() libera la vista de la memoria. Para conservarla en su lugar, pasa false como parámetro destroy:

view.Dismiss(false, (error) => {
    // handle the error
});

Vuelve a presentar esa vista y el usuario regresará a la pantalla donde lo dejó, con el estado que el flow había acumulado. La vista conserva su Id, por lo que sus eventos siguen llegando a tu listener con el mismo view.Id.

Una vista que has conservado permanece en memoria hasta que la liberes. Cuando ya no la necesites, llama a view.Destroy():

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

Destroy() descarta la vista primero si todavía está en pantalla. También libera una vista que hayas creado pero nunca presentado, y una vista en formato hoja que el usuario haya deslizado hacia abajo en iOS. No lo llames después de un Dismiss() normal: esa vista ya está liberada y la llamada fallará.

Para mantener una vista cuando el usuario pulsa el botón Close, descártala con destroy: false en tu manejador de la acción Close. El método FlowViewDidPerformAction se ejecuta para cada flow y paywall de tu app, así que compara view.Id para conservar únicamente la vista que planeas volver a mostrar. Guarda la vista en un campo al crearla, para poder compararla y presentarla más tarde:

private AdaptyUIFlowView keptView;

void CreateKeptView(AdaptyFlow flow) {
    AdaptyUI.CreateFlowView(flow, new AdaptyUICreateFlowViewParameters(), (view, error) => {
        if (error != null) {
            // handle the error
            return;
        }
        keptView = view;
    });
}

public void FlowViewDidPerformAction(
    AdaptyUIFlowView view,
    AdaptyUIUserAction action
) {
    switch (action.Type) {
        case AdaptyUIUserActionType.Close:
            view.Dismiss(view.Id != keptView?.Id, null);
            break;
        default:
            // handle other events
            break;
    }
}

Mantén la referencia view guardada: la necesitarás para volver a mostrar el flow o el paywall, y para liberarlo con Destroy(). Después de llamar a keptView.Destroy(), establece keptView en null para que la comparación anterior no coincida con una vista ya liberada. Cualquier otra llamada a view.Dismiss() también libera la vista, incluida la llamada en FlowViewDidReceiveError. Tras un error de vista, crea una nueva con CreateFlowView.

Mostrar diálogo

Usa este método en lugar de los diálogos de alerta nativos cuando se muestre un flow o paywall en Android. En Android, las alertas normales aparecen detrás de la vista del flow, lo que las hace invisibles para los usuarios. Este método garantiza que el diálogo se presente correctamente por encima del flow en todas las plataformas.

var dialog = new AdaptyUIDialogConfiguration()
    .SetTitle("Close this screen?")
    .SetContent("You will lose access to exclusive offers.")
    .SetDefaultActionTitle("Stay")
    .SetSecondaryActionTitle("Close");

AdaptyUI.ShowDialog(view, dialog, (action, error) => {
    if (error == null) {
        if (action == AdaptyUIDialogActionType.Secondary) {
            // User confirmed - close the flow
            view.Dismiss((error) => {
                // handle the error
            });
        }
        // If primary - do nothing, user stays
    }
});

Configurar el estilo de presentación en iOS

Configura cómo se presenta el flow o el paywall en iOS pasando el parámetro iosPresentationStyle al método Present(). El parámetro acepta los valores AdaptyUIIOSPresentationStyle.FullScreen (predeterminado) o AdaptyUIIOSPresentationStyle.PageSheet.

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

El usuario puede deslizar la hoja hacia abajo para cerrarla. La vista permanece en memoria sin una llamada a Dismiss(): preséntala de nuevo o, a partir del SDK 4.3.0, libérala con Destroy().

Si has personalizado un paywall con el Paywall Builder, no necesitas preocuparte por renderizarlo en el código de tu app para mostrárselo al usuario. Ese paywall incluye tanto lo que debe mostrarse como la forma en que debe mostrarse.

Warning

Esta guía cubre el antiguo Paywall Builder, que requiere el SDK de Adapty 3.3.0 o posterior.

Para presentar paywalls personalizados, consulta Presentar paywalls personalizados.

Para mostrar un paywall, usa el método view.Present() sobre el view creado por el método CreatePaywallView. Cada view solo puede usarse una vez. Si necesitas mostrar el paywall de nuevo, llama a CreatePaywallView otra vez para crear una nueva instancia de view.

Warning

Reutilizar el mismo view sin recrearlo puede provocar un error AdaptyUIError.viewAlreadyPresented.

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

¿Quieres ver un ejemplo real de cómo se integra el SDK de Adapty en una app móvil? Echa un vistazo a nuestras apps de ejemplo, que muestran la configuración completa, incluyendo la visualización de paywalls, la realización de compras y otras funcionalidades básicas.

Mostrar diálogo

Usa este método en lugar de los diálogos de alerta nativos cuando hay un paywall visible en Android. En Android, las alertas normales aparecen detrás del paywall y el usuario no puede verlas. Este método garantiza que el diálogo se muestre correctamente por encima del paywall en todas las plataformas.

var dialog = new AdaptyUIDialogConfiguration()
    .SetTitle("Close paywall?")
    .SetContent("You will lose access to exclusive offers.")
    .SetDefaultActionTitle("Stay")
    .SetSecondaryActionTitle("Close");

AdaptyUI.ShowDialog(view, dialog, (action, error) => {
    if (error == null) {
        if (action == AdaptyUIDialogActionType.Secondary) {
            // User confirmed - close the paywall
            view.Dismiss();
        }
        // If primary - do nothing, user stays
    }
});

Configurar el estilo de presentación en iOS

Configura cómo se presenta el paywall en iOS pasando el parámetro iosPresentationStyle al método Present(). El parámetro acepta los valores AdaptyUIIOSPresentationStyle.FullScreen (predeterminado) o AdaptyUIIOSPresentationStyle.PageSheet.

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