Personnalisez vos messages Firebase In-App Messaging

Firebase In-App Messaging fournit un ensemble utile de comportements et de types de messages préconfigurés avec une apparence par défaut, mais dans certains cas, vous souhaiterez peut-être étendre les comportements et le contenu des messages. La messagerie intégrée à l'application vous permet d'ajouter des actions aux messages et de personnaliser l'apparence des messages.

Ajouter une action à votre message

Avec les actions, vous pouvez utiliser vos messages intégrés à l'application pour diriger les utilisateurs vers un site Web ou un écran spécifique de votre application.

Firebase In-App Messaging utilise des gestionnaires de liens pour traiter les actions. Le SDK est capable d'utiliser un certain nombre de gestionnaires, donc si votre application en a déjà un, Firebase In-App Messaging peut l'utiliser sans autre configuration. Si vous n'avez pas encore de gestionnaire, vous pouvez utiliser Firebase Dynamic Links. Pour en savoir plus, consultez Créer des liens dynamiques sur iOS .

Ajoutez l'action à votre message à l'aide de la console Firebase

Une fois que votre application dispose d'un gestionnaire de liens, vous êtes prêt à composer une campagne avec une action. Ouvrez la console Firebase sur Messaging et démarrez une nouvelle campagne ou modifiez une campagne existante. Dans cette campagne, fournissez une carte , un texte de bouton et une action de bouton , une action d'image ou une action de bannière , où l'action est un lien profond pertinent.

Le format de l'action dépend de la disposition de message que vous choisissez. Les modaux obtiennent des boutons d'action avec un contenu de texte de bouton personnalisable, une couleur de texte et une couleur d'arrière-plan. Les images et les bannières supérieures, d'autre part, deviennent interactives et invoquent l'action spécifiée lorsqu'elles sont tapées.

Modifier l'apparence du message

Firebase In-App Messaging vous permet de personnaliser l'affichage des messages pour modifier la façon dont votre application restitue la disposition des messages, les styles de police, les formes des boutons et d'autres détails. Il existe deux façons de modifier l'affichage des messages : modifiez les affichages par défaut de la messagerie intégrée Firebase ou créez votre propre bibliothèque d'affichage de messages à partir de zéro.

Remarque : Ce produit n'est pas disponible sur les cibles macOS, Mac Catalyst, App Clip ou watchOS.

Modifier les affichages par défaut

La façon la plus simple de personnaliser vos messages consiste à utiliser le code d'affichage des messages par défaut de Firebase In-App Messaging.

Cloner le dépôt firebase-ios-sdk

Pour commencer, clonez la dernière version du dépôt firebase-ios-sdk et ouvrez le répertoire InAppMessaging .

Sélectionnez les types de messages à modifier

Avec le référentiel cloné, vous pouvez modifier tout ou partie des types de messages Firebase In-App Messaging : Card , Modal , Banner et ImageOnly . Chaque type correspond à une présentation de message dans le flux de création de campagne Firebase In-App Messaging.

En conséquence, chaque type a accès à un ensemble de données différent, déterminé par les options de personnalisation de la campagne dans la console Firebase :

Taper titleText le corps du texte textColor Couleur de l'arrière plan imageData bouton d'action boutonActionsecondaire
Carte
Modal
Bannière
Image uniquement

Modifier le code de rendu de l'affichage des messages

Avec les limitations de type de message à l'esprit, vous êtes libre de les modifier comme vous le souhaitez. Vous pouvez créer une bannière qui s'affiche en bas de votre application, déplacer le bouton d'action sur une fenêtre modale, intégrer le message intégré à l'application dans le flux d'un utilisateur ou toute autre modification qui rendrait les messages plus adaptés à votre application. .

Il y a deux choses principales à faire attention lors de la modification des affichages de messages :

  • Répertoires de type de message : chaque type de message possède un répertoire distinct avec des fichiers qui déterminent la logique de ce type :
  • Storyboard : la bibliothèque InAppMessaging possède également un fichier .storyboard qui aide à définir l'interface utilisateur pour les trois types de messages :

Modifiez les fichiers dans les répertoires de vos types de messages préférés et les sections correspondantes du .storyboard pour créer vos affichages de messages personnalisés.

Mettez à jour votre podfile pour utiliser votre code InAppMessaging modifié

Pour que Firebase In-App Messaging utilise vos affichages de messages modifiés au lieu des affichages par défaut, mettez à jour votre podfile pour utiliser votre bibliothèque InAppMessaging personnalisée :

# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'

target 'YourProject' do
# Comment the next line if you're not using Swift and don't want to use dynamic frameworks
use_frameworks!

# Pods for YourProject
pod 'Firebase'

# Remove the default InAppMessaging pod:
# pod 'Firebase/InAppMessaging'

# Overwrite it with a version that points to your local copy:
pod `FirebaseInAppMessaging', :path => '~/Path/To/The/Cloned/Repo/'

end
Cela fait, vous pouvez mettre à jour vos pods, reconstruire votre application et voir vos nouveaux affichages de messages personnalisés.

Créez votre propre bibliothèque d'affichage de messages

Vous n'êtes pas limité à travailler à partir de la bibliothèque InAppMessaging pour créer une interface utilisateur permettant d'afficher des messages. Vous pouvez également écrire votre propre code à partir de zéro.

Construire une classe qui implémente le protocole InAppMessagingDisplay

Firebase In-App Messaging utilise la classe InAppMessaging pour gérer les communications entre les serveurs Firebase et votre application. Cette classe, à son tour, utilise le protocole InAppMessagingDisplay pour afficher les messages qu'elle reçoit. Pour créer votre propre bibliothèque d'affichage, écrivez une classe qui implémente le protocole.

La définition du protocole et la documentation sur la manière de s'y conformer se trouvent dans le fichier FIRInAppMessagingDisplay.h de la bibliothèque InAppMessaging .

Définissez messageDisplayComponent pour utiliser votre bibliothèque d'affichage de messages

InAppMessaging utilise sa propriété messageDisplayComponent pour déterminer quel objet utiliser lors de l'affichage des messages. Définissez cette propriété sur un objet de votre classe d'affichage de message personnalisée, afin que Firebase In-App Messaging sache utiliser votre bibliothèque pour afficher les messages :

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance