Modifier le comportement des messages de messagerie dans l'application Firebase


Avec peu ou pas d'effort de codage, la messagerie dans l'application Firebase vous permet de créer, de configurer et de cibler des interactions utilisateur riches, en exploitant les fonctionnalités prêtes à l'emploi de Google Analytics pour associer les événements de messagerie aux caractéristiques, activités et choix réels des utilisateurs. Avec une intégration supplémentaire du SDK Firebase In-App Messaging, vous pouvez adapter encore plus le comportement des messages dans l'application, en répondant lorsque les utilisateurs interagissent avec les messages, en déclenchant des événements de message en dehors du framework Analytics et en permettant aux utilisateurs de contrôler le partage de leurs données personnelles liées aux interactions de messagerie.

Répondre lorsque les utilisateurs interagissent avec des messages dans l'application

Grâce aux actions, vous pouvez utiliser vos messages dans l'application pour rediriger les utilisateurs vers un site Web ou un écran spécifique de votre application.

Votre code peut répondre aux interactions de base (clics et refus), aux impressions (vues validées de vos messages) et afficher les erreurs consignées et confirmées par le SDK. Par exemple, lorsque votre message est composé sous forme de fenêtre modale de carte, vous pouvez suivre et vérifier sur laquelle des deux URL l'utilisateur a cliqué sur la carte.

Implémenter un DisplayDelegate pour gérer les interactions avec la fiche

Vous pouvez enregistrer un délégué d'affichage de messages dans l'application qui sera appelé chaque fois qu'il y aura une interaction avec un message dans l'application. Pour ce faire, implémentez une classe conformément au protocole InAppMessagingDisplayDelegate et définissez-la comme propriété de délégué sur l'instance InAppMessaging.

En supposant à nouveau que vous souhaitez suivre le lien sur lequel un utilisateur a cliqué dans un message de style carte, définissez une classe qui implémente la méthode messageClicked conformément au protocole DisplayDelegate, ce qui vous permet d'accéder au lien sur lequel l'utilisateur a cliqué.

Swift

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

Reportez-vous à la documentation de référence sur le délégué d'affichage Swift pour connaître l'ensemble des méthodes de rappel pouvant être implémentées et leurs paramètres, y compris InAppMessagingAction.


// In CardActionFiamDelegate.swift
class CardActionFiamDelegate : NSObject, InAppMessagingDisplayDelegate {

    func messageClicked(_ inAppMessage: InAppMessagingDisplayMessage) {
        // ...
    }

    func messageDismissed(_ inAppMessage: InAppMessagingDisplayMessage,
                          dismissType: FIRInAppMessagingDismissType) {
        // ...
    }

    func impressionDetected(for inAppMessage: InAppMessagingDisplayMessage) {
        // ...
    }

    func displayError(for inAppMessage: InAppMessagingDisplayMessage, error: Error) {
        // ...
    }

}

// In AppDelegate.swift
// Register the delegate with the InAppMessaging instance
let myFiamDelegate = CardActionFiamDelegate()
InAppMessaging.inAppMessaging().delegate = myFiamDelegate;

Objective-C

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

Consultez la documentation de référence sur le délégué d'affichage Objective-C pour connaître l'ensemble des méthodes de rappel pouvant être implémentées et leurs paramètres, y compris FIRInAppMessagingDisplayMessage.


// In CardActionFiamDelegate.h
@interface CardActionFiamDelegate : NSObject <FIRInAppMessagingDisplayDelegate>
@end

// In CardActionFiamDelegate.m
@implementation CardActionFiamDelegate

- (void)displayErrorForMessage:(nonnull FIRInAppMessagingDisplayMessage *)inAppMessage
                         error:(nonnull NSError *)error {
    // ...
}

- (void)impressionDetectedForMessage:(nonnull FIRInAppMessagingDisplayMessage *)inAppMessage {
    // ...
}

- (void)messageClicked:(nonnull FIRInAppMessagingDisplayMessage *)inAppMessage {
    // ...
}

- (void)messageDismissed:(nonnull FIRInAppMessagingDisplayMessage *)inAppMessage
             dismissType:(FIRInAppMessagingDismissType)dismissType {
    // ...
}

@end

// In AppDelegate.m
CardActionFiamDelegate *myFiamDelegate = [CardActionFiamDelegate new];
[FIRInAppMessaging inAppMessaging].delegate = myFiamDelegate;

Déclencher des messages dans l'application de manière programmatique

Par défaut, Firebase In-App Messaging vous permet de déclencher des messages dans l'application avec des événements Google Analytics pour Firebase, sans intégration supplémentaire. Vous pouvez également déclencher manuellement des événements par programmation avec les déclencheurs programmatiques du SDK Firebase In-App Messaging.

Dans l'outil de création de campagnes de messages dans l'application, créez une campagne ou sélectionnez-en une. À l'étape de planification du workflow de l'outil de création, notez l'ID d'un événement de messagerie créé ou existant. Une fois cette information notée, instrumentez votre application pour déclencher l'événement par son ID.

Swift

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

// somewhere in the app's code
InAppMessaging.inAppMessaging().triggerEvent("exampleTrigger");

Objective-C

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

// somewhere in the app's code
[[FIRInAppMessaging inAppMessaging] triggerEvent:@"exampleTrigger"];

Utiliser des métadonnées personnalisées de campagne

Dans vos campagnes, vous pouvez spécifier des données personnalisées dans une série de paires clé/valeur. Lorsque les utilisateurs interagissent avec des messages, vous pouvez utiliser ces données pour afficher, par exemple, un code promotionnel.

Swift

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

    func messageClicked(_ inAppMessage: InAppMessagingDisplayMessage) {
	// Get data bundle from the inapp message
	let appData = inAppMessage.appData
	// ...
    }
}

Objective-C

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

- (void)messageClicked:(nonnull FIRInAppMessagingDisplayMessage *)inAppMessage {
	appData = inAppMessage.appData
	// ...
}

@end

Désactiver temporairement les messages dans l'application

Par défaut, Firebase In-App Messaging affiche des messages chaque fois qu'une condition de déclenchement est remplie, quel que soit l'état actuel de l'application. Si vous souhaitez supprimer l'affichage des messages pour une raison quelconque, par exemple pour éviter d'interrompre une séquence d'écrans de traitement des paiements, utilisez la propriété messageDisplaySuppressed du SDK, comme illustré ici en Objective-C:

  [FIRInAppMessaging inAppMessaging].messageDisplaySuppressed = YES;

Définir la propriété sur YES empêche Firebase In-App Messaging d'afficher des messages, tandis que NO réactive l'affichage des messages. Le SDK réinitialise la propriété sur NO au redémarrage de l'application. Les messages supprimés sont ignorés par le SDK. Leurs conditions de déclenchement doivent être remplies à nouveau lorsque la suppression est désactivée, avant que Firebase In-App Messaging puisse les afficher.

Activer la diffusion des messages nécessitant une confirmation de désactivation

Par défaut, Firebase In-App Messaging envoie automatiquement des messages à tous les utilisateurs de l'application que vous ciblez dans les campagnes de messages. Pour envoyer ces messages, le SDK Firebase In-App Messaging utilise des ID d'installation Firebase pour identifier l'application de chaque utilisateur. Cela signifie que In-App Messaging doit envoyer des données client, associées à l'ID d'installation, aux serveurs Firebase. Si vous souhaitez donner aux utilisateurs plus de contrôle sur les données qu'ils envoient, désactivez la collecte automatique des données et leur donnez la possibilité d'approuver le partage des données.

Pour ce faire, vous devez désactiver l'initialisation automatique pour Firebase In-App Messaging et initialiser le service manuellement pour les utilisateurs qui l'ont activé:

  1. Désactivez l'initialisation automatique avec une nouvelle clé dans votre fichier Info.plist:

    • Clé : FirebaseInAppMessagingAutomaticDataCollectionEnabled
    • Valeur : NO
  2. Initialisez Firebase In-App Messaging manuellement pour les utilisateurs sélectionnés:

    // Only needed if FirebaseInAppMessagingAutomaticDataCollectionEnabled is set to NO
    // in Info.plist
    [FIRInAppMessaging inAppMessaging].automaticDataCollectionEnabled = YES;
    
    

    Une fois que vous avez défini automaticDataCollectionEnabled sur YES, la valeur persiste lors des redémarrages de l'application, remplaçant la valeur dans votre Info.plist. Si vous souhaitez désactiver à nouveau l'initialisation, par exemple si un utilisateur désactive la collecte ultérieurement, définissez la propriété sur NO.