Livraison de messages in-app
Cet article décrit la livraison de messages in-app via le SDK Braze, comme l’affichage manuel de messages in-app ou l’envoi de messages locaux et à intention de sortie.
Types de déclencheurs
Notre produit de messages in-app vous permet de déclencher un affichage de messages in-app suite à plusieurs types d’événements différents : Any Purchase
, Specific Purchase
, Session Start
, Custom Event
et Push Click
. En outre, les déclencheurs Specific Purchase
et Custom Event
contiennent des filtres de propriétés robustes.
Les messages in-app déclenchés ne fonctionnent qu’avec des événements personnalisés enregistrés via le SDK de Braze. Les messages in-app peuvent être déclenchés via l’API ou les événements API (comme les événements d’achat). Si vous travaillez avec une application web, découvrez comment enregistrer des événements personnalisés.
Sémantiques de livraison
Tous les messages in-app qu’un utilisateur est admissible à recevoir sont automatiquement téléchargés sur l’appareil de l’utilisateur ou son navigateur lors d’un événement de démarrage de session et déclenchés conformément aux règles de livraison du message. Consultez notre documentation sur le cycle de vie des sessions pour plus d’informations sur la sémantique de démarrage des sessions du SDK.
Intervalle de temps minimum entre les déclencheurs
Par défaut, nous appliquons des limites de débit d’une fois toutes les 30 secondes pour les messages in-app afin de garantir une expérience utilisateur de qualité. Pour remplacer cette valeur, vous pouvez transmettre minimumIntervalBetweenTriggerActionsInSeconds
l’option de configuration à votre fonction initialize
:
1
2
// Sets the minimum time interval between triggered in-app messages to 5 seconds instead of the default 30
braze.initialize('YOUR-API-KEY', { minimumIntervalBetweenTriggerActionsInSeconds: 5 })
Affichage manuel de messages in-app
Si vous ne souhaitez pas que votre site affiche immédiatement les nouveaux messages in-app lorsqu’ils sont déclenchés, vous pouvez désactiver l’affichage automatique et enregistrer vos propres abonnements d’affichage.
Tout d’abord, trouvez et supprimez l’appel à braze.automaticallyShowInAppMessages()
à partir de votre extrait de code de chargement. Créez ensuite votre propre logique pour gérer de manière personnalisée un message in-app de déclenchement, dans lequel vous affichez ou n’affichez pas le message.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
braze.subscribeToInAppMessage(function(inAppMessage) {
// control group messages should always be "shown"
// this will log an impression and not show a visible message
if (inAppMessage.isControl) { // v4.5.0+, otherwise use `inAppMessage instanceof braze.ControlMessage`
return braze.showInAppMessage(inAppMessage);
}
// Display the in-app message. You could defer display here by pushing this message to code within your own application.
// If you don't want to use Braze's built-in display capabilities, you could alternatively pass the in-app message to your own display code here.
if ( should_show_the_message_according_to_your_custom_logic ) {
braze.showInAppMessage(inAppMessage);
} else {
// do nothing
}
});
Si vous ne retirez pas braze.automaticallyShowInAppMessages()
de votre site Internet lorsque vous appelez également braze.showInAppMessage
, le message peut être affiché deux fois.
Le paramètre inAppMessage
sera une sous-classe braze.InAppMessage
ou un objet braze.ControlMessage
, chacun ayant des méthodes différentes d’abonnement aux événements de cycle de vie. Voir les JSDocs pour une documentation complète.
Un seul message in-app Modal
ou Full
peut être affiché à un instant donné. Si vous essayez de montrer un deuxième message modal ou complet, alors qu’un s’affiche déjà, braze.showInAppMessage
renverra « faux » et le deuxième message ne s’affichera pas.
Messages in-app locaux
Les messages in-app peuvent également être créés dans l’application et affichés localement en temps réel. Toutes les options de personnalisation disponibles sur le tableau de bord sont également disponibles localement. Ceci est particulièrement utile pour afficher les messages que vous souhaitez déclencher dans l’application en temps réel. Cependant, l’analyse de ces messages créés localement ne sera pas disponible dans le tableau de bord de Braze.
1
2
3
4
// Displays a slideup type in-app message.
var message = new braze.SlideUpMessage("Welcome to Braze! This is an in-app message.");
message.slideFrom = braze.InAppMessage.SlideFrom.TOP;
braze.showInAppMessage(message);
Messages d’intention de sortie
Les messages in-app d’intention de sortie apparaissent lorsque les visiteurs sont sur le point de quitter votre site. Ils offrent une autre possibilité de communiquer des informations importantes aux utilisateurs tout en n’interrompant pas leur expérience de votre site.
Pour envoyer ces messages, ajoutez d’abord à votre site web une bibliothèque d’intentions de sortie, telle que cette bibliothèque open-source. Utilisez ensuite l’extrait de code suivant pour enregistrer « l’intention de sortie » en tant qu’événement personnalisé. Les campagnes de communication in-app peuvent alors être créées dans le tableau de bord en utilisant « l’intention de sortie » comme événement personnalisé déclencheur.
1
2
3
var _ouibounce = ouibounce(false, {
callback: function() { braze.logCustomEvent('exit intent'); }
});