Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Personnalisez vos messages de messagerie Firebase In-App

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 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, lisez Créer dynamique Liens 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 à la messagerie In-App , et commencer une nouvelle campagne ou modifier une campagne existante. Dans cette campagne, fournir une carte, le texte du bouton et l' action du bouton, une action d'image, ou une action bannière, où l'action est un lien profond pertinent.

Le format de l'action dépend de la mise en page du message que vous choisissez. Les modaux obtiennent des boutons d'action avec un contenu de texte de bouton, une couleur de texte et une couleur d'arrière-plan personnalisables. Les images et les bannières supérieures, en revanche, deviennent interactives et invoquent l'action spécifiée lorsque vous appuyez dessus.

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 affiche la disposition des messages, les styles de police, les formes des boutons et d'autres détails. Il existe deux manières de modifier les affichages des messages : modifiez les affichages par défaut de la messagerie Firebase In-App ou créez votre propre bibliothèque d'affichage des messages à partir de zéro.

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.

Clone du firebase-ios-sdk repo

Pour commencer, cloner la dernière version du firebase-ios-sdk repo, et ouvrez le répertoire InAppMessaging .

Sélectionnez les types de messages à modifier

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

Par conséquent, 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 titreTexte le corps du texte textCouleur Couleur de l'arrière plan imageData bouton d'action Bouton d'action secondaire
Carte
Modal
Bannière
Image seule

Modifier le code de rendu de l'affichage du message

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

Il y a deux points principaux à prendre en compte lors de la modification des affichages de messages :

  • Répertoires de type de message: Chaque type de message a un répertoire distinct avec les fichiers qui déterminent la logique de ce type:
  • Storyboard: La InAppMessaging bibliothèque dispose également d' un .storyboard fichier qui permet de définir l'interface utilisateur pour les trois types de messages:

Modifier 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 écrans de messages personnalisés.

Mettez à jour votre PODFILE utiliser votre modification InAppMessaging Code

Pour obtenir Firebase In-App Messaging pour utiliser votre message modifié affiche au lieu de l'affichage par défaut, mettez à jour votre PODFILE utiliser votre personnalisé InAppMessaging bibliothèque:

# 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 votre nouveau message personnalisé s'afficher.

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

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

Construire une classe qui implémente le InAppMessagingDisplay protocole

Firebase In-App Messaging utilise la InAppMessaging classe pour les communications entre les serveurs poignée Firebase et votre application. Cette classe, à son tour, utilise le InAppMessagingDisplay protocole pour afficher les messages qu'il 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 de la documentation sur la façon de s'y conformer sont dans le FIRInAppMessagingDisplay.h fichier de la InAppMessaging bibliothèque.

Set messageDisplayComponent utiliser votre bibliothèque d'affichage des messages

InAppMessaging utilise sa messageDisplayComponent propriété pour déterminer l'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