Intégration d’une carte de contenu
Cet article explique comment paramétrer des cartes de contenu pour React Native.
Les SDK Braze incluent un flux de cartes par défaut pour vous permettre de démarrer avec 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
Pour créer votre propre interface utilisateur, vous pouvez obtenir une liste des cartes disponibles et écouter des mises à jour des cartes :
1
2
3
4
5
6
7
8
9
10
11
// Set initial cards
const [cards, setCards] = useState([]);
// Listen for updates as a result of card refreshes, such as:
// a new session, a manual refresh with `requestContentCardsRefresh()`, or after the timeout period
Braze.addListener(Braze.Events.CONTENT_CARDS_UPDATED, async (update) => {
setCards(update.cards);
});
// Manually trigger a refresh of cards
Braze.requestContentCardsRefresh();
Si vous choisissez de créer votre propre interface utilisateur, vous devez appeler logContentCardImpression
pour recevoir des analyses pour ces cartes. Ceci inclut les cartes control
, qui doivent faire l’objet d’un suivi même si elles ne sont pas affichées pour l’utilisateur.
Vous pouvez utiliser ces méthodes supplémentaires pour créer un flux de cartes de contenu personnalisé dans votre application :
Méthode | Description |
---|---|
launchContentCards() |
Lance l’élément d’interface utilisateur Cartes de contenu. |
requestContentCardsRefresh() |
Demande les dernières cartes de contenu au serveur Braze SDK. La liste de cartes qui en résulte est transmise à chacun des récepteurs d’événements de carte de contenu précédemment enregistrés. |
getContentCards() |
Récupère les cartes de contenu du SDK Braze Ceci renvoie une promesse qui se résout avec la dernière liste de cartes du serveur. |
getCachedContentCards() |
Renvoie le tableau de cartes de contenu le plus récent du cache. |
logContentCardClicked(cardId) |
Enregistre un clic pour l’ID de carte de contenu donné. Cette méthode est uniquement utilisée pour les analyses. Pour exécuter l’action de clic, appelez processContentCardClickAction(cardId) en plus. |
logContentCardImpression(cardId) |
Enregistre une impression pour l’ID de carte de contenu donné. |
logContentCardDismissed(cardId) |
Enregistre un rejet pour l’ID de carte de contenu donné. |
processContentCardClickAction(cardId) |
Effectuer l’action d’une carte particulière. |
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.changeUser('your-user-id')
. - Rendez-vous dans la rubrique Campagnes et suivez ce guide pour créer une nouvelle campagne de cartes 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. Vous devriez pouvoir lancer rapidement une carte de contenu sur votre appareil.
Pour plus d’intégrations, suivez les instructions d’intégration Android ou les instructions d’intégration iOS, en fonction de votre plateforme.
Vous trouverez un exemple de mise en œuvre dans BrazeProject au sein du SDK React Native.
Modèle de données de la carte de contenu
Le modèle de données des cartes de contenu est disponible dans le SDK React Native. Pour une référence complète du modèle de données de la carte de contenu, consultez la documentation Android et iOS.
Le SDK React Native de Braze propose trois types de cartes Content Cards uniques qui partagent un modèle de base : image seule, image légendée et classique.
Il existe également un type de carte de contrôle spécial, qui est renvoyé aux utilisateurs qui font partie du groupe de contrôle pour une carte donnée.
Chaque type hérite des propriétés communes d’un modèle de base et possède les propriétés supplémentaires suivantes.
Propriétés du modèle de carte de contenu de base
Le modèle de carte de base fournit un comportement fondamental pour toutes les cartes.
Propriété | Description |
---|---|
id |
L’ID de la carte est défini par Braze. |
created |
L’horodatage UNIX du moment de création de la carte depuis Braze. |
expiresAt |
L’horodatage UNIX du moment d’expiration de la carte. Lorsque la valeur est inférieure à 0, cela signifie que la carte n’expire jamais. |
viewed |
Si la carte est lue ou non par l’utilisateur. Ceci ne permet pas d’enregistrer les analyses. |
clicked |
Si la carte a été cliquée par l’utilisateur. |
pinned |
Détermine si la carte est épinglée. |
dismissed |
Détermine si l’utilisateur a rejeté cette carte. Marquer comme rejetée une carte qui l’a déjà été n’est pas possible. |
dismissible |
Détermine si la carte peut être ou non rejetée par l’utilisateur. |
url |
(Facultatif) Chaîne de caractères URL associée à l’action de clic sur la carte. |
openURLInWebView |
Indique si les URL de cette carte doivent être ouvertes dans le WebView de Braze ou non. |
isControl |
Si cette carte est une carte de contrôle. Les cartes de contrôle ne doivent pas être montrées à l’utilisateur. |
extras |
Mappage des suppléments clé-valeur pour cette carte. |
Pour une référence complète de la carte de base, consultez la documentation Android et iOS.
Propriétés du modèle de carte de contenu pour les images uniquement
Les cartes avec image seulement sont des images cliquables en taille réelle.
Propriété | Description |
---|---|
type |
Le type de carte de contenu, IMAGE_ONLY . |
image |
L’URL de l’image de la carte. |
imageAspectRatio |
Le rapport hauteur/largeur de l’image de la carte. Il est censé servir d’indice avant que le chargement de l’image ne soit terminé. Veuillez noter que la propriété peut ne pas être fournie dans certaines circonstances. |
Pour une référence complète de la carte image seule, consultez la documentation Android et iOS.
Image légendée des propriétés du modèle de cartes de contenu
Les cartes d’images légendées sont des images cliquables en taille réelle accompagnées d’un texte descriptif.
Propriété | Description |
---|---|
type |
Le type de carte de contenu, CAPTIONED . |
image |
L’URL de l’image de la carte. |
imageAspectRatio |
Le rapport hauteur/largeur de l’image de la carte. Il est censé servir d’indice avant que le chargement de l’image ne soit terminé. Veuillez noter que la propriété peut ne pas être fournie dans certaines circonstances. |
title |
Le texte du titre pour la carte. |
cardDescription |
Texte de description de la carte. |
domain |
(Facultatif) Texte du lien pour l’URL de propriété, par exemple, "braze.com/resources/" . Il peut être affiché sur l’interface utilisateur de la carte pour indiquer l’action/la direction du clic sur la carte. |
Pour une référence complète de la carte d’image sous-titrée, consultez la documentation Android et iOS.
Propriétés du modèle de carte de contenu classique
Les cartes classiques comportent un titre, une description et une image facultative à gauche du texte.
Propriété | Description |
---|---|
type |
Le type de carte de contenu, CLASSIC . |
image |
(Facultatif) L’URL de l’image de la carte. |
title |
Le texte du titre pour la carte. |
cardDescription |
Texte de description de la carte. |
domain |
(Facultatif) Texte du lien pour l’URL de propriété, par exemple, "braze.com/resources/" . Il peut être affiché sur l’interface utilisateur de la carte pour indiquer l’action/la direction du clic sur la carte. |
Pour une référence complète de la carte de contenu classique (annonce textuelle), consultez la documentation Android et iOS. Pour une référence complète de la carte d’image classique (courte nouvelle), consultez la documentation Android et iOS.
Propriétés du modèle de carte de contenu de contrôle
Les cartes de contrôle incluent toutes les propriétés de base, avec quelques différences importantes. Et surtout :
- La propriété
isControl
est garantietrue
. - La propriété
extras
est garantie vide.
Pour une référence complète de la carte de contrôle, consultez la documentation Android et 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.