Tutorial: Personalización del estilo de los mensajes mediante pares clave-valor
Sigue el código de ejemplo de este tutorial para personalizar el estilo de los mensajes dentro de la aplicación utilizando pares clave-valor en 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.
Personalización del estilo de los mensajes mediante pares clave-valor 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. Acceder a la propiedad message.extras {#4-access-the-messageextras-property}
Utiliza message.extras para acceder a los tipos de personalización, los atributos de estilo o cualquier otro valor definido en el dashboard. Todos los valores se devuelven como cadenas.
5. Llamada condicional a showInAppMessage {#5-conditionally-call-showinappmessage}
Para mostrar el mensaje, llama a showInAppMessage(message). De lo contrario, utiliza las propiedades personalizadas según sea necesario.
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.
Personalización del estilo de los mensajes mediante pares clave-valor para Android
Estamos probando este nuevo formato de tutorial. Dinos qué opinan — sus comentarios nos ayudan a mejorar las guías futuras.
1. Habilitar depuración (opcional) {#1-enable-debugging-optional}
Para facilitar la solución de problemas durante el desarrollo, considera habilitar la depuración.
2. Registrar las devoluciones de llamada del ciclo de vida de la actividad {#2-register-activity-lifecycle-callbacks}
Registra el listener predeterminado de Braze para gestionar el ciclo de vida de los mensajes dentro de la aplicación.
3. Crear tu clase de fábrica de vistas personalizada {#3-create-your-custom-view-factory-class}
Asegúrate de que tu clase cumpla con IInAppMessageViewFactory para que pueda construir y devolver vistas de mensajes personalizadas.
4. Delegar a la fábrica predeterminada de Braze {#4-delegate-to-brazes-default-factory}
Delega en la fábrica predeterminada para conservar el estilo integrado de Braze antes de aplicar tus propios cambios condicionales.
5. Acceder a los pares clave-valor desde inAppMessage.extras {#5-access-key-value-pairs-from-inappmessageextras}
Utiliza inAppMessage.extras para acceder a los tipos de personalización, los atributos de estilo o cualquier otro valor definido en el dashboard. Aplica las modificaciones de estilo antes de devolver la vista.
6. Implementar un IInAppMessageViewFactory personalizado {#6-implement-a-custom-iinappmessageviewfactory}
Implementa IInAppMessageViewFactory en tu clase personalizada para construir y renderizar vistas de mensajes dentro de la aplicación.
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.
Personalización del estilo de los mensajes mediante pares clave-valor para Swift
Estamos probando este nuevo formato de tutorial. Dinos qué opinan — sus comentarios nos ayudan a mejorar las guías futuras.
1. Implementar BrazeInAppMessageUIDelegate {#1-implement-brazeinappmessageuidelegate}
En tu clase AppDelegate, implementa 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. Preparar los mensajes antes de que se muestren {#3-prepare-messages-before-theyre-displayed}
Braze llama a inAppMessage(_:prepareWith:) durante la preparación del mensaje. Úsalo para personalizar el estilo o aplicar lógica basada en pares clave-valor.
4. Acceder a los pares clave-valor desde message.extras {#4-access-key-value-pairs-from-messageextras}
Utiliza message.extras para acceder a los tipos de personalización, los atributos de estilo o cualquier otro valor definido en el dashboard.
5. Actualizar los atributos de estilo del mensaje {#5-update-the-messages-styling-attributes}
Utiliza inAppMessage(_:prepareWith:) para acceder al PresentationContext y poder modificar directamente los atributos de estilo. Cada tipo de mensaje dentro de la aplicación expone atributos diferentes.