Tutorial: Aplazamiento y restauración de mensajes desencadenados
Sigue el código de ejemplo de este tutorial para aplazar y restaurar mensajes desencadenados dentro de la aplicación utilizando el SDK de Braze.
Requisitos previos
Antes de poder utilizar esta característica, tendrás que integrar el SDK de Web Braze. Sin embargo, no es necesario realizar ninguna configuración adicional.
Aplazamiento y restauración de mensajes desencadenados para Web
Estamos probando este nuevo formato de tutorial. Dinos qué opinan — sus comentarios nos ayudan a mejorar las guías futuras.
1. Eliminar llamadas a automaticallyShowInAppMessages() {#1-remove-calls-to-automaticallyshowinappmessages}
Elimina cualquier llamada a automaticallyShowInAppMessages() , ya que anularán cualquier lógica personalizada que implementes más adelante.
2. Habilitar depuración (opcional) {#2-enable-debugging-optional}
Para facilitar la solución de problemas durante el desarrollo, considera habilitar la depuración.
3. Suscríbete al controlador de devolución de llamada de mensajes dentro de la aplicación {#3-subscribe-to-the-in-app-message-callback-handler}
Registra una devolución de llamada con subscribeToInAppMessage(callback) para recibir un mensaje cada vez que se desencadene un mensaje dentro de la aplicación.
4. Aplazar la instancia message {#4-defer-the-message-instance}
Para aplazar el mensaje, llama a deferInAppMessage(message). Braze serializará y guardará este mensaje para que puedas mostrarlo en una futura carga de la página.
5. Recuperar un mensaje aplazado anteriormente {#5-retrieve-a-previously-deferred-message}
Para recuperar cualquier mensaje aplazado anteriormente, llama a getDeferredInAppMessage().
6. Mostrar el mensaje aplazado {#6-display-the-deferred-message}
Después de recuperar un mensaje aplazado, muéstralo pasándolo a showInAppMessage(message).
7. Mostrar un mensaje inmediatamente {#7-display-a-message-immediately}
Para mostrar un mensaje en lugar de aplazarlo, llama a showInAppMessage(message) directamente en tu devolución de llamada subscribeToInAppMessage.
Requisitos previos
Antes de poder utilizar esta característica, tendrás que integrar el SDK de Android Braze. También tendrás que habilitar los mensajes dentro de la aplicación para Android.
Aplazamiento y restauración de mensajes desencadenados para Android
Estamos probando este nuevo formato de tutorial. Dinos qué opinan — sus comentarios nos ayudan a mejorar las guías futuras.
1. Crear una instancia singleton de Application {#1-create-a-singleton-application-instance}
Utiliza un objeto companion para exponer tu clase Application como un singleton, de modo que se pueda acceder a ella más adelante en tu código.
2. Habilitar depuración (opcional)
Para facilitar la solución de problemas durante el desarrollo, considera habilitar la depuración.
3. Registrar las devoluciones de llamada del ciclo de vida de la actividad {#3-register-activity-lifecycle-callbacks}
Registra el listener predeterminado de Braze para gestionar el ciclo de vida de los mensajes dentro de la aplicación.
4. Configurar un listener de mensajes dentro de la aplicación {#4-set-up-an-in-app-message-listener}
Utiliza BrazeInAppMessageManager para configurar un listener personalizado que intercepte los mensajes antes de que se muestren.
5. Crear lógica condicional {#5-create-conditional-logic}
Utiliza la bandera showMessage para controlar el momento—devuelve DISPLAY_NOW para mostrar el mensaje ahora o DISPLAY_LATER para aplazarlo.
6. Crear un método para mostrar mensajes aplazados {#6-create-a-method-for-displaying-deferred-messages}
Utiliza showDeferredMessage para desencadenar el siguiente mensaje dentro de la aplicación. Cuando showMessage es true, el listener devolverá DISPLAY_NOW.
7. Desencadenar el método desde tu interfaz de usuario {#7-trigger-the-method-from-your-ui}
Para mostrar el mensaje previamente aplazado, llama a showDeferredMessage(true) desde tu interfaz de usuario, por ejemplo, un botón o un toque.
Requisitos previos
Antes de poder utilizar esta característica, tendrás que integrar el SDK de Swift Braze. También tendrás que habilitar los mensajes dentro de la aplicación para Swift.
Aplazamiento y restauración de mensajes desencadenados para Swift
Estamos probando este nuevo formato de tutorial. Dinos qué opinan — sus comentarios nos ayudan a mejorar las guías futuras.
1. Implementar el BrazeInAppMessageUIDelegate {#1-implement-the-brazeinappmessageuidelegate}
En tu clase AppDelegate, implementa el BrazeInAppMessageUIDelegate para que puedas sobrescribir su método inAppMessage más adelante.
2. Habilitar depuración (opcional)
Para facilitar la solución de problemas durante el desarrollo, considera habilitar la depuración.
3. Configurar tu interfaz de usuario de Braze y el delegado {#3-set-up-your-braze-ui-and-delegate}
BrazeInAppMessageUI() muestra mensajes dentro de la aplicación de forma predeterminada. Al asignar self como su delegado, puedes interceptar y gestionar los mensajes antes de que se muestren. Asegúrate de guardar la instancia, ya que la necesitarás más adelante para restaurar los mensajes aplazados.
4. Sobrescribir DisplayChoice con lógica condicional {#4-override-displaychoice-with-conditional-logic}
Sobrescribe inAppMessage(_:displayChoiceForMessage:) para determinar cuándo se debe mostrar un mensaje. Devuelve .now para mostrarlo inmediatamente o .reenqueue para aplazarlo.
5. Crear un método para mostrar mensajes aplazados {#5-create-a-method-to-show-deferred-messages}
Crea un método que llame a showDeferredMessage(true) para mostrar el siguiente mensaje aplazado de la pila. Cuando se llama, showMessage se establece en true, lo que hace que el delegado devuelva .now.
6. Desencadenar el método desde tu interfaz de usuario {#5-trigger-the-method-from-your-ui}
Para mostrar el mensaje previamente aplazado, llama a showDeferredMessage(true) desde tu interfaz de usuario, por ejemplo, un botón o un toque.