in-app Messages
Découvrez les messages in-app et comment les configurer pour le SDK de Braze.
Conditions préalables
Avant de pouvoir utiliser cette fonctionnalité, vous devez intégrer le SDK de Braze. Cependant, aucune configuration supplémentaire n’est nécessaire.
Types de messages
Tous les messages in-app héritent de leur prototype de InAppMessagequi définit le comportement de base et les caractéristiques de tous les messages in-app. Les sous-classes prototypiques sont SlideUpMessage, ModalMessage, FullScreenMessage, et HtmlMessage.
Chaque type de message in-app est personnalisable sur le contenu, les images, les icônes, les boutons d’action, l’analyse, l’affichage et la livraison.
SlideUp Les messages in-app sont ainsi nommés parce que traditionnellement, sur les plateformes mobiles, ils “glissent vers le haut” ou “glissent vers le bas” depuis le haut ou le bas de l’écran. Dans le SDK Braze de Web, ces messages sont affichés comme une notification de style Growl ou Toast pour s’aligner sur le paradigme dominant du Web. Ils recouvrent une petite partie de l’écran et offrent une fonctionnalité de messagerie efficace et non intrusive.
Les messages in-app de type Modal apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Utiles pour les messages plus critiques, ils peuvent être pourvus de deux actions à clic et de boutons d’analyse.
Full Les messages in-app sont utiles pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. Dans les fenêtres de navigateur étroites (par exemple, le Web mobile), les messages in-app full occupent toute la fenêtre du navigateur. Sur les fenêtres de navigateur plus grandes, les messages in-app full apparaissent de la même manière que les messages in-app modal. La moitié supérieure d’un message in-app full contient une image, et la moitié inférieure autorise jusqu’à huit lignes de texte ainsi que jusqu’à deux boutons d’action permettant l’analyse
Les messages in-app HTML sont utiles pour créer un contenu utilisateur entièrement personnalisé. Le HTML défini par l’utilisateur est affiché dans un iframe et peut contenir du contenu enrichi, comme des images, des polices, des vidéos et des éléments interactifs, permettant un contrôle total de l’apparence et de la fonctionnalité du message. Ceux-ci prennent en charge une interface JavaScript brazeBridge pour appeler des méthodes du Braze Web SDK à partir de votre HTML, voir nos meilleures pratiques pour plus de détails.
Pour activer les messages in-app HTML via le SDK Web, vous devez fournir l’option d’initialisation allowUserSuppliedJavascript à Braze, par exemple, braze.initialize('YOUR-API_KEY', {allowUserSuppliedJavascript: true}). Pour des raisons de sécurité, les messages in-app HTML peuvent en effet exécuter JavaScript, d’où le besoin d’un responsable de site pour les activer.
L’exemple suivant montre un message in-app HTML paginé :
Conditions préalables
Avant de pouvoir utiliser cette fonctionnalité, vous devrez intégrer le SDK Android Braze. Vous devrez également activer les messages in-app.
Types de messages
Braze propose plusieurs types de messages in-app par défaut, chacun personnalisable avec des messages, des images, des icônes Font Awesome, des actions de clic, des analyses, des schémas de couleurs, et plus encore.
Leur comportement de base et leurs caractéristiques sont définis par l’interface IInAppMessage dans une sous-classe appelée InAppMessageBase. IInAppMessage comprend également une sous-interface, IInAppMessageImmersivequi vous permet d’ajouter des boutons de fermeture, de clic-action et d’analyse/analytique à votre application.
Gardez à l’esprit que les messages in-app contenant des boutons incluront le message clickAction dans la charge utile finale si l’action de clic est ajoutée avant l’ajout du texte du bouton.
slideup Les messages in-app sont ainsi nommés parce qu’ils “glissent vers le haut” ou “glissent vers le bas” depuis le haut ou le bas de l’écran. Ils recouvrent une petite partie de l’écran et offrent une fonctionnalité de messagerie efficace et non intrusive.
L’objet de message in-app slideup étend InAppMessageBase.
Les messages in-app de type modal apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Ils sont utiles pour les messages plus critiques et peuvent être équipés d’un bouton d’action et d’un bouton activé par analyse.
Ce type de message est une sous-classe de InAppMessageImmersiveBaseune classe abstraite qui implémente IInAppMessageImmersive, ce qui vous permet d’ajouter des fonctionnalités personnalisées à vos messages in-app générés localement.
full Les messages in-app sont utiles pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. La moitié supérieure d’un full message in-app contient une image, et la moitié inférieure affiche le texte et deux boutons d’action permettant l’analyse.
Ce type de message s’étend à InAppMessageImmersiveBasevous permettant d’ajouter des fonctionnalités personnalisées à vos messages in-app générés localement.
Les messages in-app HTML sont utiles pour créer un contenu utilisateur entièrement personnalisé. Le contenu du message in-app en HTML défini par l’utilisateur est affiché dans un WebView et peut éventuellement contenir d’autres contenus enrichis, tels que des images et des polices, permettant un contrôle total de l’apparence et de la fonctionnalité du message.
Ce type de message met en œuvre la norme IInAppMessageHtmlqui est une sous-classe de IInAppMessage.
Sur Android, les liens configurés avec target="_blank" dans les messages in-app HTML personnalisés s’ouvrent dans le navigateur web par défaut de l’appareil.
Les messages in-app Android prennent en charge une interface JavaScript brazeBridge pour appeler des méthodes du SDK Android de Braze à partir de votre HTML, voir notre page pont JavaScript pour plus de détails.
Actuellement, nous ne prenons pas en charge l’affichage de messages in-app HTML personnalisés dans un iFrame sur les plateformes iOS et Android.
Vous pouvez également définir des envois de messages in-app personnalisés pour votre application. Pour en savoir plus, consultez la rubrique Création d’usines personnalisées.
Activation des messages in-app
Étape 1 : Registre BrazeInAppMessageManager
L’affichage des messages in-app est géré par la classe BrazeInAppMessageManager. Chaque activité de votre application doit être enregistrée avec le BrazeInAppMessageManager pour lui permettre d’ajouter des vues de messages in-app à la hiérarchie de vues. Il existe deux manières de le faire :
L’intégration du rappel du cycle de vie de l’activité gère automatiquement l’enregistrement des messages in-app ; aucune intégration supplémentaire n’est nécessaire. C’est la méthode recommandée pour l’envoi de messages in-app.
Si vous utilisez le rappel du cycle de vie de l’activité pour l’enregistrement automatique, ne terminez pas cette étape.
Dans votre Application.onCreate()appel ensureSubscribedToInAppMessageEvents():
1
BrazeInAppMessageManager.getInstance().ensureSubscribedToInAppMessageEvents(context);
1
BrazeInAppMessageManager.getInstance().ensureSubscribedToInAppMessageEvents(context)
Dans chaque activité où des messages in-app peuvent être affichés, appelez registerInAppMessageManager() dans le site onResume() de cette activité :
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)
}
Dans toutes les activités où registerInAppMessageManager() a été appelé, appelez unregisterInAppMessageManager() dans l’activité 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)
}
Étape 2 : Mettre à jour la liste de blocage du gestionnaire (facultatif)
Dans votre intégration, vous pouvez exiger que certaines activités de votre application n’affichent pas de messages in-app. L’intégration du rappel du cycle de vie de l’activité offre un moyen simple d’y parvenir.
L’exemple de code suivant ajoute deux activités à la liste de blocage de l’enregistrement des messages in-app, SplashActivity et 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))
}
}
Conditions préalables
Avant de pouvoir utiliser cette fonctionnalité, vous devrez intégrer le SDK Swift Braze. Vous devrez également activer les messages in-app.
Types de messages
Chaque type de message in-app est hautement personnalisable en termes de contenu, d’images, d’icônes, d’actions de clic, d’analyse, d’affichage et de diffusion. Il s’agit de types énumérés de Braze.InAppMessage, qui définit le comportement et les caractéristiques de base de tous les messages in-app. Pour obtenir la liste complète des propriétés et de l’utilisation des messages in-app, consultez la classeInAppMessage .
Voici les types de messages in-app disponibles dans Braze et ce à quoi ils ressembleront pour les utilisateurs finaux.
Slideup Les messages in-app portent ce nom parce qu’ils “glissent vers le haut” ou “glissent vers le bas” depuis le haut ou le bas de l’écran. Ils recouvrent une petite partie de l’écran et offrent une fonctionnalité de messagerie efficace et non intrusive.
Les messages in-app de type Modal apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Utiles pour les communications plus critiques, ils peuvent être équipés d’un maximum de deux boutons dotés d’une fonction d’analyse.
Les messages in-app de type Modal Image apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Ces messages sont similaires au type Modal, mais sans en-tête ni texte de message. Utiles pour les communications plus critiques, ils peuvent être équipés d’un maximum de deux boutons dotés d’une fonction d’analyse.
Full Les messages in-app sont utiles pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. La moitié supérieure d’un message in-app Full contient une image, et la moitié inférieure affiche du texte et jusqu’à deux boutons permettant l’analyse.
Les messages in-app Full Image sont similaires aux messages in-app Full, sauf qu’ils ne comportent pas d’en-tête ni de texte de message. Ce type de message est utile pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. Un message in-app Full Image contient une image qui s’étend sur tout l’écran, avec la possibilité d’afficher jusqu’à deux boutons compatibles avec l’analyse.
Les messages in-app HTML sont utiles pour créer un contenu utilisateur entièrement personnalisé. Le contenu des messages in-app entièrement en HTML défini par l’utilisateur est affiché dans un WKWebView et peut éventuellement contenir d’autres contenus enrichis, tels que des images et des polices, permettant un contrôle total de l’apparence et de la fonctionnalité du message.
Les messages in-app IOS prennent en charge une interface JavaScript brazeBridge pour appeler des méthodes sur le SDK Braze pour le Web depuis votre HTML. Pour plus d’informations, consultez nos meilleures pratiques.
L’exemple suivant montre la mise en page d’un message in-app HTML complet :
Notez que nous ne prenons actuellement pas en charge l’affichage de messages in-app HTML personnalisés dans un iFrame sur les plateformes iOS et Android.
Les messages in-app Control ne contiennent pas de composant d’interface utilisateur et sont utilisés principalement à des fins d’analyse. Ce type est utilisé pour vérifier la réception d’un message in-app envoyé à un groupe de contrôle.
Pour plus de détails sur la sélection intelligente et les groupes de contrôle, reportez-vous à la section Sélection intelligente.
Activation des messages in-app
Étape 1 : Créez une implémentation de BrazeInAppMessagePresenter
Pour permettre à Braze d’afficher des messages in-app, créez une implémentation du protocole BrazeInAppMessagePresenter et attribuez-la à l’option inAppMessagePresenter de votre instance Braze. Vous pouvez également utiliser le présentateur par défaut de Braze UI en instanciant un objet BrazeInAppMessageUI.
Notez que vous devrez importer la bibliothèque BrazeUI pour accéder à la classe BrazeInAppMessageUI.
1
AppDelegate.braze?.inAppMessagePresenter = BrazeInAppMessageUI()
1
AppDelegate.braze.inAppMessagePresenter = [[BrazeInAppMessageUI alloc] init];
Étape 2 : Manipuler aucun déclencheur correspondant
Mettre en œuvre BrazeDelegate.(_:noMatchingTriggerForEvent) dans la classe BrazeDelegate concernée. Lorsque Braze ne parvient pas à trouver un déclencheur correspondant à un événement particulier, il appelle automatiquement cette méthode.
Conditions préalables
Avant de pouvoir utiliser cette fonctionnalité, vous devrez intégrer le SDK Android Braze.
À propos de la prise en charge de la télévision et de l’OTT
Le SDK Android Braze prend nativement en charge l’affichage des messages in-app sur les appareils OTT comme Android TV ou Fire Stick. Cependant, il existe des différences essentielles entre les messages natifs Android et les messages in-app OTT. Pour les appareils OTT :
- Les messages in-app qui nécessitent un mode tactile, comme les messages contextuels, sont désactivés sur OTT.
- L’élément actuellement sélectionné ou ciblé, tel qu’un bouton ou un bouton de fermeture, sera mis en surbrillance.
- Les clics sur le corps du message in-app lui-même, c.-à-d., pas sur un bouton, ne sont pas pris en charge.
Conditions préalables
Avant de pouvoir utiliser cette fonctionnalité, vous devez intégrer le SDK Braze de Cordova.
Types de messages
Braze propose plusieurs types de messages in-app par défaut, chacun personnalisable avec des messages, des images, des icônes Font Awesome, des actions de clic, des analyses, des schémas de couleurs, et plus encore.
Leur comportement de base et leurs caractéristiques sont définis par l’interface IInAppMessage dans une sous-classe appelée InAppMessageBase. IInAppMessage comprend également une sous-interface, IInAppMessageImmersivequi vous permet d’ajouter des boutons de fermeture, de clic-action et d’analyse/analytique à votre application.
Gardez à l’esprit que les messages in-app contenant des boutons incluront le message clickAction dans la charge utile finale si l’action de clic est ajoutée avant l’ajout du texte du bouton.
slideup Les messages in-app sont ainsi nommés parce qu’ils “glissent vers le haut” ou “glissent vers le bas” depuis le haut ou le bas de l’écran. Ils recouvrent une petite partie de l’écran et offrent une fonctionnalité de messagerie efficace et non intrusive.
L’objet de message in-app slideup étend InAppMessageBase.
Les messages in-app de type modal apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Ils sont utiles pour les messages plus critiques et peuvent être équipés d’un bouton d’action et d’un bouton activé par analyse.
Ce type de message est une sous-classe de InAppMessageImmersiveBaseune classe abstraite qui implémente IInAppMessageImmersive, ce qui vous permet d’ajouter des fonctionnalités personnalisées à vos messages in-app générés localement.
full Les messages in-app sont utiles pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. La moitié supérieure d’un full message in-app contient une image, et la moitié inférieure affiche le texte et deux boutons d’action permettant l’analyse.
Ce type de message s’étend à InAppMessageImmersiveBasevous permettant d’ajouter des fonctionnalités personnalisées à vos messages in-app générés localement.
Les messages in-app HTML sont utiles pour créer un contenu utilisateur entièrement personnalisé. Le contenu du message in-app en HTML défini par l’utilisateur est affiché dans un WebView et peut éventuellement contenir d’autres contenus enrichis, tels que des images et des polices, permettant un contrôle total de l’apparence et de la fonctionnalité du message.
Ce type de message met en œuvre la norme IInAppMessageHtmlqui est une sous-classe de IInAppMessage.
Sur Android, les liens configurés avec target="_blank" dans les messages in-app HTML personnalisés s’ouvrent dans le navigateur web par défaut de l’appareil.
Les messages in-app Android prennent en charge une interface JavaScript brazeBridge pour appeler des méthodes du SDK Android de Braze à partir de votre HTML, voir notre page pont JavaScript pour plus de détails.
Actuellement, nous ne prenons pas en charge l’affichage de messages in-app HTML personnalisés dans un iFrame sur les plateformes iOS et Android.
Vous pouvez également définir des envois de messages in-app personnalisés pour votre application. Pour en savoir plus, consultez la rubrique Création d’usines personnalisées.
Chaque type de message in-app est hautement personnalisable en termes de contenu, d’images, d’icônes, d’actions de clic, d’analyse, d’affichage et de diffusion. Il s’agit de types énumérés de Braze.InAppMessage, qui définit le comportement et les caractéristiques de base de tous les messages in-app. Pour obtenir la liste complète des propriétés et de l’utilisation des messages in-app, consultez la classeInAppMessage .
Voici les types de messages in-app disponibles dans Braze et ce à quoi ils ressembleront pour les utilisateurs finaux.
Slideup Les messages in-app portent ce nom parce qu’ils “glissent vers le haut” ou “glissent vers le bas” depuis le haut ou le bas de l’écran. Ils recouvrent une petite partie de l’écran et offrent une fonctionnalité de messagerie efficace et non intrusive.
Les messages in-app de type Modal apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Utiles pour les communications plus critiques, ils peuvent être équipés d’un maximum de deux boutons dotés d’une fonction d’analyse.
Les messages in-app de type Modal Image apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Ces messages sont similaires au type Modal, mais sans en-tête ni texte de message. Utiles pour les communications plus critiques, ils peuvent être équipés d’un maximum de deux boutons dotés d’une fonction d’analyse.
Full Les messages in-app sont utiles pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. La moitié supérieure d’un message in-app Full contient une image, et la moitié inférieure affiche du texte et jusqu’à deux boutons permettant l’analyse.
Les messages in-app Full Image sont similaires aux messages in-app Full, sauf qu’ils ne comportent pas d’en-tête ni de texte de message. Ce type de message est utile pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. Un message in-app Full Image contient une image qui s’étend sur tout l’écran, avec la possibilité d’afficher jusqu’à deux boutons compatibles avec l’analyse.
Les messages in-app HTML sont utiles pour créer un contenu utilisateur entièrement personnalisé. Le contenu des messages in-app entièrement en HTML défini par l’utilisateur est affiché dans un WKWebView et peut éventuellement contenir d’autres contenus enrichis, tels que des images et des polices, permettant un contrôle total de l’apparence et de la fonctionnalité du message.
Les messages in-app IOS prennent en charge une interface JavaScript brazeBridge pour appeler des méthodes sur le SDK Braze pour le Web depuis votre HTML. Pour plus d’informations, consultez nos meilleures pratiques.
L’exemple suivant montre la mise en page d’un message in-app HTML complet :
Notez que nous ne prenons actuellement pas en charge l’affichage de messages in-app HTML personnalisés dans un iFrame sur les plateformes iOS et Android.
Les messages in-app Control ne contiennent pas de composant d’interface utilisateur et sont utilisés principalement à des fins d’analyse. Ce type est utilisé pour vérifier la réception d’un message in-app envoyé à un groupe de contrôle.
Pour plus de détails sur la sélection intelligente et les groupes de contrôle, reportez-vous à la section Sélection intelligente.
Conditions préalables
Avant de pouvoir utiliser cette fonctionnalité, vous devrez intégrer le SDK de Flutter Braze.
Types de messages
Braze propose plusieurs types de messages in-app par défaut, chacun personnalisable avec des messages, des images, des icônes Font Awesome, des actions de clic, des analyses, des schémas de couleurs, et plus encore.
Leur comportement de base et leurs caractéristiques sont définis par l’interface IInAppMessage dans une sous-classe appelée InAppMessageBase. IInAppMessage comprend également une sous-interface, IInAppMessageImmersivequi vous permet d’ajouter des boutons de fermeture, de clic-action et d’analyse/analytique à votre application.
Gardez à l’esprit que les messages in-app contenant des boutons incluront le message clickAction dans la charge utile finale si l’action de clic est ajoutée avant l’ajout du texte du bouton.
slideup Les messages in-app sont ainsi nommés parce qu’ils “glissent vers le haut” ou “glissent vers le bas” depuis le haut ou le bas de l’écran. Ils recouvrent une petite partie de l’écran et offrent une fonctionnalité de messagerie efficace et non intrusive.
L’objet de message in-app slideup étend InAppMessageBase.
Les messages in-app de type modal apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Ils sont utiles pour les messages plus critiques et peuvent être équipés d’un bouton d’action et d’un bouton activé par analyse.
Ce type de message est une sous-classe de InAppMessageImmersiveBaseune classe abstraite qui implémente IInAppMessageImmersive, ce qui vous permet d’ajouter des fonctionnalités personnalisées à vos messages in-app générés localement.
full Les messages in-app sont utiles pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. La moitié supérieure d’un full message in-app contient une image, et la moitié inférieure affiche le texte et deux boutons d’action permettant l’analyse.
Ce type de message s’étend à InAppMessageImmersiveBasevous permettant d’ajouter des fonctionnalités personnalisées à vos messages in-app générés localement.
Les messages in-app HTML sont utiles pour créer un contenu utilisateur entièrement personnalisé. Le contenu du message in-app en HTML défini par l’utilisateur est affiché dans un WebView et peut éventuellement contenir d’autres contenus enrichis, tels que des images et des polices, permettant un contrôle total de l’apparence et de la fonctionnalité du message.
Ce type de message met en œuvre la norme IInAppMessageHtmlqui est une sous-classe de IInAppMessage.
Sur Android, les liens configurés avec target="_blank" dans les messages in-app HTML personnalisés s’ouvrent dans le navigateur web par défaut de l’appareil.
Les messages in-app Android prennent en charge une interface JavaScript brazeBridge pour appeler des méthodes du SDK Android de Braze à partir de votre HTML, voir notre page pont JavaScript pour plus de détails.
Actuellement, nous ne prenons pas en charge l’affichage de messages in-app HTML personnalisés dans un iFrame sur les plateformes iOS et Android.
Vous pouvez également définir des envois de messages in-app personnalisés pour votre application. Pour en savoir plus, consultez la rubrique Création d’usines personnalisées.
Chaque type de message in-app est hautement personnalisable en termes de contenu, d’images, d’icônes, d’actions de clic, d’analyse, d’affichage et de diffusion. Il s’agit de types énumérés de Braze.InAppMessage, qui définit le comportement et les caractéristiques de base de tous les messages in-app. Pour obtenir la liste complète des propriétés et de l’utilisation des messages in-app, consultez la classeInAppMessage .
Voici les types de messages in-app disponibles dans Braze et ce à quoi ils ressembleront pour les utilisateurs finaux.
Slideup Les messages in-app portent ce nom parce qu’ils “glissent vers le haut” ou “glissent vers le bas” depuis le haut ou le bas de l’écran. Ils recouvrent une petite partie de l’écran et offrent une fonctionnalité de messagerie efficace et non intrusive.
Les messages in-app de type Modal apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Utiles pour les communications plus critiques, ils peuvent être équipés d’un maximum de deux boutons dotés d’une fonction d’analyse.
Les messages in-app de type Modal Image apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Ces messages sont similaires au type Modal, mais sans en-tête ni texte de message. Utiles pour les communications plus critiques, ils peuvent être équipés d’un maximum de deux boutons dotés d’une fonction d’analyse.
Full Les messages in-app sont utiles pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. La moitié supérieure d’un message in-app Full contient une image, et la moitié inférieure affiche du texte et jusqu’à deux boutons permettant l’analyse.
Les messages in-app Full Image sont similaires aux messages in-app Full, sauf qu’ils ne comportent pas d’en-tête ni de texte de message. Ce type de message est utile pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. Un message in-app Full Image contient une image qui s’étend sur tout l’écran, avec la possibilité d’afficher jusqu’à deux boutons compatibles avec l’analyse.
Les messages in-app HTML sont utiles pour créer un contenu utilisateur entièrement personnalisé. Le contenu des messages in-app entièrement en HTML défini par l’utilisateur est affiché dans un WKWebView et peut éventuellement contenir d’autres contenus enrichis, tels que des images et des polices, permettant un contrôle total de l’apparence et de la fonctionnalité du message.
Les messages in-app IOS prennent en charge une interface JavaScript brazeBridge pour appeler des méthodes sur le SDK Braze pour le Web depuis votre HTML. Pour plus d’informations, consultez nos meilleures pratiques.
L’exemple suivant montre la mise en page d’un message in-app HTML complet :
Notez que nous ne prenons actuellement pas en charge l’affichage de messages in-app HTML personnalisés dans un iFrame sur les plateformes iOS et Android.
Les messages in-app Control ne contiennent pas de composant d’interface utilisateur et sont utilisés principalement à des fins d’analyse. Ce type est utilisé pour vérifier la réception d’un message in-app envoyé à un groupe de contrôle.
Pour plus de détails sur la sélection intelligente et les groupes de contrôle, reportez-vous à la section Sélection intelligente.
Activation des messages in-app
Cette étape est réservée à iOS. L’implémentation par défaut des messages in-app est déjà mise en place sur Android.
Pour configurer le présentateur par défaut pour les messages in-app sur iOS, créez une implémentation du protocole BrazeInAppMessagePresenter et affectez-la à l’option inAppMessagePresenter sur votre instance Braze. Vous pouvez également utiliser le présentateur par défaut de Braze UI en instanciant un objet BrazeInAppMessageUI.
Vous devez importer la bibliothèque BrazeUI pour accéder à la classe BrazeInAppMessageUI.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
import BrazeUI
override func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil
) -> Bool {
...
let braze = BrazePlugin.initBraze(configuration)
// Initialize and assign the default `BrazeInAppMessageUI` class to the in-app message presenter.
braze.inAppMessagePresenter = BrazeInAppMessageUI()
AppDelegate.braze = braze
return true
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
@import BrazeUI;
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
...
Braze *braze = [BrazePlugin initBraze:configuration];
// Initialize and assign the default `BrazeInAppMessageUI` class to the in-app message presenter.
braze.inAppMessagePresenter = [[BrazeInAppMessageUI alloc] init];
AppDelegate.braze = braze;
[self.window makeKeyAndVisible];
return YES;
}
Pour personnaliser davantage votre mise en œuvre, reportez-vous à la section Enregistrement des données des messages in-app.
Conditions préalables
Avant de pouvoir utiliser cette fonctionnalité, vous devrez intégrer le SDK React Native Braze.
Types de messages
Braze propose plusieurs types de messages in-app par défaut, chacun personnalisable avec des messages, des images, des icônes Font Awesome, des actions de clic, des analyses, des schémas de couleurs, et plus encore.
Leur comportement de base et leurs caractéristiques sont définis par l’interface IInAppMessage dans une sous-classe appelée InAppMessageBase. IInAppMessage comprend également une sous-interface, IInAppMessageImmersivequi vous permet d’ajouter des boutons de fermeture, de clic-action et d’analyse/analytique à votre application.
Gardez à l’esprit que les messages in-app contenant des boutons incluront le message clickAction dans la charge utile finale si l’action de clic est ajoutée avant l’ajout du texte du bouton.
slideup Les messages in-app sont ainsi nommés parce qu’ils “glissent vers le haut” ou “glissent vers le bas” depuis le haut ou le bas de l’écran. Ils recouvrent une petite partie de l’écran et offrent une fonctionnalité de messagerie efficace et non intrusive.
L’objet de message in-app slideup étend InAppMessageBase.
Les messages in-app de type modal apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Ils sont utiles pour les messages plus critiques et peuvent être équipés d’un bouton d’action et d’un bouton activé par analyse.
Ce type de message est une sous-classe de InAppMessageImmersiveBaseune classe abstraite qui implémente IInAppMessageImmersive, ce qui vous permet d’ajouter des fonctionnalités personnalisées à vos messages in-app générés localement.
full Les messages in-app sont utiles pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. La moitié supérieure d’un full message in-app contient une image, et la moitié inférieure affiche le texte et deux boutons d’action permettant l’analyse.
Ce type de message s’étend à InAppMessageImmersiveBasevous permettant d’ajouter des fonctionnalités personnalisées à vos messages in-app générés localement.
Les messages in-app HTML sont utiles pour créer un contenu utilisateur entièrement personnalisé. Le contenu du message in-app en HTML défini par l’utilisateur est affiché dans un WebView et peut éventuellement contenir d’autres contenus enrichis, tels que des images et des polices, permettant un contrôle total de l’apparence et de la fonctionnalité du message.
Ce type de message met en œuvre la norme IInAppMessageHtmlqui est une sous-classe de IInAppMessage.
Sur Android, les liens configurés avec target="_blank" dans les messages in-app HTML personnalisés s’ouvrent dans le navigateur web par défaut de l’appareil.
Les messages in-app Android prennent en charge une interface JavaScript brazeBridge pour appeler des méthodes du SDK Android de Braze à partir de votre HTML, voir notre page pont JavaScript pour plus de détails.
Actuellement, nous ne prenons pas en charge l’affichage de messages in-app HTML personnalisés dans un iFrame sur les plateformes iOS et Android.
Vous pouvez également définir des envois de messages in-app personnalisés pour votre application. Pour en savoir plus, consultez la rubrique Création d’usines personnalisées.
Chaque type de message in-app est hautement personnalisable en termes de contenu, d’images, d’icônes, d’actions de clic, d’analyse, d’affichage et de diffusion. Il s’agit de types énumérés de Braze.InAppMessage, qui définit le comportement et les caractéristiques de base de tous les messages in-app. Pour obtenir la liste complète des propriétés et de l’utilisation des messages in-app, consultez la classeInAppMessage .
Voici les types de messages in-app disponibles dans Braze et ce à quoi ils ressembleront pour les utilisateurs finaux.
Slideup Les messages in-app portent ce nom parce qu’ils “glissent vers le haut” ou “glissent vers le bas” depuis le haut ou le bas de l’écran. Ils recouvrent une petite partie de l’écran et offrent une fonctionnalité de messagerie efficace et non intrusive.
Les messages in-app de type Modal apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Utiles pour les communications plus critiques, ils peuvent être équipés d’un maximum de deux boutons dotés d’une fonction d’analyse.
Les messages in-app de type Modal Image apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Ces messages sont similaires au type Modal, mais sans en-tête ni texte de message. Utiles pour les communications plus critiques, ils peuvent être équipés d’un maximum de deux boutons dotés d’une fonction d’analyse.
Full Les messages in-app sont utiles pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. La moitié supérieure d’un message in-app Full contient une image, et la moitié inférieure affiche du texte et jusqu’à deux boutons permettant l’analyse.
Les messages in-app Full Image sont similaires aux messages in-app Full, sauf qu’ils ne comportent pas d’en-tête ni de texte de message. Ce type de message est utile pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. Un message in-app Full Image contient une image qui s’étend sur tout l’écran, avec la possibilité d’afficher jusqu’à deux boutons compatibles avec l’analyse.
Les messages in-app HTML sont utiles pour créer un contenu utilisateur entièrement personnalisé. Le contenu des messages in-app entièrement en HTML défini par l’utilisateur est affiché dans un WKWebView et peut éventuellement contenir d’autres contenus enrichis, tels que des images et des polices, permettant un contrôle total de l’apparence et de la fonctionnalité du message.
Les messages in-app IOS prennent en charge une interface JavaScript brazeBridge pour appeler des méthodes sur le SDK Braze pour le Web depuis votre HTML. Pour plus d’informations, consultez nos meilleures pratiques.
L’exemple suivant montre la mise en page d’un message in-app HTML complet :
Notez que nous ne prenons actuellement pas en charge l’affichage de messages in-app HTML personnalisés dans un iFrame sur les plateformes iOS et Android.
Les messages in-app Control ne contiennent pas de composant d’interface utilisateur et sont utilisés principalement à des fins d’analyse. Ce type est utilisé pour vérifier la réception d’un message in-app envoyé à un groupe de contrôle.
Pour plus de détails sur la sélection intelligente et les groupes de contrôle, reportez-vous à la section Sélection intelligente.
Modèle de données
Le modèle de message in-app est disponible dans le SDK React Native. Braze propose quatre types de messages in-app qui partagent le même modèle de données : contextuel fenêtre modale, complet et HTML complet.
Messages
Le modèle de message in-app constitue la base de tous les messages in-app.
| Propriété | Description |
|---|---|
inAppMessageJsonString |
La représentation JSON du message. |
message |
Le texte du message. |
header |
L’en-tête du message. |
uri |
L’URI associé à l’action de clic sur le bouton. |
imageUrl |
L’URL de l’image du message. |
zippedAssetsUrl |
Les ressources zippées préparées pour afficher le contenu HTML. |
useWebView |
Indique si l’action de clic sur le bouton doit être redirigée à l’aide d’une vue web. |
duration |
La durée d’affichage du message. |
clickAction |
Le type d’action « clic sur bouton ». Les types sont : URI, et NONE. |
dismissType |
Le type de fermeture du message. Les deux types sont : SWIPE et AUTO_DISMISS. |
messageType |
Le type de message in-app pris en charge par le SDK. Les quatre types sont les suivants : SLIDEUP, MODAL, FULL et HTML_FULL. |
extras |
Le dictionnaire des suppléments de message. Valeur par défaut : [:]. |
buttons |
La liste des boutons sur le message in-app. |
toString() |
L’envoi de messages sous la forme d’une chaîne de caractères. |
Pour une référence complète du modèle d’envoi de messages in-app, consultez la documentation Android et iOS.
Boutons
Des boutons peuvent être ajoutés aux messages in-app pour effectuer des actions et enregistrer des analyses. Le modèle de bouton constitue la base de tous les boutons de messages in-app.
| Propriété | Description |
|---|---|
text |
Le texte du bouton. |
uri |
L’URI associé à l’action de clic sur le bouton. |
useWebView |
Indique si l’action de clic sur le bouton doit être redirigée à l’aide d’une vue web. |
clickAction |
Le type d’action de clic traité lorsque l’utilisateur clique sur le bouton. Les types sont : URI, et NONE. |
id |
L’ID du bouton dans le message. |
toString() |
Le bouton sous forme de chaîne de caractères. |
Pour une référence complète du modèle de bouton, consultez la documentation Android et iOS.
Conditions préalables
Avant de pouvoir utiliser cette fonctionnalité, vous devrez intégrer le SDK Roku Braze. En outre, les messages in-app ne seront envoyés qu’aux appareils Roku exécutant la version minimale du SDK prise en charge :
Types de messages
Braze propose plusieurs types de messages in-app par défaut, chacun personnalisable avec des messages, des images, des icônes Font Awesome, des actions de clic, des analyses, des schémas de couleurs, et plus encore.
Leur comportement de base et leurs caractéristiques sont définis par l’interface IInAppMessage dans une sous-classe appelée InAppMessageBase. IInAppMessage comprend également une sous-interface, IInAppMessageImmersivequi vous permet d’ajouter des boutons de fermeture, de clic-action et d’analyse/analytique à votre application.
Gardez à l’esprit que les messages in-app contenant des boutons incluront le message clickAction dans la charge utile finale si l’action de clic est ajoutée avant l’ajout du texte du bouton.
slideup Les messages in-app sont ainsi nommés parce qu’ils “glissent vers le haut” ou “glissent vers le bas” depuis le haut ou le bas de l’écran. Ils recouvrent une petite partie de l’écran et offrent une fonctionnalité de messagerie efficace et non intrusive.
L’objet de message in-app slideup étend InAppMessageBase.
Les messages in-app de type modal apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Ils sont utiles pour les messages plus critiques et peuvent être équipés d’un bouton d’action et d’un bouton activé par analyse.
Ce type de message est une sous-classe de InAppMessageImmersiveBaseune classe abstraite qui implémente IInAppMessageImmersive, ce qui vous permet d’ajouter des fonctionnalités personnalisées à vos messages in-app générés localement.
full Les messages in-app sont utiles pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. La moitié supérieure d’un full message in-app contient une image, et la moitié inférieure affiche le texte et deux boutons d’action permettant l’analyse.
Ce type de message s’étend à InAppMessageImmersiveBasevous permettant d’ajouter des fonctionnalités personnalisées à vos messages in-app générés localement.
Les messages in-app HTML sont utiles pour créer un contenu utilisateur entièrement personnalisé. Le contenu du message in-app en HTML défini par l’utilisateur est affiché dans un WebView et peut éventuellement contenir d’autres contenus enrichis, tels que des images et des polices, permettant un contrôle total de l’apparence et de la fonctionnalité du message.
Ce type de message met en œuvre la norme IInAppMessageHtmlqui est une sous-classe de IInAppMessage.
Sur Android, les liens configurés avec target="_blank" dans les messages in-app HTML personnalisés s’ouvrent dans le navigateur web par défaut de l’appareil.
Les messages in-app Android prennent en charge une interface JavaScript brazeBridge pour appeler des méthodes du SDK Android de Braze à partir de votre HTML, voir notre page pont JavaScript pour plus de détails.
Actuellement, nous ne prenons pas en charge l’affichage de messages in-app HTML personnalisés dans un iFrame sur les plateformes iOS et Android.
Vous pouvez également définir des envois de messages in-app personnalisés pour votre application. Pour en savoir plus, consultez la rubrique Création d’usines personnalisées.
Chaque type de message in-app est hautement personnalisable en termes de contenu, d’images, d’icônes, d’actions de clic, d’analyse, d’affichage et de diffusion. Il s’agit de types énumérés de Braze.InAppMessage, qui définit le comportement et les caractéristiques de base de tous les messages in-app. Pour obtenir la liste complète des propriétés et de l’utilisation des messages in-app, consultez la classeInAppMessage .
Voici les types de messages in-app disponibles dans Braze et ce à quoi ils ressembleront pour les utilisateurs finaux.
Slideup Les messages in-app portent ce nom parce qu’ils “glissent vers le haut” ou “glissent vers le bas” depuis le haut ou le bas de l’écran. Ils recouvrent une petite partie de l’écran et offrent une fonctionnalité de messagerie efficace et non intrusive.
Les messages in-app de type Modal apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Utiles pour les communications plus critiques, ils peuvent être équipés d’un maximum de deux boutons dotés d’une fonction d’analyse.
Les messages in-app de type Modal Image apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Ces messages sont similaires au type Modal, mais sans en-tête ni texte de message. Utiles pour les communications plus critiques, ils peuvent être équipés d’un maximum de deux boutons dotés d’une fonction d’analyse.
Full Les messages in-app sont utiles pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. La moitié supérieure d’un message in-app Full contient une image, et la moitié inférieure affiche du texte et jusqu’à deux boutons permettant l’analyse.
Les messages in-app Full Image sont similaires aux messages in-app Full, sauf qu’ils ne comportent pas d’en-tête ni de texte de message. Ce type de message est utile pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. Un message in-app Full Image contient une image qui s’étend sur tout l’écran, avec la possibilité d’afficher jusqu’à deux boutons compatibles avec l’analyse.
Les messages in-app HTML sont utiles pour créer un contenu utilisateur entièrement personnalisé. Le contenu des messages in-app entièrement en HTML défini par l’utilisateur est affiché dans un WKWebView et peut éventuellement contenir d’autres contenus enrichis, tels que des images et des polices, permettant un contrôle total de l’apparence et de la fonctionnalité du message.
Les messages in-app IOS prennent en charge une interface JavaScript brazeBridge pour appeler des méthodes sur le SDK Braze pour le Web depuis votre HTML. Pour plus d’informations, consultez nos meilleures pratiques.
L’exemple suivant montre la mise en page d’un message in-app HTML complet :
Notez que nous ne prenons actuellement pas en charge l’affichage de messages in-app HTML personnalisés dans un iFrame sur les plateformes iOS et Android.
Les messages in-app Control ne contiennent pas de composant d’interface utilisateur et sont utilisés principalement à des fins d’analyse. Ce type est utilisé pour vérifier la réception d’un message in-app envoyé à un groupe de contrôle.
Pour plus de détails sur la sélection intelligente et les groupes de contrôle, reportez-vous à la section Sélection intelligente.
Activation des messages in-app
Étape 1 : Ajouter un observateur
Pour traiter les messages in-app, vous pouvez ajouter un observateur à BrazeTask.BrazeInAppMessage :
1
m.BrazeTask.observeField("BrazeInAppMessage", "onInAppMessageReceived")
Étape 2 : Accéder aux messages déclenchés
Puis, dans votre gestionnaire, vous avez accès au message in-app le plus élevé que vos campagnes ont déclenché :
1
2
3
4
sub onInAppMessageReceived()
in_app_message = m.BrazeTask.BrazeInAppMessage
...
end sub
Champs de messages
Manipulation
Les champs suivants répertorient les champs dont vous aurez besoin pour gérer vos messages in-app :
| Champs | Description |
|---|---|
buttons |
Liste des boutons (peut être une liste vide). |
click_action |
"URI" ou "NONE". Utilisez ce champ pour indiquer si le message in-app doit s’ouvrir sur un lien URI ou fermer le message lorsque vous cliquez dessus. Lorsqu’il n’y a pas de boutons, cela doit se produire lorsque l’utilisateur clique sur « OK » quand le message in-app s’affiche. |
dismiss_type |
"AUTO_DISMISS" ou "SWIPE". Utilisez ce champ pour indiquer si votre message intégré à l’application sera automatiquement supprimé ou nécessitera d’être balayé pour être supprimé. |
display_delay |
Durée d’attente (en secondes) jusqu’à l’affichage du message in-app. |
duration |
Durée d’affichage (en millisecondes) du message quand dismiss_type est défini sur "AUTO_DISMISS". |
extras |
Paires clé-valeur. |
header |
Le texte de l’en-tête. |
id |
L’ID utilisé pour journaliser les impressions ou les clics. |
image_url |
URL de l’image du message in-app. |
message |
Texte du corps de message. |
uri |
Vos utilisateurs URI seront envoyés vers en fonction de votre click_action. Ce champ doit être inclus lorsque click_action est "URI". |
Pour les messages in-app contenant des boutons, le message click_action sera également inclus dans la charge utile finale si l’action de clic est ajoutée avant l’ajout du texte du bouton.
Stylisme
Il existe également plusieurs champs de style que vous pouvez choisir d’utiliser dans le tableau de bord :
| Champs | Description |
|---|---|
bg_color |
Couleur d’arrière-plan. |
close_button_color |
Couleur du bouton de fermeture. |
frame_color |
La couleur du recouvrement de l’écran d’arrière-plan. |
header_text_color |
Couleur du texte en-tête. |
message_text_color |
Couleur du texte du message. |
text_align |
« START », « CENTER » ou « END ». L’alignement de texte que vous avez sélectionné. |
Vous pouvez également implémenter le message in-app et modifier son style dans votre application Roku à l’aide d’une palette standard :
Boutons
| Champs | Description |
|---|---|
click_action |
"URI" ou "NONE". Utilisez ce champ pour indiquer si le message in-app doit s’ouvrir sur un lien URI ou fermer le message lorsque vous cliquez dessus. |
id |
La valeur d’ID du bouton lui-même. |
text |
Le texte à afficher sur le bouton. |
uri |
Vos utilisateurs URI seront envoyés vers en fonction de votre click_action. Ce champ doit être inclus lorsque click_action est "URI". |
Gardez à l’esprit que vous devrez implémenter votre propre interface utilisateur personnalisée, étant donné que l’envoi de messages in-app est pris en charge par une interface utilisateur Headless à l’aide du SDK Swift, qui n’inclut pas d’interface utilisateur ou de vues par défaut pour tvOS.
Conditions préalables
Avant de pouvoir utiliser cette fonctionnalité, vous devrez intégrer le SDK Swift Braze.
Activation des messages in-app
Étape 1 : Créer une nouvelle application iOS
Dans Braze, sélectionnez Paramètres > Paramètres des applications, puis Ajouter une application. Saisissez un nom pour votre application tvOS, sélectionnez iOS, et non tvOS, puis sélectionnez Ajouter une application.
Si vous cochez la case tvOS, vous ne pourrez pas personnaliser les messages in-app pour tvOS.
Étape 2 : Obtenir la clé API de votre application
Dans les paramètres de votre application, sélectionnez votre nouvelle appli tvOS, puis prenez note de la clé API de votre appli. Vous utiliserez cette clé pour configurer votre application dans Xcode.
Étape 3 : Intégrer BrazeKit
Utilisez la clé API de votre application pour intégrer le SDK Braze Swift à votre projet tvOS dans Xcode. Il vous suffit d’intégrer BrazeKit à partir du SDK Swift de Braze.
Étape 4 : Créez votre interface utilisateur personnalisée
Braze ne proposant pas d’interface utilisateur par défaut pour les messages in-app sur tvOS, vous devrez la personnaliser vous-même. Pour une description complète, consultez notre tutoriel étape par étape : Personnalisation des messages in-app pour tvOS. Pour obtenir un exemple de projet, consultez les exemples du SDK Swift de Braze.
Conditions préalables
Avant de pouvoir utiliser cette fonctionnalité, vous devez intégrer le SDK d’Unity Braze.
Types de messages
Braze propose plusieurs types de messages in-app par défaut, chacun personnalisable avec des messages, des images, des icônes Font Awesome, des actions de clic, des analyses, des schémas de couleurs, et plus encore.
Leur comportement de base et leurs caractéristiques sont définis par l’interface IInAppMessage dans une sous-classe appelée InAppMessageBase. IInAppMessage comprend également une sous-interface, IInAppMessageImmersivequi vous permet d’ajouter des boutons de fermeture, de clic-action et d’analyse/analytique à votre application.
Gardez à l’esprit que les messages in-app contenant des boutons incluront le message clickAction dans la charge utile finale si l’action de clic est ajoutée avant l’ajout du texte du bouton.
slideup Les messages in-app sont ainsi nommés parce qu’ils “glissent vers le haut” ou “glissent vers le bas” depuis le haut ou le bas de l’écran. Ils recouvrent une petite partie de l’écran et offrent une fonctionnalité de messagerie efficace et non intrusive.
L’objet de message in-app slideup étend InAppMessageBase.
Les messages in-app de type modal apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Ils sont utiles pour les messages plus critiques et peuvent être équipés d’un bouton d’action et d’un bouton activé par analyse.
Ce type de message est une sous-classe de InAppMessageImmersiveBaseune classe abstraite qui implémente IInAppMessageImmersive, ce qui vous permet d’ajouter des fonctionnalités personnalisées à vos messages in-app générés localement.
full Les messages in-app sont utiles pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. La moitié supérieure d’un full message in-app contient une image, et la moitié inférieure affiche le texte et deux boutons d’action permettant l’analyse.
Ce type de message s’étend à InAppMessageImmersiveBasevous permettant d’ajouter des fonctionnalités personnalisées à vos messages in-app générés localement.
Les messages in-app HTML sont utiles pour créer un contenu utilisateur entièrement personnalisé. Le contenu du message in-app en HTML défini par l’utilisateur est affiché dans un WebView et peut éventuellement contenir d’autres contenus enrichis, tels que des images et des polices, permettant un contrôle total de l’apparence et de la fonctionnalité du message.
Ce type de message met en œuvre la norme IInAppMessageHtmlqui est une sous-classe de IInAppMessage.
Sur Android, les liens configurés avec target="_blank" dans les messages in-app HTML personnalisés s’ouvrent dans le navigateur web par défaut de l’appareil.
Les messages in-app Android prennent en charge une interface JavaScript brazeBridge pour appeler des méthodes du SDK Android de Braze à partir de votre HTML, voir notre page pont JavaScript pour plus de détails.
Actuellement, nous ne prenons pas en charge l’affichage de messages in-app HTML personnalisés dans un iFrame sur les plateformes iOS et Android.
Vous pouvez également définir des envois de messages in-app personnalisés pour votre application. Pour en savoir plus, consultez la rubrique Création d’usines personnalisées.
Chaque type de message in-app est hautement personnalisable en termes de contenu, d’images, d’icônes, d’actions de clic, d’analyse, d’affichage et de diffusion. Il s’agit de types énumérés de Braze.InAppMessage, qui définit le comportement et les caractéristiques de base de tous les messages in-app. Pour obtenir la liste complète des propriétés et de l’utilisation des messages in-app, consultez la classeInAppMessage .
Voici les types de messages in-app disponibles dans Braze et ce à quoi ils ressembleront pour les utilisateurs finaux.
Slideup Les messages in-app portent ce nom parce qu’ils “glissent vers le haut” ou “glissent vers le bas” depuis le haut ou le bas de l’écran. Ils recouvrent une petite partie de l’écran et offrent une fonctionnalité de messagerie efficace et non intrusive.
Les messages in-app de type Modal apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Utiles pour les communications plus critiques, ils peuvent être équipés d’un maximum de deux boutons dotés d’une fonction d’analyse.
Les messages in-app de type Modal Image apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Ces messages sont similaires au type Modal, mais sans en-tête ni texte de message. Utiles pour les communications plus critiques, ils peuvent être équipés d’un maximum de deux boutons dotés d’une fonction d’analyse.
Full Les messages in-app sont utiles pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. La moitié supérieure d’un message in-app Full contient une image, et la moitié inférieure affiche du texte et jusqu’à deux boutons permettant l’analyse.
Les messages in-app Full Image sont similaires aux messages in-app Full, sauf qu’ils ne comportent pas d’en-tête ni de texte de message. Ce type de message est utile pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. Un message in-app Full Image contient une image qui s’étend sur tout l’écran, avec la possibilité d’afficher jusqu’à deux boutons compatibles avec l’analyse.
Les messages in-app HTML sont utiles pour créer un contenu utilisateur entièrement personnalisé. Le contenu des messages in-app entièrement en HTML défini par l’utilisateur est affiché dans un WKWebView et peut éventuellement contenir d’autres contenus enrichis, tels que des images et des polices, permettant un contrôle total de l’apparence et de la fonctionnalité du message.
Les messages in-app IOS prennent en charge une interface JavaScript brazeBridge pour appeler des méthodes sur le SDK Braze pour le Web depuis votre HTML. Pour plus d’informations, consultez nos meilleures pratiques.
L’exemple suivant montre la mise en page d’un message in-app HTML complet :
Notez que nous ne prenons actuellement pas en charge l’affichage de messages in-app HTML personnalisés dans un iFrame sur les plateformes iOS et Android.
Les messages in-app Control ne contiennent pas de composant d’interface utilisateur et sont utilisés principalement à des fins d’analyse. Ce type est utilisé pour vérifier la réception d’un message in-app envoyé à un groupe de contrôle.
Pour plus de détails sur la sélection intelligente et les groupes de contrôle, reportez-vous à la section Sélection intelligente.
Conditions préalables
Avant de pouvoir utiliser cette fonctionnalité, vous devez intégrer le SDK .NET MAUI Braze.
Types de messages
Braze propose plusieurs types de messages in-app par défaut, chacun personnalisable avec des messages, des images, des icônes Font Awesome, des actions de clic, des analyses, des schémas de couleurs, et plus encore.
Leur comportement de base et leurs caractéristiques sont définis par l’interface IInAppMessage dans une sous-classe appelée InAppMessageBase. IInAppMessage comprend également une sous-interface, IInAppMessageImmersivequi vous permet d’ajouter des boutons de fermeture, de clic-action et d’analyse/analytique à votre application.
Gardez à l’esprit que les messages in-app contenant des boutons incluront le message clickAction dans la charge utile finale si l’action de clic est ajoutée avant l’ajout du texte du bouton.
slideup Les messages in-app sont ainsi nommés parce qu’ils “glissent vers le haut” ou “glissent vers le bas” depuis le haut ou le bas de l’écran. Ils recouvrent une petite partie de l’écran et offrent une fonctionnalité de messagerie efficace et non intrusive.
L’objet de message in-app slideup étend InAppMessageBase.
Les messages in-app de type modal apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Ils sont utiles pour les messages plus critiques et peuvent être équipés d’un bouton d’action et d’un bouton activé par analyse.
Ce type de message est une sous-classe de InAppMessageImmersiveBaseune classe abstraite qui implémente IInAppMessageImmersive, ce qui vous permet d’ajouter des fonctionnalités personnalisées à vos messages in-app générés localement.
full Les messages in-app sont utiles pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. La moitié supérieure d’un full message in-app contient une image, et la moitié inférieure affiche le texte et deux boutons d’action permettant l’analyse.
Ce type de message s’étend à InAppMessageImmersiveBasevous permettant d’ajouter des fonctionnalités personnalisées à vos messages in-app générés localement.
Les messages in-app HTML sont utiles pour créer un contenu utilisateur entièrement personnalisé. Le contenu du message in-app en HTML défini par l’utilisateur est affiché dans un WebView et peut éventuellement contenir d’autres contenus enrichis, tels que des images et des polices, permettant un contrôle total de l’apparence et de la fonctionnalité du message.
Ce type de message met en œuvre la norme IInAppMessageHtmlqui est une sous-classe de IInAppMessage.
Sur Android, les liens configurés avec target="_blank" dans les messages in-app HTML personnalisés s’ouvrent dans le navigateur web par défaut de l’appareil.
Les messages in-app Android prennent en charge une interface JavaScript brazeBridge pour appeler des méthodes du SDK Android de Braze à partir de votre HTML, voir notre page pont JavaScript pour plus de détails.
Actuellement, nous ne prenons pas en charge l’affichage de messages in-app HTML personnalisés dans un iFrame sur les plateformes iOS et Android.
Vous pouvez également définir des envois de messages in-app personnalisés pour votre application. Pour en savoir plus, consultez la rubrique Création d’usines personnalisées.
Chaque type de message in-app est hautement personnalisable en termes de contenu, d’images, d’icônes, d’actions de clic, d’analyse, d’affichage et de diffusion. Il s’agit de types énumérés de Braze.InAppMessage, qui définit le comportement et les caractéristiques de base de tous les messages in-app. Pour obtenir la liste complète des propriétés et de l’utilisation des messages in-app, consultez la classeInAppMessage .
Voici les types de messages in-app disponibles dans Braze et ce à quoi ils ressembleront pour les utilisateurs finaux.
Slideup Les messages in-app portent ce nom parce qu’ils “glissent vers le haut” ou “glissent vers le bas” depuis le haut ou le bas de l’écran. Ils recouvrent une petite partie de l’écran et offrent une fonctionnalité de messagerie efficace et non intrusive.
Les messages in-app de type Modal apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Utiles pour les communications plus critiques, ils peuvent être équipés d’un maximum de deux boutons dotés d’une fonction d’analyse.
Les messages in-app de type Modal Image apparaissent au centre de l’écran et sont encadrés par un panneau transparent. Ces messages sont similaires au type Modal, mais sans en-tête ni texte de message. Utiles pour les communications plus critiques, ils peuvent être équipés d’un maximum de deux boutons dotés d’une fonction d’analyse.
Full Les messages in-app sont utiles pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. La moitié supérieure d’un message in-app Full contient une image, et la moitié inférieure affiche du texte et jusqu’à deux boutons permettant l’analyse.
Les messages in-app Full Image sont similaires aux messages in-app Full, sauf qu’ils ne comportent pas d’en-tête ni de texte de message. Ce type de message est utile pour maximiser le contenu et l’impact de votre communication avec les utilisateurs. Un message in-app Full Image contient une image qui s’étend sur tout l’écran, avec la possibilité d’afficher jusqu’à deux boutons compatibles avec l’analyse.
Les messages in-app HTML sont utiles pour créer un contenu utilisateur entièrement personnalisé. Le contenu des messages in-app entièrement en HTML défini par l’utilisateur est affiché dans un WKWebView et peut éventuellement contenir d’autres contenus enrichis, tels que des images et des polices, permettant un contrôle total de l’apparence et de la fonctionnalité du message.
Les messages in-app IOS prennent en charge une interface JavaScript brazeBridge pour appeler des méthodes sur le SDK Braze pour le Web depuis votre HTML. Pour plus d’informations, consultez nos meilleures pratiques.
L’exemple suivant montre la mise en page d’un message in-app HTML complet :
Notez que nous ne prenons actuellement pas en charge l’affichage de messages in-app HTML personnalisés dans un iFrame sur les plateformes iOS et Android.
Les messages in-app Control ne contiennent pas de composant d’interface utilisateur et sont utilisés principalement à des fins d’analyse. Ce type est utilisé pour vérifier la réception d’un message in-app envoyé à un groupe de contrôle.
Pour plus de détails sur la sélection intelligente et les groupes de contrôle, reportez-vous à la section Sélection intelligente.
Étapes suivantes
Prêt à approfondir ? Consultez ces tutoriels étape par étape :
- Réglez avec précision le délai de réception/distribution des messages en reportant et en rétablissant les messages déclenchés.
- Affinez le ciblage des messages en définissant des règles d’affichage conditionnelles.
- Adaptez le style de votre marque en personnalisant le style des messages à l’aide de paires clé-valeur.
Modifier cette page sur GitHub