Mensajes dentro de la aplicación
Obtén información sobre los mensajes dentro de la aplicación y cómo configurarlos para 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 necesaria ninguna configuración adicional.
Tipos de mensajes
Todos los mensajes dentro de la aplicación heredan su prototipo de InAppMessageque define el comportamiento básico y las características de todos los mensajes dentro de la aplicación. Las subclases prototípicas son SlideUpMessage, ModalMessage, FullScreenMessagey HtmlMessage.
Cada tipo de mensaje dentro de la aplicación es personalizable en contenido, imágenes, iconos, acciones de clic, análisis, visualización y entrega.
SlideUp Los mensajes dentro de la aplicación se llaman así porque tradicionalmente, en las plataformas móviles, se “deslizan hacia arriba” o “se deslizan hacia abajo” desde la parte superior o inferior de la pantalla. En el SDK Web de Braze, estos mensajes se muestran más como una notificación estilo Growl o Toast para alinearse con el paradigma dominante en la Web. Cubren una pequeña parte de la pantalla y proporcionan una capacidad de mensajería eficaz y no intrusiva.
Modal Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Útiles para una mensajería más crítica, pueden equiparse con hasta dos botones de acción por clic y habilitados para análisis.
Full Los mensajes dentro de la aplicación son útiles para maximizar el contenido y el impacto de tu comunicación con el usuario. En ventanas de navegador estrechas (por ejemplo, la web móvil), los mensajes dentro de la aplicación full ocupan toda la ventana del navegador. En las ventanas más grandes del explorador, los mensajes dentro de la aplicación full aparecen de forma similar a los mensajes dentro de la aplicación modal. La mitad superior de un mensaje dentro de la aplicación full contiene una imagen, y la mitad inferior permite hasta ocho líneas de texto, así como hasta dos botones de acción de clic y habilitación de análisis.
HTML Los mensajes dentro de la aplicación son útiles para crear contenido de usuario totalmente personalizado. El HTML definido por el usuario se muestra en un iFrame y puede contener contenido enriquecido, como imágenes, fuentes, videos y elementos interactivos, lo que permite un control total sobre la apariencia y funcionalidad del mensaje. Éstos admiten una interfaz JavaScript brazeBridge para llamar a métodos del SDK de la Web de Braze desde dentro de tu HTML, consulta nuestras mejores prácticas para más detalles.
Para habilitar los mensajes HTML dentro de la aplicación a través del SDK Web, debes proporcionar la opción de inicialización allowUserSuppliedJavascript a Braze, por ejemplo, braze.initialize('YOUR-API_KEY', {allowUserSuppliedJavascript: true}). Esto es por razones de seguridad. Los mensajes HTML dentro de la aplicación pueden ejecutar JavaScript, por lo que necesitamos que un mantenedor del sitio los habilite.
El siguiente ejemplo muestra un mensaje HTML paginado dentro de la aplicación:
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.
Tipos de mensajes
Braze ofrece varios tipos de mensajes predeterminados dentro de la aplicación, cada uno de los cuales se puede personalizar con mensajes, imágenes, iconos Font Awesome, acciones al hacer clic, análisis, combinaciones de colores y mucho más.
Tu comportamiento y características básicas se definen mediante laIInAppMessageinterfaz, en una subclase denominada InAppMessageBase.IInAppMessageTambién incluye una subinterfaz, IInAppMessageImmersive, que permite añadir botones de cierre, de clic y de análisis a la aplicación.
Ten en cuenta que los mensajes dentro de la aplicación que contengan botones incluirán elclickActionmensaje en la carga útil final si la acción de clic se añade antes de añadir el texto del botón.
slideup Los mensajes dentro de la aplicación se llaman así porque “se deslizan hacia arriba” o “se deslizan hacia abajo” desde la parte superior o inferior de la pantalla. Cubren una pequeña parte de la pantalla y proporcionan una capacidad de mensajería eficaz y no intrusiva.
El objeto de mensaje dentro de la aplicación slideup extiende InAppMessageBase.
modal Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Son útiles para una mensajería más crítica y pueden equiparse con dos botones de acción de clic y habilitación de análisis.
Este tipo de mensaje es una subclase de InAppMessageImmersiveBase, una clase abstracta que implementa IInAppMessageImmersive, lo que te ofrece la opción de añadir funcionalidades personalizadas a tus mensajes generados localmente dentro de la aplicación.
full Los mensajes dentro de la aplicación son útiles para maximizar el contenido y el impacto de tu comunicación con el usuario. La mitad superior de un mensaje dentro de la aplicación full contiene una imagen, y la mitad inferior muestra texto y hasta dos botones de acción de clic y habilitación de análisis.
Este tipo de mensaje amplía InAppMessageImmersiveBase, ofreciéndote la opción de añadir funcionalidades personalizadas a tus mensajes generados localmente dentro de la aplicación.
HTML Los mensajes dentro de la aplicación son útiles para crear contenido de usuario totalmente personalizado. El contenido HTML de los mensajes dentro de la aplicación, definido por el usuario, se muestra en WebView y puede contener opcionalmente otros contenidos enriquecidos, como imágenes y fuentes, lo que permite un control total sobre el aspecto y la funcionalidad de los mensajes.
Este tipo de mensaje implementa IInAppMessageHtml, que es una subclase de IInAppMessage.
En Android, los enlaces configurados contarget="_blank" en mensajes HTML personalizados dentro de la aplicación se abren en el navegador web predeterminado del dispositivo.
Los mensajes dentro de la aplicación Android admiten una interfaz brazeBridgeJavaScript para llamar a métodos en el SDK de Braze para Android desde tu HTML. Consulta nuestra página sobre el puente JavaScript para obtener más detalles.
Actualmente no admitimos la visualización de mensajes HTML personalizados dentro de la aplicación en un iFrame en las plataformas iOS y Android.
También puedes definir vistas de mensajes personalizados dentro de la aplicación para tu aplicación. Para obtener una guía completa, consulta Configuración de fábricas personalizadas.
Habilitación de mensajes dentro de la aplicación
Paso 1: Realizar el registro BrazeInAppMessageManager
La visualización de mensajes dentro de la aplicación es gestionada por la clase BrazeInAppMessageManager. Cada actividad de tu aplicación debe registrarse en BrazeInAppMessageManager para que pueda añadir vistas de mensajes dentro de la aplicación a la jerarquía de vistas. Hay dos formas de conseguirlo:
La integración de la devolución de llamada del ciclo de vida de la actividad gestiona automáticamente el registro de mensajes dentro de la aplicación; no se requiere ninguna integración adicional. Este es el método recomendado para gestionar el registro de mensajes dentro de la aplicación.
Si utilizas la devolución de llamada del ciclo de vida de la actividad para el registro automático, no completes este paso.
En tu Application.onCreate(), llama alensureSubscribedToInAppMessageEvents() :
1
BrazeInAppMessageManager.getInstance().ensureSubscribedToInAppMessageEvents(context);
1
BrazeInAppMessageManager.getInstance().ensureSubscribedToInAppMessageEvents(context)
En cada actividad en la que se puedan mostrar mensajes dentro de la aplicación, llama aregisterInAppMessageManager() en esa actividadonResume():
1
2
3
4
5
6
7
@Override
public void onResume() {
super.onResume();
// Registers the BrazeInAppMessageManager for the current Activity. This Activity will now listen for
// in-app messages from Braze.
BrazeInAppMessageManager.getInstance().registerInAppMessageManager(activity);
}
1
2
3
4
5
6
public override fun onResume() {
super.onResume()
// Registers the BrazeInAppMessageManager for the current Activity. This Activity will now listen for
// in-app messages from Braze.
BrazeInAppMessageManager.getInstance().registerInAppMessageManager(this)
}
En cada actividad en la queregisterInAppMessageManager()se haya llamado a , llama aunregisterInAppMessageManager() en la actividad onPause():
1
2
3
4
5
6
@Override
public void onPause() {
super.onPause();
// Unregisters the BrazeInAppMessageManager for the current Activity.
BrazeInAppMessageManager.getInstance().unregisterInAppMessageManager(activity);
}
1
2
3
4
5
public override fun onPause() {
super.onPause()
// Unregisters the BrazeInAppMessageManager.
BrazeInAppMessageManager.getInstance().unregisterInAppMessageManager(this)
}
Paso 2: Actualiza la lista de bloqueados del administrador (opcional)
En tu integración, puedes requerir que ciertas actividades de tu aplicación no muestren mensajes dentro de la aplicación. La integración de la devolución de llamada del ciclo de vida de la actividad proporciona una forma sencilla de conseguirlo.
El siguiente código de ejemplo añade dos actividades a la lista de bloqueo de registro de mensajes dentro de la aplicación, SplashActivity y SettingsActivity:
1
2
3
4
5
6
7
8
9
10
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
Set<Class> inAppMessageBlocklist = new HashSet<>();
inAppMessageBlocklist.add(SplashActivity.class);
inAppMessageBlocklist.add(SettingsActivity.class);
registerActivityLifecycleCallbacks(new BrazeActivityLifecycleCallbackListener(inAppMessageBlocklist));
}
}
1
2
3
4
5
6
7
8
9
class MyApplication : Application() {
override fun onCreate() {
super.onCreate()
val inAppMessageBlocklist = HashSet<Class<*>>()
inAppMessageBlocklist.add(SplashActivity::class.java)
inAppMessageBlocklist.add(SettingsActivity::class.java)
registerActivityLifecycleCallbacks(BrazeActivityLifecycleCallbackListener(inAppMessageBlocklist))
}
}
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.
Tipos de mensajes
Cada tipo de mensaje dentro de la aplicación es altamente personalizable en cuanto a contenido, imágenes, iconos, acciones de clic, análisis, visualización y entrega. Son tipos enumerados de Braze.InAppMessage, que define el comportamiento y los rasgos básicos de todos los mensajes dentro de la aplicación. Para ver la lista completa de propiedades y usos de los mensajes dentro de la aplicación, consulta la claseInAppMessage .
Estos son los tipos de mensajes dentro de la aplicación disponibles en Braze y cómo serán para los usuarios finales.
Slideup Los mensajes dentro de la aplicación reciben este nombre porque se “deslizan hacia arriba” o “hacia abajo” desde la parte superior o inferior de la pantalla. Cubren una pequeña parte de la pantalla y proporcionan una capacidad de mensajería eficaz y no intrusiva.
Modal Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Útiles para una mensajería más crítica, pueden equiparse con hasta dos botones habilitados para análisis.
Modal Image Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Estos mensajes son similares a los del tipo Modal, excepto que no tienen cabecera ni texto de mensaje. Útiles para una mensajería más crítica, pueden equiparse con hasta dos botones habilitados para análisis.
Full Los mensajes dentro de la aplicación son útiles para maximizar el contenido y el impacto de tu comunicación con el usuario. La mitad superior de un mensaje dentro de la aplicación Full contiene una imagen, y la mitad inferior muestra texto y hasta dos botones habilitados para el análisis.
Full Image Los mensajes dentro de la aplicación son similares a los mensajes dentro de la aplicación Full, excepto que no tienen cabecera ni texto de mensaje. Este tipo de mensaje es útil para maximizar el contenido y el impacto de tu comunicación con el usuario. Un mensaje dentro de la aplicación Full Image contiene una imagen que abarca toda la pantalla, con la opción de mostrar hasta dos botones habilitados para el análisis.
HTML Los mensajes dentro de la aplicación son útiles para crear contenido de usuario totalmente personalizado. El contenido HTML completo de los mensajes dentro de la aplicación, definido por el usuario, se muestra en WKWebViewy puede contener opcionalmente otros contenidos enriquecidos, como imágenes y fuentes, lo que permite un control total sobre el aspecto y la funcionalidad de los mensajes.
Los mensajes dentro de la aplicación de iOS admiten una interfaz JavaScript brazeBridge para llamar a métodos del SDK de la Web de Braze desde dentro de tu HTML, consulta nuestras mejores prácticas para obtener más detalles.
El siguiente ejemplo muestra un mensaje HTML completo paginado dentro de la aplicación:
Ten en cuenta que actualmente no admitimos la visualización de mensajes HTML personalizados dentro de la aplicación en un iFrame en las plataformas iOS y Android.
Control Los mensajes dentro de la aplicación no contienen un componente de interfaz de usuario y se utilizan principalmente con fines de análisis. Este tipo se utiliza para verificar la recepción de un mensaje dentro de la aplicación enviado a un grupo de control.
Para más detalles sobre Intelligent Selection y los grupos de control, consulta Intelligent Selection.
Habilitación de mensajes dentro de la aplicación
Paso 1: Crea una implementación de BrazeInAppMessagePresenter
Para que Braze muestre mensajes dentro de la aplicación, crea una implementación del protocolo BrazeInAppMessagePresenter y asígnala a la opción inAppMessagePresenter de tu instancia de Braze. También puedes utilizar el presentador predeterminado de la interfaz de usuario Braze instanciando un objeto BrazeInAppMessageUI.
Ten en cuenta que tendrás que importar la biblioteca BrazeUI para acceder a la clase BrazeInAppMessageUI.
1
AppDelegate.braze?.inAppMessagePresenter = BrazeInAppMessageUI()
1
AppDelegate.braze.inAppMessagePresenter = [[BrazeInAppMessageUI alloc] init];
Paso 2: No desencadenar ninguna coincidencia
Implementa BrazeDelegate.(_:noMatchingTriggerForEvent) dentro de la clase BrazeDelegate correspondiente. Cuando Braze no encuentre un desencadenante que coincida con un evento concreto, llamará a este método automáticamente.
Requisitos previos
Antes de poder utilizar esta característica, tendrás que integrar el SDK de Android Braze.
Sobre el soporte de TV y OTT
El SDK de Braze para Android admite de forma nativa la visualización de mensajes dentro de la aplicación en dispositivos OTT como Android TV o Fire Stick. Sin embargo, hay algunas diferencias clave entre los mensajes nativos de Android y los mensajes dentro de la aplicación OTT. Para dispositivos OTT:
- Los mensajes dentro de la aplicación que requieren el modo táctil, como el deslizamiento hacia arriba, están desactivados en OTT.
- Se resaltará el elemento seleccionado o enfocado en ese momento, como un botón o el botón de cerrar.
- No se admiten los clics corporales en el propio mensaje dentro de la aplicación, como no en un botón.
Requisitos previos
Antes de poder utilizar esta característica, tendrás que integrar el SDK Braze de Cordova.
Tipos de mensajes
Braze ofrece varios tipos de mensajes predeterminados dentro de la aplicación, cada uno de los cuales se puede personalizar con mensajes, imágenes, iconos Font Awesome, acciones al hacer clic, análisis, combinaciones de colores y mucho más.
Tu comportamiento y características básicas se definen mediante laIInAppMessageinterfaz, en una subclase denominada InAppMessageBase.IInAppMessageTambién incluye una subinterfaz, IInAppMessageImmersive, que permite añadir botones de cierre, de clic y de análisis a la aplicación.
Ten en cuenta que los mensajes dentro de la aplicación que contengan botones incluirán elclickActionmensaje en la carga útil final si la acción de clic se añade antes de añadir el texto del botón.
slideup Los mensajes dentro de la aplicación se llaman así porque “se deslizan hacia arriba” o “se deslizan hacia abajo” desde la parte superior o inferior de la pantalla. Cubren una pequeña parte de la pantalla y proporcionan una capacidad de mensajería eficaz y no intrusiva.
El objeto de mensaje dentro de la aplicación slideup extiende InAppMessageBase.
modal Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Son útiles para una mensajería más crítica y pueden equiparse con dos botones de acción de clic y habilitación de análisis.
Este tipo de mensaje es una subclase de InAppMessageImmersiveBase, una clase abstracta que implementa IInAppMessageImmersive, lo que te ofrece la opción de añadir funcionalidades personalizadas a tus mensajes generados localmente dentro de la aplicación.
full Los mensajes dentro de la aplicación son útiles para maximizar el contenido y el impacto de tu comunicación con el usuario. La mitad superior de un mensaje dentro de la aplicación full contiene una imagen, y la mitad inferior muestra texto y hasta dos botones de acción de clic y habilitación de análisis.
Este tipo de mensaje amplía InAppMessageImmersiveBase, ofreciéndote la opción de añadir funcionalidades personalizadas a tus mensajes generados localmente dentro de la aplicación.
HTML Los mensajes dentro de la aplicación son útiles para crear contenido de usuario totalmente personalizado. El contenido HTML de los mensajes dentro de la aplicación, definido por el usuario, se muestra en WebView y puede contener opcionalmente otros contenidos enriquecidos, como imágenes y fuentes, lo que permite un control total sobre el aspecto y la funcionalidad de los mensajes.
Este tipo de mensaje implementa IInAppMessageHtml, que es una subclase de IInAppMessage.
En Android, los enlaces configurados contarget="_blank" en mensajes HTML personalizados dentro de la aplicación se abren en el navegador web predeterminado del dispositivo.
Los mensajes dentro de la aplicación Android admiten una interfaz brazeBridgeJavaScript para llamar a métodos en el SDK de Braze para Android desde tu HTML. Consulta nuestra página sobre el puente JavaScript para obtener más detalles.
Actualmente no admitimos la visualización de mensajes HTML personalizados dentro de la aplicación en un iFrame en las plataformas iOS y Android.
También puedes definir vistas de mensajes personalizados dentro de la aplicación para tu aplicación. Para obtener una guía completa, consulta Configuración de fábricas personalizadas.
Cada tipo de mensaje dentro de la aplicación es altamente personalizable en cuanto a contenido, imágenes, iconos, acciones de clic, análisis, visualización y entrega. Son tipos enumerados de Braze.InAppMessage, que define el comportamiento y los rasgos básicos de todos los mensajes dentro de la aplicación. Para ver la lista completa de propiedades y usos de los mensajes dentro de la aplicación, consulta la claseInAppMessage .
Estos son los tipos de mensajes dentro de la aplicación disponibles en Braze y cómo serán para los usuarios finales.
Slideup Los mensajes dentro de la aplicación reciben este nombre porque se “deslizan hacia arriba” o “hacia abajo” desde la parte superior o inferior de la pantalla. Cubren una pequeña parte de la pantalla y proporcionan una capacidad de mensajería eficaz y no intrusiva.
Modal Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Útiles para una mensajería más crítica, pueden equiparse con hasta dos botones habilitados para análisis.
Modal Image Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Estos mensajes son similares a los del tipo Modal, excepto que no tienen cabecera ni texto de mensaje. Útiles para una mensajería más crítica, pueden equiparse con hasta dos botones habilitados para análisis.
Full Los mensajes dentro de la aplicación son útiles para maximizar el contenido y el impacto de tu comunicación con el usuario. La mitad superior de un mensaje dentro de la aplicación Full contiene una imagen, y la mitad inferior muestra texto y hasta dos botones habilitados para el análisis.
Full Image Los mensajes dentro de la aplicación son similares a los mensajes dentro de la aplicación Full, excepto que no tienen cabecera ni texto de mensaje. Este tipo de mensaje es útil para maximizar el contenido y el impacto de tu comunicación con el usuario. Un mensaje dentro de la aplicación Full Image contiene una imagen que abarca toda la pantalla, con la opción de mostrar hasta dos botones habilitados para el análisis.
HTML Los mensajes dentro de la aplicación son útiles para crear contenido de usuario totalmente personalizado. El contenido HTML completo de los mensajes dentro de la aplicación, definido por el usuario, se muestra en WKWebViewy puede contener opcionalmente otros contenidos enriquecidos, como imágenes y fuentes, lo que permite un control total sobre el aspecto y la funcionalidad de los mensajes.
Los mensajes dentro de la aplicación de iOS admiten una interfaz JavaScript brazeBridge para llamar a métodos del SDK de la Web de Braze desde dentro de tu HTML, consulta nuestras mejores prácticas para obtener más detalles.
El siguiente ejemplo muestra un mensaje HTML completo paginado dentro de la aplicación:
Ten en cuenta que actualmente no admitimos la visualización de mensajes HTML personalizados dentro de la aplicación en un iFrame en las plataformas iOS y Android.
Control Los mensajes dentro de la aplicación no contienen un componente de interfaz de usuario y se utilizan principalmente con fines de análisis. Este tipo se utiliza para verificar la recepción de un mensaje dentro de la aplicación enviado a un grupo de control.
Para más detalles sobre Intelligent Selection y los grupos de control, consulta Intelligent Selection.
Requisitos previos
Antes de poder utilizar esta característica, tendrás que integrar el SDK de Flutter Braze.
Tipos de mensajes
Braze ofrece varios tipos de mensajes predeterminados dentro de la aplicación, cada uno de los cuales se puede personalizar con mensajes, imágenes, iconos Font Awesome, acciones al hacer clic, análisis, combinaciones de colores y mucho más.
Tu comportamiento y características básicas se definen mediante laIInAppMessageinterfaz, en una subclase denominada InAppMessageBase.IInAppMessageTambién incluye una subinterfaz, IInAppMessageImmersive, que permite añadir botones de cierre, de clic y de análisis a la aplicación.
Ten en cuenta que los mensajes dentro de la aplicación que contengan botones incluirán elclickActionmensaje en la carga útil final si la acción de clic se añade antes de añadir el texto del botón.
slideup Los mensajes dentro de la aplicación se llaman así porque “se deslizan hacia arriba” o “se deslizan hacia abajo” desde la parte superior o inferior de la pantalla. Cubren una pequeña parte de la pantalla y proporcionan una capacidad de mensajería eficaz y no intrusiva.
El objeto de mensaje dentro de la aplicación slideup extiende InAppMessageBase.
modal Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Son útiles para una mensajería más crítica y pueden equiparse con dos botones de acción de clic y habilitación de análisis.
Este tipo de mensaje es una subclase de InAppMessageImmersiveBase, una clase abstracta que implementa IInAppMessageImmersive, lo que te ofrece la opción de añadir funcionalidades personalizadas a tus mensajes generados localmente dentro de la aplicación.
full Los mensajes dentro de la aplicación son útiles para maximizar el contenido y el impacto de tu comunicación con el usuario. La mitad superior de un mensaje dentro de la aplicación full contiene una imagen, y la mitad inferior muestra texto y hasta dos botones de acción de clic y habilitación de análisis.
Este tipo de mensaje amplía InAppMessageImmersiveBase, ofreciéndote la opción de añadir funcionalidades personalizadas a tus mensajes generados localmente dentro de la aplicación.
HTML Los mensajes dentro de la aplicación son útiles para crear contenido de usuario totalmente personalizado. El contenido HTML de los mensajes dentro de la aplicación, definido por el usuario, se muestra en WebView y puede contener opcionalmente otros contenidos enriquecidos, como imágenes y fuentes, lo que permite un control total sobre el aspecto y la funcionalidad de los mensajes.
Este tipo de mensaje implementa IInAppMessageHtml, que es una subclase de IInAppMessage.
En Android, los enlaces configurados contarget="_blank" en mensajes HTML personalizados dentro de la aplicación se abren en el navegador web predeterminado del dispositivo.
Los mensajes dentro de la aplicación Android admiten una interfaz brazeBridgeJavaScript para llamar a métodos en el SDK de Braze para Android desde tu HTML. Consulta nuestra página sobre el puente JavaScript para obtener más detalles.
Actualmente no admitimos la visualización de mensajes HTML personalizados dentro de la aplicación en un iFrame en las plataformas iOS y Android.
También puedes definir vistas de mensajes personalizados dentro de la aplicación para tu aplicación. Para obtener una guía completa, consulta Configuración de fábricas personalizadas.
Cada tipo de mensaje dentro de la aplicación es altamente personalizable en cuanto a contenido, imágenes, iconos, acciones de clic, análisis, visualización y entrega. Son tipos enumerados de Braze.InAppMessage, que define el comportamiento y los rasgos básicos de todos los mensajes dentro de la aplicación. Para ver la lista completa de propiedades y usos de los mensajes dentro de la aplicación, consulta la claseInAppMessage .
Estos son los tipos de mensajes dentro de la aplicación disponibles en Braze y cómo serán para los usuarios finales.
Slideup Los mensajes dentro de la aplicación reciben este nombre porque se “deslizan hacia arriba” o “hacia abajo” desde la parte superior o inferior de la pantalla. Cubren una pequeña parte de la pantalla y proporcionan una capacidad de mensajería eficaz y no intrusiva.
Modal Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Útiles para una mensajería más crítica, pueden equiparse con hasta dos botones habilitados para análisis.
Modal Image Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Estos mensajes son similares a los del tipo Modal, excepto que no tienen cabecera ni texto de mensaje. Útiles para una mensajería más crítica, pueden equiparse con hasta dos botones habilitados para análisis.
Full Los mensajes dentro de la aplicación son útiles para maximizar el contenido y el impacto de tu comunicación con el usuario. La mitad superior de un mensaje dentro de la aplicación Full contiene una imagen, y la mitad inferior muestra texto y hasta dos botones habilitados para el análisis.
Full Image Los mensajes dentro de la aplicación son similares a los mensajes dentro de la aplicación Full, excepto que no tienen cabecera ni texto de mensaje. Este tipo de mensaje es útil para maximizar el contenido y el impacto de tu comunicación con el usuario. Un mensaje dentro de la aplicación Full Image contiene una imagen que abarca toda la pantalla, con la opción de mostrar hasta dos botones habilitados para el análisis.
HTML Los mensajes dentro de la aplicación son útiles para crear contenido de usuario totalmente personalizado. El contenido HTML completo de los mensajes dentro de la aplicación, definido por el usuario, se muestra en WKWebViewy puede contener opcionalmente otros contenidos enriquecidos, como imágenes y fuentes, lo que permite un control total sobre el aspecto y la funcionalidad de los mensajes.
Los mensajes dentro de la aplicación de iOS admiten una interfaz JavaScript brazeBridge para llamar a métodos del SDK de la Web de Braze desde dentro de tu HTML, consulta nuestras mejores prácticas para obtener más detalles.
El siguiente ejemplo muestra un mensaje HTML completo paginado dentro de la aplicación:
Ten en cuenta que actualmente no admitimos la visualización de mensajes HTML personalizados dentro de la aplicación en un iFrame en las plataformas iOS y Android.
Control Los mensajes dentro de la aplicación no contienen un componente de interfaz de usuario y se utilizan principalmente con fines de análisis. Este tipo se utiliza para verificar la recepción de un mensaje dentro de la aplicación enviado a un grupo de control.
Para más detalles sobre Intelligent Selection y los grupos de control, consulta Intelligent Selection.
Habilitación de mensajes dentro de la aplicación
El SDK de Braze para Flutter configura automáticamente el presentador predeterminado de mensajes dentro de la aplicación tanto en Android como en iOS. Los mensajes dentro de la aplicación se muestran y se reenvían a la capa Dart sin configuración adicional.
Personalización del presentador de mensajes dentro de la aplicación en iOS
Para anular el presentador predeterminado de mensajes dentro de la aplicación en iOS, utiliza el closure postInitialization en BrazePlugin.configure(_:postInitialization:). Tu presentador personalizado debe llamar a BrazePlugin.processInAppMessage(message) para reenviar los datos del mensaje dentro de la aplicación a la capa Dart.
1
2
3
4
5
6
7
8
9
10
11
import BrazeUI
BrazePlugin.configure(
{ configuration in
// Set non-API-key configurations here.
},
postInitialization: { braze in
let customPresenter = CustomInAppMessagePresenter()
braze.inAppMessagePresenter = customPresenter
}
)
En la clase del presentador personalizado, llama a BrazePlugin.processInAppMessage(message) y super.present(message: message) para reenviar los datos a Dart y mostrar la interfaz de usuario predeterminada.
1
2
3
4
5
6
class CustomInAppMessagePresenter: BrazeInAppMessageUI {
override func present(message: Braze.InAppMessage) {
BrazePlugin.processInAppMessage(message)
super.present(message: message)
}
}
Este paso es solo para iOS. La implementación predeterminada para los mensajes dentro de la aplicación ya está configurada en Android.
Para configurar el presentador predeterminado para los mensajes dentro de la aplicación en iOS, crea una implementación del protocolo BrazeInAppMessagePresenter y asígnala al opcional inAppMessagePresenter en tu instancia de Braze. También puedes utilizar el presentador predeterminado de la interfaz de usuario de Braze instanciando un objeto BrazeInAppMessageUI.
Debes importar la biblioteca BrazeUI para acceder a la clase BrazeInAppMessageUI.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
import BrazeUI
override func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil
) -> Bool {
...
let braze = BrazePlugin.initBraze(configuration)
braze.inAppMessagePresenter = BrazeInAppMessageUI()
AppDelegate.braze = braze
return true
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
@import BrazeUI;
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
...
Braze *braze = [BrazePlugin initBraze:configuration];
braze.inAppMessagePresenter = [[BrazeInAppMessageUI alloc] init];
AppDelegate.braze = braze;
[self.window makeKeyAndVisible];
return YES;
}
Para más información sobre cómo acceder a los datos de los mensajes dentro de la aplicación, consulta Registro de datos de mensajes dentro de la aplicación.
Requisitos previos
Antes de poder utilizar esta característica, tendrás que integrar el SDK Braze de React Native.
Tipos de mensajes
Braze ofrece varios tipos de mensajes predeterminados dentro de la aplicación, cada uno de los cuales se puede personalizar con mensajes, imágenes, iconos Font Awesome, acciones al hacer clic, análisis, combinaciones de colores y mucho más.
Tu comportamiento y características básicas se definen mediante laIInAppMessageinterfaz, en una subclase denominada InAppMessageBase.IInAppMessageTambién incluye una subinterfaz, IInAppMessageImmersive, que permite añadir botones de cierre, de clic y de análisis a la aplicación.
Ten en cuenta que los mensajes dentro de la aplicación que contengan botones incluirán elclickActionmensaje en la carga útil final si la acción de clic se añade antes de añadir el texto del botón.
slideup Los mensajes dentro de la aplicación se llaman así porque “se deslizan hacia arriba” o “se deslizan hacia abajo” desde la parte superior o inferior de la pantalla. Cubren una pequeña parte de la pantalla y proporcionan una capacidad de mensajería eficaz y no intrusiva.
El objeto de mensaje dentro de la aplicación slideup extiende InAppMessageBase.
modal Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Son útiles para una mensajería más crítica y pueden equiparse con dos botones de acción de clic y habilitación de análisis.
Este tipo de mensaje es una subclase de InAppMessageImmersiveBase, una clase abstracta que implementa IInAppMessageImmersive, lo que te ofrece la opción de añadir funcionalidades personalizadas a tus mensajes generados localmente dentro de la aplicación.
full Los mensajes dentro de la aplicación son útiles para maximizar el contenido y el impacto de tu comunicación con el usuario. La mitad superior de un mensaje dentro de la aplicación full contiene una imagen, y la mitad inferior muestra texto y hasta dos botones de acción de clic y habilitación de análisis.
Este tipo de mensaje amplía InAppMessageImmersiveBase, ofreciéndote la opción de añadir funcionalidades personalizadas a tus mensajes generados localmente dentro de la aplicación.
HTML Los mensajes dentro de la aplicación son útiles para crear contenido de usuario totalmente personalizado. El contenido HTML de los mensajes dentro de la aplicación, definido por el usuario, se muestra en WebView y puede contener opcionalmente otros contenidos enriquecidos, como imágenes y fuentes, lo que permite un control total sobre el aspecto y la funcionalidad de los mensajes.
Este tipo de mensaje implementa IInAppMessageHtml, que es una subclase de IInAppMessage.
En Android, los enlaces configurados contarget="_blank" en mensajes HTML personalizados dentro de la aplicación se abren en el navegador web predeterminado del dispositivo.
Los mensajes dentro de la aplicación Android admiten una interfaz brazeBridgeJavaScript para llamar a métodos en el SDK de Braze para Android desde tu HTML. Consulta nuestra página sobre el puente JavaScript para obtener más detalles.
Actualmente no admitimos la visualización de mensajes HTML personalizados dentro de la aplicación en un iFrame en las plataformas iOS y Android.
También puedes definir vistas de mensajes personalizados dentro de la aplicación para tu aplicación. Para obtener una guía completa, consulta Configuración de fábricas personalizadas.
Cada tipo de mensaje dentro de la aplicación es altamente personalizable en cuanto a contenido, imágenes, iconos, acciones de clic, análisis, visualización y entrega. Son tipos enumerados de Braze.InAppMessage, que define el comportamiento y los rasgos básicos de todos los mensajes dentro de la aplicación. Para ver la lista completa de propiedades y usos de los mensajes dentro de la aplicación, consulta la claseInAppMessage .
Estos son los tipos de mensajes dentro de la aplicación disponibles en Braze y cómo serán para los usuarios finales.
Slideup Los mensajes dentro de la aplicación reciben este nombre porque se “deslizan hacia arriba” o “hacia abajo” desde la parte superior o inferior de la pantalla. Cubren una pequeña parte de la pantalla y proporcionan una capacidad de mensajería eficaz y no intrusiva.
Modal Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Útiles para una mensajería más crítica, pueden equiparse con hasta dos botones habilitados para análisis.
Modal Image Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Estos mensajes son similares a los del tipo Modal, excepto que no tienen cabecera ni texto de mensaje. Útiles para una mensajería más crítica, pueden equiparse con hasta dos botones habilitados para análisis.
Full Los mensajes dentro de la aplicación son útiles para maximizar el contenido y el impacto de tu comunicación con el usuario. La mitad superior de un mensaje dentro de la aplicación Full contiene una imagen, y la mitad inferior muestra texto y hasta dos botones habilitados para el análisis.
Full Image Los mensajes dentro de la aplicación son similares a los mensajes dentro de la aplicación Full, excepto que no tienen cabecera ni texto de mensaje. Este tipo de mensaje es útil para maximizar el contenido y el impacto de tu comunicación con el usuario. Un mensaje dentro de la aplicación Full Image contiene una imagen que abarca toda la pantalla, con la opción de mostrar hasta dos botones habilitados para el análisis.
HTML Los mensajes dentro de la aplicación son útiles para crear contenido de usuario totalmente personalizado. El contenido HTML completo de los mensajes dentro de la aplicación, definido por el usuario, se muestra en WKWebViewy puede contener opcionalmente otros contenidos enriquecidos, como imágenes y fuentes, lo que permite un control total sobre el aspecto y la funcionalidad de los mensajes.
Los mensajes dentro de la aplicación de iOS admiten una interfaz JavaScript brazeBridge para llamar a métodos del SDK de la Web de Braze desde dentro de tu HTML, consulta nuestras mejores prácticas para obtener más detalles.
El siguiente ejemplo muestra un mensaje HTML completo paginado dentro de la aplicación:
Ten en cuenta que actualmente no admitimos la visualización de mensajes HTML personalizados dentro de la aplicación en un iFrame en las plataformas iOS y Android.
Control Los mensajes dentro de la aplicación no contienen un componente de interfaz de usuario y se utilizan principalmente con fines de análisis. Este tipo se utiliza para verificar la recepción de un mensaje dentro de la aplicación enviado a un grupo de control.
Para más detalles sobre Intelligent Selection y los grupos de control, consulta Intelligent Selection.
Modelo de datos
El modelo de mensajes dentro de la aplicación está disponible en el SDK de React Native. Braze tiene cuatro tipos de mensajes dentro de la aplicación que comparten el mismo modelo de datos: deslizamiento hacia arriba, modal, completo y HTML completo.
Mensajes
El modelo de mensajes dentro de la aplicación proporciona la base para todos los mensajes dentro de la aplicación.
| Propiedad | Descripción |
|---|---|
inAppMessageJsonString |
La representación JSON del mensaje. |
message |
El texto del mensaje. |
header |
La cabecera del mensaje. |
uri |
La URI asociada a la acción de hacer clic en el botón. |
imageUrl |
La URL de la imagen del mensaje. |
zippedAssetsUrl |
Los activos comprimidos preparados para mostrar contenido HTML. |
useWebView |
Indica si la acción de hacer clic en el botón debe redirigirse utilizando una vista Web. |
duration |
La duración de la visualización del mensaje. |
clickAction |
El tipo de acción de clic del botón. Los tipos son: URI, y NONE. |
dismissType |
El tipo de cierre del mensaje. Los dos tipos son: SWIPE y AUTO_DISMISS. |
messageType |
El tipo de mensaje dentro de la aplicación admitido por el SDK. Los cuatro tipos son: SLIDEUP, MODAL, FULL y HTML_FULL. |
extras |
El diccionario de extras de mensajes. Valor predeterminado: [:]. |
buttons |
La lista de botones del mensaje dentro de la aplicación. |
toString() |
El mensaje como representación de una cadena. |
Para una referencia completa del modelo de mensajes dentro de la aplicación, consulta la documentación de Android e iOS.
Botones de acción
Se pueden añadir botones a los mensajes dentro de la aplicación para realizar acciones y registrar análisis. El modelo de botón proporciona la base para todos los botones de mensajes dentro de la aplicación.
| Propiedad | Descripción |
|---|---|
text |
El texto del botón. |
uri |
La URI asociada a la acción de hacer clic en el botón. |
useWebView |
Indica si la acción de hacer clic en el botón debe redirigirse utilizando una vista Web. |
clickAction |
El tipo de acción de clic que se procesa cuando el usuario hace clic en el botón. Los tipos son: URI, y NONE. |
id |
El ID del botón del mensaje. |
toString() |
El botón como representación de una cadena. |
Para una referencia completa del modelo de botones, consulta la documentación de Android e iOS.
Requisitos previos
Antes de poder utilizar esta característica, tendrás que integrar el SDK de Roku Braze. Además, los mensajes dentro de la aplicación sólo se enviarán a dispositivos Roku que ejecuten la versión mínima compatible del SDK:
Tipos de mensajes
Braze ofrece varios tipos de mensajes predeterminados dentro de la aplicación, cada uno de los cuales se puede personalizar con mensajes, imágenes, iconos Font Awesome, acciones al hacer clic, análisis, combinaciones de colores y mucho más.
Tu comportamiento y características básicas se definen mediante laIInAppMessageinterfaz, en una subclase denominada InAppMessageBase.IInAppMessageTambién incluye una subinterfaz, IInAppMessageImmersive, que permite añadir botones de cierre, de clic y de análisis a la aplicación.
Ten en cuenta que los mensajes dentro de la aplicación que contengan botones incluirán elclickActionmensaje en la carga útil final si la acción de clic se añade antes de añadir el texto del botón.
slideup Los mensajes dentro de la aplicación se llaman así porque “se deslizan hacia arriba” o “se deslizan hacia abajo” desde la parte superior o inferior de la pantalla. Cubren una pequeña parte de la pantalla y proporcionan una capacidad de mensajería eficaz y no intrusiva.
El objeto de mensaje dentro de la aplicación slideup extiende InAppMessageBase.
modal Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Son útiles para una mensajería más crítica y pueden equiparse con dos botones de acción de clic y habilitación de análisis.
Este tipo de mensaje es una subclase de InAppMessageImmersiveBase, una clase abstracta que implementa IInAppMessageImmersive, lo que te ofrece la opción de añadir funcionalidades personalizadas a tus mensajes generados localmente dentro de la aplicación.
full Los mensajes dentro de la aplicación son útiles para maximizar el contenido y el impacto de tu comunicación con el usuario. La mitad superior de un mensaje dentro de la aplicación full contiene una imagen, y la mitad inferior muestra texto y hasta dos botones de acción de clic y habilitación de análisis.
Este tipo de mensaje amplía InAppMessageImmersiveBase, ofreciéndote la opción de añadir funcionalidades personalizadas a tus mensajes generados localmente dentro de la aplicación.
HTML Los mensajes dentro de la aplicación son útiles para crear contenido de usuario totalmente personalizado. El contenido HTML de los mensajes dentro de la aplicación, definido por el usuario, se muestra en WebView y puede contener opcionalmente otros contenidos enriquecidos, como imágenes y fuentes, lo que permite un control total sobre el aspecto y la funcionalidad de los mensajes.
Este tipo de mensaje implementa IInAppMessageHtml, que es una subclase de IInAppMessage.
En Android, los enlaces configurados contarget="_blank" en mensajes HTML personalizados dentro de la aplicación se abren en el navegador web predeterminado del dispositivo.
Los mensajes dentro de la aplicación Android admiten una interfaz brazeBridgeJavaScript para llamar a métodos en el SDK de Braze para Android desde tu HTML. Consulta nuestra página sobre el puente JavaScript para obtener más detalles.
Actualmente no admitimos la visualización de mensajes HTML personalizados dentro de la aplicación en un iFrame en las plataformas iOS y Android.
También puedes definir vistas de mensajes personalizados dentro de la aplicación para tu aplicación. Para obtener una guía completa, consulta Configuración de fábricas personalizadas.
Cada tipo de mensaje dentro de la aplicación es altamente personalizable en cuanto a contenido, imágenes, iconos, acciones de clic, análisis, visualización y entrega. Son tipos enumerados de Braze.InAppMessage, que define el comportamiento y los rasgos básicos de todos los mensajes dentro de la aplicación. Para ver la lista completa de propiedades y usos de los mensajes dentro de la aplicación, consulta la claseInAppMessage .
Estos son los tipos de mensajes dentro de la aplicación disponibles en Braze y cómo serán para los usuarios finales.
Slideup Los mensajes dentro de la aplicación reciben este nombre porque se “deslizan hacia arriba” o “hacia abajo” desde la parte superior o inferior de la pantalla. Cubren una pequeña parte de la pantalla y proporcionan una capacidad de mensajería eficaz y no intrusiva.
Modal Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Útiles para una mensajería más crítica, pueden equiparse con hasta dos botones habilitados para análisis.
Modal Image Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Estos mensajes son similares a los del tipo Modal, excepto que no tienen cabecera ni texto de mensaje. Útiles para una mensajería más crítica, pueden equiparse con hasta dos botones habilitados para análisis.
Full Los mensajes dentro de la aplicación son útiles para maximizar el contenido y el impacto de tu comunicación con el usuario. La mitad superior de un mensaje dentro de la aplicación Full contiene una imagen, y la mitad inferior muestra texto y hasta dos botones habilitados para el análisis.
Full Image Los mensajes dentro de la aplicación son similares a los mensajes dentro de la aplicación Full, excepto que no tienen cabecera ni texto de mensaje. Este tipo de mensaje es útil para maximizar el contenido y el impacto de tu comunicación con el usuario. Un mensaje dentro de la aplicación Full Image contiene una imagen que abarca toda la pantalla, con la opción de mostrar hasta dos botones habilitados para el análisis.
HTML Los mensajes dentro de la aplicación son útiles para crear contenido de usuario totalmente personalizado. El contenido HTML completo de los mensajes dentro de la aplicación, definido por el usuario, se muestra en WKWebViewy puede contener opcionalmente otros contenidos enriquecidos, como imágenes y fuentes, lo que permite un control total sobre el aspecto y la funcionalidad de los mensajes.
Los mensajes dentro de la aplicación de iOS admiten una interfaz JavaScript brazeBridge para llamar a métodos del SDK de la Web de Braze desde dentro de tu HTML, consulta nuestras mejores prácticas para obtener más detalles.
El siguiente ejemplo muestra un mensaje HTML completo paginado dentro de la aplicación:
Ten en cuenta que actualmente no admitimos la visualización de mensajes HTML personalizados dentro de la aplicación en un iFrame en las plataformas iOS y Android.
Control Los mensajes dentro de la aplicación no contienen un componente de interfaz de usuario y se utilizan principalmente con fines de análisis. Este tipo se utiliza para verificar la recepción de un mensaje dentro de la aplicación enviado a un grupo de control.
Para más detalles sobre Intelligent Selection y los grupos de control, consulta Intelligent Selection.
Habilitación de mensajes dentro de la aplicación
Paso 1: Añade un observador
Para procesar mensajes dentro de la aplicación, puedes añadir un observador en BrazeTask.BrazeInAppMessage:
1
m.BrazeTask.observeField("BrazeInAppMessage", "onInAppMessageReceived")
Paso 2: Acceder a mensajes desencadenados
Después, dentro de tu controlador, tendrás acceso al mensaje dentro de la aplicación más alto que hayan desencadenado tus campañas:
1
2
3
4
sub onInAppMessageReceived()
in_app_message = m.BrazeTask.BrazeInAppMessage
...
end sub
Campos de mensajería
Manejo de
A continuación se enumeran los campos que necesitarás para gestionar tus mensajes dentro de la aplicación:
| Campos | Descripción |
|---|---|
buttons |
Lista de botones (puede ser una lista vacía). |
click_action |
"URI" o "NONE". Utiliza este campo para indicar si el mensaje dentro de la aplicación debe abrirse a un enlace URI o cerrar el mensaje al hacer clic. Cuando no hay botones, esto debería ocurrir cuando el usuario hace clic en “Aceptar” cuando se muestra el mensaje dentro de la aplicación. |
dismiss_type |
"AUTO_DISMISS" o "SWIPE". Utiliza este campo para indicar si tu mensaje dentro de la aplicación se descartará automáticamente o si será necesario deslizar el dedo para descartarlo. |
display_delay |
Cuánto tiempo (segundos) hay que esperar hasta que aparezca el mensaje dentro de la aplicación. |
duration |
Cuánto tiempo (milisegundos) debe mostrarse el mensaje cuando dismiss_type está configurado en "AUTO_DISMISS". |
extras |
Pares clave-valor. |
header |
El texto de la cabecera. |
id |
El ID utilizado para registrar las impresiones o los clics. |
image_url |
URL de la imagen del mensaje dentro de la aplicación. |
message |
Texto del cuerpo del mensaje. |
uri |
Se enviará a los usuarios de tu URI en función de tu click_action. Este campo debe incluirse cuando click_action es "URI". |
Para los mensajes dentro de la aplicación que contengan botones, el mensaje click_action también se incluirá en la carga útil final si la acción de clic se añade antes de añadir el texto del botón.
Estilismo
También hay varios campos de estilo que puedes utilizar desde el panel:
| Campos | Descripción |
|---|---|
bg_color |
Color de fondo. |
close_button_color |
Color del botón de cierre. |
frame_color |
El color de la superposición de la pantalla de fondo. |
header_text_color |
Color del texto de la cabecera. |
message_text_color |
Color del texto del mensaje. |
text_align |
“INICIO”, “CENTRO” o “FIN”. Tu alineación de texto seleccionada. |
Alternativamente, podrías implementar el mensaje dentro de la aplicación y darle estilo dentro de tu aplicación Roku utilizando una paleta estándar:
Botones de acción
| Campos | Descripción |
|---|---|
click_action |
"URI" o "NONE". Utiliza este campo para indicar si el mensaje dentro de la aplicación debe abrirse a un enlace URI o cerrar el mensaje al hacer clic. |
id |
El valor ID del propio botón. |
text |
El texto que se mostrará en el botón. |
uri |
Se enviará a los usuarios de tu URI en función de tu click_action. Este campo debe incluirse cuando click_action es "URI". |
Ten en cuenta que tendrás que implementar tu propia interfaz de usuario personalizada, ya que la mensajería dentro de la aplicación se admite a través de la interfaz de usuario sin cabeza mediante el SDK de Swift, que no incluye ninguna interfaz de usuario ni vistas predeterminadas para tvOS.
Requisitos previos
Antes de poder utilizar esta característica, tendrás que integrar el SDK de Swift Braze.
Habilitación de mensajes dentro de la aplicación
Paso 1: Crear una nueva aplicación iOS
En Braze, selecciona Configuración > Configuración de la aplicación y, a continuación, Añadir aplicación. Introduce un nombre para tu aplicación de tvOS, selecciona iOS (no_tvOS) y_luego selecciona Añadir aplicación.
Si seleccionas la casilla tvOS, no podrás personalizar los mensajes dentro de la aplicación para tvOS.
Paso 2: Obtén la clave de API de tu aplicación
En la configuración de tu aplicación, selecciona tu nueva aplicación para tvOS y toma nota de la clave de API de tu aplicación. Utilizarás esta clave para configurar tu aplicación en Xcode.
Paso 3: Integrar BrazeKit
Utiliza la clave de API de tu aplicación para integrar el SDK de Braze Swift en tu proyecto de tvOS en Xcode. Solo tienes que integrar BrazeKit desde el SDK Swift de Braze.
Paso 4: Crea tu interfaz de usuario personalizada
Como Braze no proporciona una interfaz predeterminada para los mensajes dentro de la aplicación en tvOS, tendrás que personalizarla tú mismo. Para un recorrido completo, consulta nuestro tutorial paso a paso: Personaliza los mensajes dentro de la aplicación para tvOS. Para ver un proyecto de ejemplo, consulta los ejemplos del SDK Swift de Braze.
Requisitos previos
Antes de poder utilizar esta característica, tendrás que integrar el SDK Braze de Unity.
Tipos de mensajes
Braze ofrece varios tipos de mensajes predeterminados dentro de la aplicación, cada uno de los cuales se puede personalizar con mensajes, imágenes, iconos Font Awesome, acciones al hacer clic, análisis, combinaciones de colores y mucho más.
Tu comportamiento y características básicas se definen mediante laIInAppMessageinterfaz, en una subclase denominada InAppMessageBase.IInAppMessageTambién incluye una subinterfaz, IInAppMessageImmersive, que permite añadir botones de cierre, de clic y de análisis a la aplicación.
Ten en cuenta que los mensajes dentro de la aplicación que contengan botones incluirán elclickActionmensaje en la carga útil final si la acción de clic se añade antes de añadir el texto del botón.
slideup Los mensajes dentro de la aplicación se llaman así porque “se deslizan hacia arriba” o “se deslizan hacia abajo” desde la parte superior o inferior de la pantalla. Cubren una pequeña parte de la pantalla y proporcionan una capacidad de mensajería eficaz y no intrusiva.
El objeto de mensaje dentro de la aplicación slideup extiende InAppMessageBase.
modal Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Son útiles para una mensajería más crítica y pueden equiparse con dos botones de acción de clic y habilitación de análisis.
Este tipo de mensaje es una subclase de InAppMessageImmersiveBase, una clase abstracta que implementa IInAppMessageImmersive, lo que te ofrece la opción de añadir funcionalidades personalizadas a tus mensajes generados localmente dentro de la aplicación.
full Los mensajes dentro de la aplicación son útiles para maximizar el contenido y el impacto de tu comunicación con el usuario. La mitad superior de un mensaje dentro de la aplicación full contiene una imagen, y la mitad inferior muestra texto y hasta dos botones de acción de clic y habilitación de análisis.
Este tipo de mensaje amplía InAppMessageImmersiveBase, ofreciéndote la opción de añadir funcionalidades personalizadas a tus mensajes generados localmente dentro de la aplicación.
HTML Los mensajes dentro de la aplicación son útiles para crear contenido de usuario totalmente personalizado. El contenido HTML de los mensajes dentro de la aplicación, definido por el usuario, se muestra en WebView y puede contener opcionalmente otros contenidos enriquecidos, como imágenes y fuentes, lo que permite un control total sobre el aspecto y la funcionalidad de los mensajes.
Este tipo de mensaje implementa IInAppMessageHtml, que es una subclase de IInAppMessage.
En Android, los enlaces configurados contarget="_blank" en mensajes HTML personalizados dentro de la aplicación se abren en el navegador web predeterminado del dispositivo.
Los mensajes dentro de la aplicación Android admiten una interfaz brazeBridgeJavaScript para llamar a métodos en el SDK de Braze para Android desde tu HTML. Consulta nuestra página sobre el puente JavaScript para obtener más detalles.
Actualmente no admitimos la visualización de mensajes HTML personalizados dentro de la aplicación en un iFrame en las plataformas iOS y Android.
También puedes definir vistas de mensajes personalizados dentro de la aplicación para tu aplicación. Para obtener una guía completa, consulta Configuración de fábricas personalizadas.
Cada tipo de mensaje dentro de la aplicación es altamente personalizable en cuanto a contenido, imágenes, iconos, acciones de clic, análisis, visualización y entrega. Son tipos enumerados de Braze.InAppMessage, que define el comportamiento y los rasgos básicos de todos los mensajes dentro de la aplicación. Para ver la lista completa de propiedades y usos de los mensajes dentro de la aplicación, consulta la claseInAppMessage .
Estos son los tipos de mensajes dentro de la aplicación disponibles en Braze y cómo serán para los usuarios finales.
Slideup Los mensajes dentro de la aplicación reciben este nombre porque se “deslizan hacia arriba” o “hacia abajo” desde la parte superior o inferior de la pantalla. Cubren una pequeña parte de la pantalla y proporcionan una capacidad de mensajería eficaz y no intrusiva.
Modal Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Útiles para una mensajería más crítica, pueden equiparse con hasta dos botones habilitados para análisis.
Modal Image Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Estos mensajes son similares a los del tipo Modal, excepto que no tienen cabecera ni texto de mensaje. Útiles para una mensajería más crítica, pueden equiparse con hasta dos botones habilitados para análisis.
Full Los mensajes dentro de la aplicación son útiles para maximizar el contenido y el impacto de tu comunicación con el usuario. La mitad superior de un mensaje dentro de la aplicación Full contiene una imagen, y la mitad inferior muestra texto y hasta dos botones habilitados para el análisis.
Full Image Los mensajes dentro de la aplicación son similares a los mensajes dentro de la aplicación Full, excepto que no tienen cabecera ni texto de mensaje. Este tipo de mensaje es útil para maximizar el contenido y el impacto de tu comunicación con el usuario. Un mensaje dentro de la aplicación Full Image contiene una imagen que abarca toda la pantalla, con la opción de mostrar hasta dos botones habilitados para el análisis.
HTML Los mensajes dentro de la aplicación son útiles para crear contenido de usuario totalmente personalizado. El contenido HTML completo de los mensajes dentro de la aplicación, definido por el usuario, se muestra en WKWebViewy puede contener opcionalmente otros contenidos enriquecidos, como imágenes y fuentes, lo que permite un control total sobre el aspecto y la funcionalidad de los mensajes.
Los mensajes dentro de la aplicación de iOS admiten una interfaz JavaScript brazeBridge para llamar a métodos del SDK de la Web de Braze desde dentro de tu HTML, consulta nuestras mejores prácticas para obtener más detalles.
El siguiente ejemplo muestra un mensaje HTML completo paginado dentro de la aplicación:
Ten en cuenta que actualmente no admitimos la visualización de mensajes HTML personalizados dentro de la aplicación en un iFrame en las plataformas iOS y Android.
Control Los mensajes dentro de la aplicación no contienen un componente de interfaz de usuario y se utilizan principalmente con fines de análisis. Este tipo se utiliza para verificar la recepción de un mensaje dentro de la aplicación enviado a un grupo de control.
Para más detalles sobre Intelligent Selection y los grupos de control, consulta Intelligent Selection.
Requisitos previos
Antes de poder utilizar esta característica, deberás realizar la integración del SDK .NET MAUI Braze.
Tipos de mensajes
Braze ofrece varios tipos de mensajes predeterminados dentro de la aplicación, cada uno de los cuales se puede personalizar con mensajes, imágenes, iconos Font Awesome, acciones al hacer clic, análisis, combinaciones de colores y mucho más.
Tu comportamiento y características básicas se definen mediante laIInAppMessageinterfaz, en una subclase denominada InAppMessageBase.IInAppMessageTambién incluye una subinterfaz, IInAppMessageImmersive, que permite añadir botones de cierre, de clic y de análisis a la aplicación.
Ten en cuenta que los mensajes dentro de la aplicación que contengan botones incluirán elclickActionmensaje en la carga útil final si la acción de clic se añade antes de añadir el texto del botón.
slideup Los mensajes dentro de la aplicación se llaman así porque “se deslizan hacia arriba” o “se deslizan hacia abajo” desde la parte superior o inferior de la pantalla. Cubren una pequeña parte de la pantalla y proporcionan una capacidad de mensajería eficaz y no intrusiva.
El objeto de mensaje dentro de la aplicación slideup extiende InAppMessageBase.
modal Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Son útiles para una mensajería más crítica y pueden equiparse con dos botones de acción de clic y habilitación de análisis.
Este tipo de mensaje es una subclase de InAppMessageImmersiveBase, una clase abstracta que implementa IInAppMessageImmersive, lo que te ofrece la opción de añadir funcionalidades personalizadas a tus mensajes generados localmente dentro de la aplicación.
full Los mensajes dentro de la aplicación son útiles para maximizar el contenido y el impacto de tu comunicación con el usuario. La mitad superior de un mensaje dentro de la aplicación full contiene una imagen, y la mitad inferior muestra texto y hasta dos botones de acción de clic y habilitación de análisis.
Este tipo de mensaje amplía InAppMessageImmersiveBase, ofreciéndote la opción de añadir funcionalidades personalizadas a tus mensajes generados localmente dentro de la aplicación.
HTML Los mensajes dentro de la aplicación son útiles para crear contenido de usuario totalmente personalizado. El contenido HTML de los mensajes dentro de la aplicación, definido por el usuario, se muestra en WebView y puede contener opcionalmente otros contenidos enriquecidos, como imágenes y fuentes, lo que permite un control total sobre el aspecto y la funcionalidad de los mensajes.
Este tipo de mensaje implementa IInAppMessageHtml, que es una subclase de IInAppMessage.
En Android, los enlaces configurados contarget="_blank" en mensajes HTML personalizados dentro de la aplicación se abren en el navegador web predeterminado del dispositivo.
Los mensajes dentro de la aplicación Android admiten una interfaz brazeBridgeJavaScript para llamar a métodos en el SDK de Braze para Android desde tu HTML. Consulta nuestra página sobre el puente JavaScript para obtener más detalles.
Actualmente no admitimos la visualización de mensajes HTML personalizados dentro de la aplicación en un iFrame en las plataformas iOS y Android.
También puedes definir vistas de mensajes personalizados dentro de la aplicación para tu aplicación. Para obtener una guía completa, consulta Configuración de fábricas personalizadas.
Cada tipo de mensaje dentro de la aplicación es altamente personalizable en cuanto a contenido, imágenes, iconos, acciones de clic, análisis, visualización y entrega. Son tipos enumerados de Braze.InAppMessage, que define el comportamiento y los rasgos básicos de todos los mensajes dentro de la aplicación. Para ver la lista completa de propiedades y usos de los mensajes dentro de la aplicación, consulta la claseInAppMessage .
Estos son los tipos de mensajes dentro de la aplicación disponibles en Braze y cómo serán para los usuarios finales.
Slideup Los mensajes dentro de la aplicación reciben este nombre porque se “deslizan hacia arriba” o “hacia abajo” desde la parte superior o inferior de la pantalla. Cubren una pequeña parte de la pantalla y proporcionan una capacidad de mensajería eficaz y no intrusiva.
Modal Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Útiles para una mensajería más crítica, pueden equiparse con hasta dos botones habilitados para análisis.
Modal Image Los mensajes dentro de la aplicación aparecen en el centro de la pantalla y están enmarcados por un panel translúcido. Estos mensajes son similares a los del tipo Modal, excepto que no tienen cabecera ni texto de mensaje. Útiles para una mensajería más crítica, pueden equiparse con hasta dos botones habilitados para análisis.
Full Los mensajes dentro de la aplicación son útiles para maximizar el contenido y el impacto de tu comunicación con el usuario. La mitad superior de un mensaje dentro de la aplicación Full contiene una imagen, y la mitad inferior muestra texto y hasta dos botones habilitados para el análisis.
Full Image Los mensajes dentro de la aplicación son similares a los mensajes dentro de la aplicación Full, excepto que no tienen cabecera ni texto de mensaje. Este tipo de mensaje es útil para maximizar el contenido y el impacto de tu comunicación con el usuario. Un mensaje dentro de la aplicación Full Image contiene una imagen que abarca toda la pantalla, con la opción de mostrar hasta dos botones habilitados para el análisis.
HTML Los mensajes dentro de la aplicación son útiles para crear contenido de usuario totalmente personalizado. El contenido HTML completo de los mensajes dentro de la aplicación, definido por el usuario, se muestra en WKWebViewy puede contener opcionalmente otros contenidos enriquecidos, como imágenes y fuentes, lo que permite un control total sobre el aspecto y la funcionalidad de los mensajes.
Los mensajes dentro de la aplicación de iOS admiten una interfaz JavaScript brazeBridge para llamar a métodos del SDK de la Web de Braze desde dentro de tu HTML, consulta nuestras mejores prácticas para obtener más detalles.
El siguiente ejemplo muestra un mensaje HTML completo paginado dentro de la aplicación:
Ten en cuenta que actualmente no admitimos la visualización de mensajes HTML personalizados dentro de la aplicación en un iFrame en las plataformas iOS y Android.
Control Los mensajes dentro de la aplicación no contienen un componente de interfaz de usuario y se utilizan principalmente con fines de análisis. Este tipo se utiliza para verificar la recepción de un mensaje dentro de la aplicación enviado a un grupo de control.
Para más detalles sobre Intelligent Selection y los grupos de control, consulta Intelligent Selection.
Próximos pasos
¿Listo para profundizar más? Echa un vistazo a estos tutoriales paso a paso:
- Ajusta el momento de entrega de los mensajes aplazando y restaurando los mensajes desencadenados.
- Refina la orientación de los mensajes estableciendo reglas de visualización condicionales.
- Adapta el aspecto de tu marca personalizando el estilo de los mensajes con pares clave-valor.
Editar esta página en GitHub