Intégration d’une carte de contenu
Cet article explique comment paramétrer des cartes de contenu pour votre application Flutter.
Le SDK Braze comprend un flux de cartes par défaut pour vous permettre de vous lancer dans les cartes de contenu. Pour afficher le flux de carte, vous pouvez utiliser la méthode braze.launchContentCards()
. Le flux de cartes par défaut inclus avec le SDK Braze traitera tous les suivis, les masquages et le rendu des cartes de contenu d’un utilisateur.
Personnalisation
Vous pouvez utiliser ces méthodes supplémentaires pour créer un flux de cartes de contenu personnalisé dans votre application en utilisant les méthodes suivantes disponibles sur l’interface publique du plugin:
Méthode | Description |
---|---|
braze.requestContentCardsRefresh() |
Demande les dernières cartes de contenu au serveur Braze SDK. |
braze.logContentCardClicked(contentCard) |
Enregistre un clic pour l’objet de carte de contenu donné. |
braze.logContentCardImpression(contentCard) |
Enregistre une impression pour l’objet de carte de contenu donné. |
braze.logContentCardDismissed(contentCard) |
Enregistre un abandon pour l’objet de carte de contenu donné. |
Réception des données de cartes de contenu
Pour recevoir des données de cartes de contenu dans votre application Flutter, le BrazePlugin
prend en charge l’envoi de données de cartes de contenu à l’aide de Dart Streams.
L’objet BrazeContentCard
prend en charge un sous-ensemble de champs disponibles dans les objets du modèle natif, y compris description
, title
, image
, url
, extras
et plus encore.
Étape 1 : Écoutez les données de la carte de contenu dans la couche Dart
Pour recevoir les données de cartes de contenu dans la couche Dart, utilisez le code ci-dessous pour créer un StreamSubscription
et appeler braze.subscribeToContentCards()
. N’oubliez pas de cancel()
l’abonnement au flux lorsqu’il n’est plus nécessaire.
1
2
3
4
5
6
7
8
9
// Create stream subscription
StreamSubscription contentCardsStreamSubscription;
contentCardsStreamSubscription = braze.subscribeToContentCards((List<BrazeContentCard> contentCards) {
// Handle Content Cards
}
// Cancel stream subscription
contentCardsStreamSubscription.cancel();
Consultez main.dart dans notre exemple d’application.
Étape 2 : Transférer les données de la carte de contenu depuis la couche native
Pour recevoir les données dans la couche Dart à partir de l’étape 1, ajoutez le code suivant pour transférer les données de la carte de contenu des couches natives.
Les données de la carte de contenu sont automatiquement transférées depuis la couche Android.
-
Implémentez
contentCards.subscribeToUpdates
pour vous abonner aux mises à jour des cartes de contenu comme décrit dans la documentation subscribeToUpdates. -
Votre implémentation de fonction de rappel
contentCards.subscribeToUpdates
doit appelerBrazePlugin.processContentCards(contentCards)
.
Consultez AppDelegate.swift dans notre exemple d’application.
Rejouer la fonction de rappel pour les cartes de contenu
Pour enregistrer n’importe quelle carte de contenu déclenchée avant que la fonction de rappel soit disponible et la rejouer une fois qu’elle est définie, ajoutez l’entrée suivante à la map customConfigs
lors de l’initialisation du BrazePlugin
:
1
BrazePlugin braze = new BrazePlugin(customConfigs: {replayCallbacksConfigKey: true});
Test affichant l’exemple de carte de contenu
Suivez ces étapes pour tester un exemple de carte de contenu.
- Définissez un utilisateur actif dans l’application React en appelant la méthode
braze.changeUserId('your-user-id')
. - Accédez à Campagnes et suivez ce guide pour créer une nouvelle campagne de Carte de Contenu.
- Composez votre campagne de cartes de contenu de test et accédez à l’onglet Test. Ajoutez le même
user-id
que l’utilisateur test et cliquez sur Envoyer le test. - Appuyez sur la notification push qui devrait lancer une carte de contenu sur votre appareil. Il se peut que vous deviez actualiser votre flux pour qu’elle s’affiche.
Pour plus de détails sur chaque plateforme, suivez les guides d’intégration Android ou d’intégration iOS.
Support GIF
By default, the native Braze Android SDK does not provide animated GIF support for Content Cards—however, you can use a third-party image library to display GIFs instead. For more information, see Android Content Cards: GIFs.
By default, the Braze Swift SDK does not provide animated GIF support for Content Cards—however, you can wrap your own view or a third-party view in an instance of GIFViewProvider
. For a full walkthrough, see Tutorial: GIF Support for Swift Content Cards.