Intégration du fil d’actualité

Cet article de référence couvre différents types de cartes de fil d’actualité, les différentes propriétés spécifiques à la carte disponibles et un exemple d’intégration personnalisé pour votre application Android ou FireOS.

Sous Android, le fil d’actualité est mis en œuvre sous la forme d’un fragment disponible dans le projet Android UI de Braze. Reportez-vous à la documentation de Google sur les fragmentsAndroid pour obtenir des informations sur l’ajout d’un fragment à une activité.

La classe BrazeFeedFragment se rafraîchira automatiquement, affichera le contenu du fil d’actualité et enregistrera l’analyse d’utilisation. Les cartes qui peuvent apparaître dans le fil d’actualité d’un utilisateur sont définies sur le tableau de bord de Braze.

Types de cartes

Braze possède cinq types de cartes uniques : image de bannière, image sous-titrée, annonce textuelle et actualités courtes. 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 base

Le modèle de carte de base fournit un comportement fondamental pour toutes les cartes.

Propriétés de la carte image de bannière

Les cartes-images des bannières sont des images cliquables en taille réelle.

Propriétés de carte image sous-titrée

Les cartes d’images légendées sont des images cliquables en taille réelle accompagnées d’un texte descriptif.

Propriétés de la carte d’annonce textuelle (image sous-titrée sans image)

Les cartes d’annonce textuelles sont des cartes cliquables contenant un texte descriptif.

Propriétés de la carte d’actualités courtes

Les cartes d’actualités courtes sont des cartes cliquables contenant des images et un texte descriptif.

Analytique de session

Les fragments d’IU Android ne suivent pas automatiquement les analyses de session. Pour vous assurer que les sessions font l’objet d’un suivi approprié, appelez IBraze.openSession() lorsque votre application est ouverte.

Liaison

La liaison au fil d’actualité à partir d’un message in-app doit être activée en enregistrant le BrazeFeedActivity dans votre AndroidManifest.xml.

Intégration de fil personnalisé

Si vous souhaitez afficher le flux de manière totalement personnalisée, il est possible de le faire en utilisant vos propres vues alimentées par les données de nos modèles. Pour obtenir des modèles de fil d’actualité, vous devrez vous abonner aux mises à jour du fil d’actualité et utiliser les données du modèle résultant pour alimenter vos vues. Vous devrez également enregistrer l’analyse des objets du modèle lorsque les utilisateurs interagissent avec vos vues.

Partie 1 : S’abonner aux mises à jour du fil

Tout d’abord, déclarez une variable privée dans votre classe de fil personnalisée pour contenir votre abonné :

1
2
// subscriber variable
private IEventSubscriber<FeedUpdatedEvent> mFeedUpdatedSubscriber;

Ensuite, ajoutez le code suivant pour vous abonner aux mises à jour de fil d’actualité de Braze, généralement à l’intérieur de vos activités de fil personnalisé Activity.onCreate() :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// Remove the old subscription first
Braze.getInstance(context).removeSingleSubscription(mFeedUpdatedSubscriber, FeedUpdatedEvent.class);
mFeedUpdatedSubscriber = new IEventSubscriber<FeedUpdatedEvent>() {
  @Override
  public void trigger(final FeedUpdatedEvent event) {
    // This list of Card objects included in the FeedUpdatedEvent should be used to populate your News Feed views.
    List<Card> cards = event.getFeedCards();
    // your logic here
  }
};
Braze.getInstance(context).subscribeToFeedUpdates(mFeedUpdatedSubscriber);

// Request a refresh of feed data
Braze.getInstance(context).requestFeedRefresh();

Nous vous recommandons également de vous désabonner lorsque votre activité personnalisée n’est plus visible. Ajoutez le code suivant à la méthode de cycle de vie onDestroy() de votre activité :

1
Braze.getInstance(context).removeSingleSubscription(mFeedUpdatedSubscriber, FeedUpdatedEvent.class);

Partie 2 : Enregistrer les analyses

Lorsque vous utilisez des vues personnalisées, vous devez enregistrer manuellement l’analyse, car elle ne peut être gérée automatiquement que lorsque vous utilisez des vues Braze.

Pour enregistrer un affichage du flux, appelez Braze.logFeedDisplayed().

Pour enregistrer une impression ou cliquer sur une carte, appelez le Card.logClick() et Card.logImpression() respectivement.