Mensajes dentro de la aplicación
Más 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 Android Braze. You’ll also need to enable in-app messages.
Message types
Braze offers several default in-app message types, each customizable with messages, images, Font Awesome icons, click actions, analytics, color schemes, and more.
Their basic behavior and traits are defined by the IInAppMessage
interface, in a subclass called InAppMessageBase
. IInAppMessage
also includes a subinterface, IInAppMessageImmersive
, which lets you add close, click-action, and analytics buttons to your app.
Keep in mind, in-app messages containing buttons will include the clickAction
message in the final payload if the click action is added prior to adding the button text.
modal
in-app messages appear in the center of the screen and are framed by a translucent panel. Useful for more critical messaging, they can be equipped with two click-action and analytics-enabled buttons.
This message type is a subclass of InAppMessageImmersiveBase
, an abstract class that implements IInAppMessageImmersive
, giving you the option to add custom functionality to your locally generated in-app messages.
full
in-app messages are useful for maximizing the content and impact of your user communication. The upper half of a full
in-app message contains an image, and the lower half displays text and up to two click action and analytics-enabled buttons.
This message type extends InAppMessageImmersiveBase
, giving you the option to add custom functionality to your locally generated in-app messages.
HTML
in-app messages are useful for creating fully customized user content. User-defined HTML in-app message content is displayed in a WebView
and may optionally contain other rich content, such as images and fonts, allowing for full control over message appearance and functionality.
This message type implements IInAppMessageHtml
, which is a subclass of IInAppMessage
.
Android in-app messages support a JavaScript brazeBridge
interface to call methods on the Braze Android SDK from within your HTML, see our JavaScript bridge page for more details.
We currently do not support the display of custom HTML in-app messages in an iFrame on the iOS and Android platforms.
You can also define custom in-app message views for your app. For a full walkthrough, see Setting custom factories.
Enabling in-app messages
Step 1: Register BrazeInAppMessageManager
In-app message display is managed by the BrazeInAppMessageManager
class. Every activity in your app must be registered with the BrazeInAppMessageManager
to allow it to add in-app message views to the view hierarchy. There are two ways to accomplish this:
The activity lifecycle callback integration handles in-app message registration automatically; no extra integration is required. This is the recommended method for handling in-app message registration.
If you’re using activity lifecycle callback for automatic registration, do not complete this step.
In your Application.onCreate()
, call ensureSubscribedToInAppMessageEvents()
:
1
BrazeInAppMessageManager.getInstance().ensureSubscribedToInAppMessageEvents(context);
1
BrazeInAppMessageManager.getInstance().ensureSubscribedToInAppMessageEvents(context)
In every activity where in-app messages can be shown, call registerInAppMessageManager()
in that activity’s onResume()
:
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)
}
In every activity where registerInAppMessageManager()
was called, call unregisterInAppMessageManager()
in that activity’s 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)
}
Step 2: Update the manager’s blocklist (optional)
In your integration, you may require that certain activities in your app should not show in-app messages. The activity lifecycle callback integration provides an easy way to accomplish this.
The following sample code adds two activities to the in-app message registration blocklist, SplashActivity
and 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.
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 WKWebView
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.
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 coincidente para un evento concreto, llamará a este método automáticamente.
Prerequisites
Before you can use this feature, you’ll need to integrate the Web Braze SDK. Sin embargo, no es necesaria ninguna configuración adicional.
Tipos de mensajes
Todos los mensajes dentro de la aplicación heredan su prototipo de InAppMessage
que 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
, FullScreenMessage
y 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.
About TV and OTT support
The Android Braze SDK natively supports displaying in-app messages on OTT devices like Android TV or Fire Stick. However, there’s some key differences between native Android and OTT in-app messages. For OTT devices:
- In-app messages that require touch mode, such as slideup, are disabled on OTT.
- The currently selected or focused item, such as a button or close button, will be highlighted.
- Body clicks on the in-app message itself, such as not on a button, are not supported.
Prerequisites
Before you can use this feature, you’ll need to integrate the Cordova Braze SDK.
Message types
Braze offers several default in-app message types, each customizable with messages, images, Font Awesome icons, click actions, analytics, color schemes, and more.
Their basic behavior and traits are defined by the IInAppMessage
interface, in a subclass called InAppMessageBase
. IInAppMessage
also includes a subinterface, IInAppMessageImmersive
, which lets you add close, click-action, and analytics buttons to your app.
Keep in mind, in-app messages containing buttons will include the clickAction
message in the final payload if the click action is added prior to adding the button text.
modal
in-app messages appear in the center of the screen and are framed by a translucent panel. Useful for more critical messaging, they can be equipped with two click-action and analytics-enabled buttons.
This message type is a subclass of InAppMessageImmersiveBase
, an abstract class that implements IInAppMessageImmersive
, giving you the option to add custom functionality to your locally generated in-app messages.
full
in-app messages are useful for maximizing the content and impact of your user communication. The upper half of a full
in-app message contains an image, and the lower half displays text and up to two click action and analytics-enabled buttons.
This message type extends InAppMessageImmersiveBase
, giving you the option to add custom functionality to your locally generated in-app messages.
HTML
in-app messages are useful for creating fully customized user content. User-defined HTML in-app message content is displayed in a WebView
and may optionally contain other rich content, such as images and fonts, allowing for full control over message appearance and functionality.
This message type implements IInAppMessageHtml
, which is a subclass of IInAppMessage
.
Android in-app messages support a JavaScript brazeBridge
interface to call methods on the Braze Android SDK from within your HTML, see our JavaScript bridge page for more details.
We currently do not support the display of custom HTML in-app messages in an iFrame on the iOS and Android platforms.
You can also define custom in-app message views for your app. For a full walkthrough, see Setting custom factories.
Each in-app message type is highly customizable across content, images, icons, click actions, analytics, display, and delivery. They are enumerated types of Braze.InAppMessage
, which defines basic behavior and traits for all in-app messages. For the full list of in-app message properties and usage, see the InAppMessage
class.
These are the available in-app message types in Braze and how they will look like for end-users.
Modal
in-app messages appear in the center of the screen and are framed by a translucent panel. Useful for more critical messaging, they can be equipped with up to two analytics-enabled buttons.
Modal Image
in-app messages appear in the center of the screen and are framed by a translucent panel. These messages are similar to the Modal
type except without header or message text. Useful for more critical messaging, they can be equipped with up to two analytics-enabled buttons.
Full
in-app messages are useful for maximizing the content and impact of your user communication. The upper half of a Full
in-app message contains an image, and the lower half displays text and up to two analytics-enabled buttons.
Full Image
in-app messages are similar to Full
in-app messages except without header or message text. This message type is useful for maximizing the content and impact of your user communication. A Full Image
in-app message contains an image spanning the entire screen, with the option to display up to two analytics-enabled buttons.
HTML
in-app messages are useful for creating fully customized user content. User-defined HTML Full in-app message content is displayed in a WKWebView
and may optionally contain other rich content, such as images and fonts, allowing for full control over message appearance and functionality.
iOS in-app messages support a JavaScript brazeBridge
interface to call methods on the Braze Web SDK from within your HTML, see our best practices for more details.
The following example shows a paginated HTML Full in-app message:
Note that we currently do not support the display of custom HTML in-app messages in an iFrame on the iOS and Android platforms.
Control
in-app messages do not contain a UI component and are used primarily for analytics purposes. This type is used to verify receipt of an in-app message sent to a control group.
For further details about Intelligent Selection and control groups, refer to 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 predeterminados de mensajes dentro de la aplicación, cada uno personalizable con mensajes, imágenes, iconos Font Awesome, acciones de clic, análisis, esquemas de color y mucho más.
Su comportamiento y rasgos básicos están definidos por la interfaz IInAppMessage
en una subclase llamada InAppMessageBase
. IInAppMessage
también incluye una subinterfaz, IInAppMessageImmersive
que te permite añadir a tu aplicación botones de cierre, clic-acción y análisis.
Ten en cuenta que los mensajes dentro de la aplicación que contengan botones incluirán el mensaje clickAction
en la carga útil final si la acción de clic se añade antes de añadir el texto del botón.
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
, dándote la opción de añadir funcionalidad personalizada a tus mensajes dentro de la aplicación generados localmente.
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 posibilidad de añadir funciones personalizadas a tus mensajes dentro de la aplicación generados localmente.
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.
Estos mensajes son instancias de InAppMessageHtml
que implementan la subclase IInAppMessage
: IInAppMessageHtml
.
Los mensajes dentro de la aplicación Android admiten una interfaz JavaScript brazeBridge
para llamar a métodos del SDK Braze Web desde dentro de tu HTML, consulta nuestras mejores prácticas para 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 dentro de la aplicación personalizadas para tu aplicación. Para un recorrido completo, consulta Configurar 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.
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 WKWebView
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.
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.
Prerequisites
Before you can use this feature, you’ll need to integrate the React Native Braze SDK.
Tipos de mensajes
Braze ofrece varios tipos predeterminados de mensajes dentro de la aplicación, cada uno personalizable con mensajes, imágenes, iconos Font Awesome, acciones de clic, análisis, esquemas de color y mucho más.
Su comportamiento y rasgos básicos están definidos por la interfaz IInAppMessage
en una subclase llamada InAppMessageBase
. IInAppMessage
también incluye una subinterfaz, IInAppMessageImmersive
que te permite añadir a tu aplicación botones de cierre, clic-acción y análisis.
Ten en cuenta que los mensajes dentro de la aplicación que contengan botones incluirán el mensaje clickAction
en la carga útil final si la acción de clic se añade antes de añadir el texto del botón.
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
, dándote la opción de añadir funcionalidad personalizada a tus mensajes dentro de la aplicación generados localmente.
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 posibilidad de añadir funciones personalizadas a tus mensajes dentro de la aplicación generados localmente.
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.
Estos mensajes son instancias de InAppMessageHtml
que implementan la subclase IInAppMessage
: IInAppMessageHtml
.
Los mensajes dentro de la aplicación Android admiten una interfaz JavaScript brazeBridge
para llamar a métodos del SDK Braze Web desde dentro de tu HTML, consulta nuestras mejores prácticas para 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 dentro de la aplicación personalizadas para tu aplicación. Para un recorrido completo, consulta Configurar 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.
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 WKWebView
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.
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 tres tipos son: NEWS_FEED , 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 tres tipos son: NEWS_FEED , 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.
Prerequisites
Before you can use this feature, you’ll need to integrate the Roku Braze SDK. Además, los mensajes dentro de la aplicación sólo se enviarán a dispositivos Roku que ejecuten la versión mínima del SDK admitida:
Tipos de mensajes
Braze ofrece varios tipos predeterminados de mensajes dentro de la aplicación, cada uno personalizable con mensajes, imágenes, iconos Font Awesome, acciones de clic, análisis, esquemas de color y mucho más.
Su comportamiento y rasgos básicos están definidos por la interfaz IInAppMessage
en una subclase llamada InAppMessageBase
. IInAppMessage
también incluye una subinterfaz, IInAppMessageImmersive
que te permite añadir a tu aplicación botones de cierre, clic-acción y análisis.
Ten en cuenta que los mensajes dentro de la aplicación que contengan botones incluirán el mensaje clickAction
en la carga útil final si la acción de clic se añade antes de añadir el texto del botón.
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
, dándote la opción de añadir funcionalidad personalizada a tus mensajes dentro de la aplicación generados localmente.
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 posibilidad de añadir funciones personalizadas a tus mensajes dentro de la aplicación generados localmente.
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.
Estos mensajes son instancias de InAppMessageHtml
que implementan la subclase IInAppMessage
: IInAppMessageHtml
.
Los mensajes dentro de la aplicación Android admiten una interfaz JavaScript brazeBridge
para llamar a métodos del SDK Braze Web desde dentro de tu HTML, consulta nuestras mejores prácticas para 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 dentro de la aplicación personalizadas para tu aplicación. Para un recorrido completo, consulta Configurar 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.
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 WKWebView
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.
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" . |
Keep in mind, you’ll need to implement your own custom UI since in-app messaging is supported via headless UI using the Swift SDK—which does not include any default UI or views for tvOS.
Requisitos previos
Antes de poder utilizar esta característica, tendrás que integrar el SDK de Swift Braze.
Enabling in-app messages
Step 1: Create a new iOS app
In Braze, select Settings > App Settings, then select Add App. Enter a name for your tvOS app, select iOS—not tvOS—then select Add App.
If you select the tvOS checkbox, you will not be able to customize in-app messages for tvOS.
Step 2: Get your app’s API key
In your app settings, select your new tvOS app then take note of your app’s API key. You’ll use this key to configure your app in Xcode.
Step 3: Integrate BrazeKit
Use your app’s API key to integrate the Braze Swift SDK into your tvOS project in Xcode. You only need to integrate BrazeKit from the Braze Swift SDK.
Step 4: Create your custom UI
Because Braze doesn’t provide a default UI for in-app messages on tvOS, you’ll need to customize it yourself. For a full walkthrough, see our step-by-step tutorial: Customizing in-app messages for tvOS. For a sample project, see Braze Swift SDK samples.
Requisitos previos
Antes de poder utilizar esta característica, tendrás que integrar el SDK Braze de Unity.
Message types
Braze offers several default in-app message types, each customizable with messages, images, Font Awesome icons, click actions, analytics, color schemes, and more.
Their basic behavior and traits are defined by the IInAppMessage
interface, in a subclass called InAppMessageBase
. IInAppMessage
also includes a subinterface, IInAppMessageImmersive
, which lets you add close, click-action, and analytics buttons to your app.
Keep in mind, in-app messages containing buttons will include the clickAction
message in the final payload if the click action is added prior to adding the button text.
modal
in-app messages appear in the center of the screen and are framed by a translucent panel. Useful for more critical messaging, they can be equipped with two click-action and analytics-enabled buttons.
This message type is a subclass of InAppMessageImmersiveBase
, an abstract class that implements IInAppMessageImmersive
, giving you the option to add custom functionality to your locally generated in-app messages.
full
in-app messages are useful for maximizing the content and impact of your user communication. The upper half of a full
in-app message contains an image, and the lower half displays text and up to two click action and analytics-enabled buttons.
This message type extends InAppMessageImmersiveBase
, giving you the option to add custom functionality to your locally generated in-app messages.
HTML
in-app messages are useful for creating fully customized user content. User-defined HTML in-app message content is displayed in a WebView
and may optionally contain other rich content, such as images and fonts, allowing for full control over message appearance and functionality.
This message type implements IInAppMessageHtml
, which is a subclass of IInAppMessage
.
Android in-app messages support a JavaScript brazeBridge
interface to call methods on the Braze Android SDK from within your HTML, see our JavaScript bridge page for more details.
We currently do not support the display of custom HTML in-app messages in an iFrame on the iOS and Android platforms.
You can also define custom in-app message views for your app. For a full walkthrough, see Setting custom factories.
Each in-app message type is highly customizable across content, images, icons, click actions, analytics, display, and delivery. They are enumerated types of Braze.InAppMessage
, which defines basic behavior and traits for all in-app messages. For the full list of in-app message properties and usage, see the InAppMessage
class.
These are the available in-app message types in Braze and how they will look like for end-users.
Modal
in-app messages appear in the center of the screen and are framed by a translucent panel. Useful for more critical messaging, they can be equipped with up to two analytics-enabled buttons.
Modal Image
in-app messages appear in the center of the screen and are framed by a translucent panel. These messages are similar to the Modal
type except without header or message text. Useful for more critical messaging, they can be equipped with up to two analytics-enabled buttons.
Full
in-app messages are useful for maximizing the content and impact of your user communication. The upper half of a Full
in-app message contains an image, and the lower half displays text and up to two analytics-enabled buttons.
Full Image
in-app messages are similar to Full
in-app messages except without header or message text. This message type is useful for maximizing the content and impact of your user communication. A Full Image
in-app message contains an image spanning the entire screen, with the option to display up to two analytics-enabled buttons.
HTML
in-app messages are useful for creating fully customized user content. User-defined HTML Full in-app message content is displayed in a WKWebView
and may optionally contain other rich content, such as images and fonts, allowing for full control over message appearance and functionality.
iOS in-app messages support a JavaScript brazeBridge
interface to call methods on the Braze Web SDK from within your HTML, see our best practices for more details.
The following example shows a paginated HTML Full in-app message:
Note that we currently do not support the display of custom HTML in-app messages in an iFrame on the iOS and Android platforms.
Control
in-app messages do not contain a UI component and are used primarily for analytics purposes. This type is used to verify receipt of an in-app message sent to a control group.
For further details about Intelligent Selection and control groups, refer to Intelligent Selection.
Requisitos previos
Antes de poder utilizar esta característica, tendrás que integrar el SDK de Xamarin Braze.
Tipos de mensajes
Braze ofrece varios tipos predeterminados de mensajes dentro de la aplicación, cada uno personalizable con mensajes, imágenes, iconos Font Awesome, acciones de clic, análisis, esquemas de color y mucho más.
Su comportamiento y rasgos básicos están definidos por la interfaz IInAppMessage
en una subclase llamada InAppMessageBase
. IInAppMessage
también incluye una subinterfaz, IInAppMessageImmersive
que te permite añadir a tu aplicación botones de cierre, clic-acción y análisis.
Ten en cuenta que los mensajes dentro de la aplicación que contengan botones incluirán el mensaje clickAction
en la carga útil final si la acción de clic se añade antes de añadir el texto del botón.
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
, dándote la opción de añadir funcionalidad personalizada a tus mensajes dentro de la aplicación generados localmente.
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 posibilidad de añadir funciones personalizadas a tus mensajes dentro de la aplicación generados localmente.
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.
Estos mensajes son instancias de InAppMessageHtml
que implementan la subclase IInAppMessage
: IInAppMessageHtml
.
Los mensajes dentro de la aplicación Android admiten una interfaz JavaScript brazeBridge
para llamar a métodos del SDK Braze Web desde dentro de tu HTML, consulta nuestras mejores prácticas para 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 dentro de la aplicación personalizadas para tu aplicación. Para un recorrido completo, consulta Configurar 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.
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 WKWebView
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.
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.