AppboyKit (également connu sous le nom de SDK Objective-C) n’est plus pris en charge et a été remplacé par Swift SDK. Il ne recevra plus de nouvelles fonctionnalités, de corrections de bugs, de mises à jour de sécurité ou d’assistance technique - cependant, la messagerie et l’analyse continueront à fonctionner normalement. Pour en savoir plus, consultez Présentation du nouveau SDK Braze Swift.
Cas d’utilisation : Vue carrousel
Cette section couvre l’implémentation d’un flux de carrousel multi-cartes dans lequel un utilisateur peut faire glisser horizontalement pour afficher des cartes en vedette supplémentaires. Pour intégrer une vue carrousel, vous devrez utiliser une carte de contenu entièrement personnalisée - la phase d’exécution de l ‘approche “crawl, walk, run” (ramper, marcher, courir).
Avec cette approche, vous n’utiliserez pas les vues et la logique par défaut de Braze, mais afficherez les cartes de contenu de manière totalement personnalisée en utilisant vos propres vues alimentées par les données des modèles Braze.
En termes de niveau d’effort de développement, les différences clés entre l’implémentation de base et celle du carrousel comprennent :
- Créer vos propres vues
- Enregistrer les indicateurs des performances de contenu
- Introduire une logique additionnelle côté client pour dicter combien et quelles cartes afficher dans le carrousel
Mise en œuvre
Étape 1 : Créer un contrôleur de visualisation personnalisé
Pour créer le carrousel de cartes de contenu, créez votre propre contrôleur de vue personnalisé (tel que UICollectionViewController) et abonnez-vous aux mises à jour des données. Notez que vous ne pourrez ni étendre ni sous-classer notre ABKContentCardTableViewController par défaut, car il est uniquement capable de gérer nos types de cartes de contenu par défaut.
Étape 2 : Mettre en œuvre les analyses
Lors de la création d’un contrôleur de vue entièrement personnalisé, les impressions, les clics et les rejets de cartes de contenu ne sont pas automatiquement enregistrés. Vous devez mettre en œuvre les méthodes d’analyse correspondantes pour vous assurer que les impressions, les événements de renvoi et les clics sont correctement enregistrés dans les analyses du tableau de bord de Braze.
Pour plus d’informations sur les méthodes d’analyse, reportez-vous aux méthodes de carte.
La même page détaille également les différentes propriétés héritées de notre classe de modèle de carte de contenu générique, que vous pouvez trouver utile pendant l’implémentation de votre vue.
Étape 3 : Créer un observateur de carte de contenu
Créez un observateur de cartes de contenu chargé de gérer l’arrivée des cartes de contenu et mettez en œuvre une logique conditionnelle pour afficher un nombre spécifique de cartes dans le carrousel à tout moment. Par défaut, les cartes de contenu sont triées par date de création (la plus récente en premier) et un utilisateur voit toutes les cartes auxquelles il est éligible.
Cela dit, vous pouvez commander et appliquer une logique d’affichage supplémentaire de différentes manières. Par exemple, vous pouvez sélectionner les cinq premiers objets de carte de contenu du tableau ou introduire des paires clé-valeur (la propriété extras dans le modèle de données) pour concevoir une logique conditionnelle.
Si vous implémentez un carrousel comme flux secondaire de cartes de contenu, reportez-vous à la section Utilisation de plusieurs flux de cartes de contenu pour vous assurer que vous triez les cartes dans le flux approprié en fonction des paires clé-valeur.
Il est important de veiller à ce que vos équipes de marketing et de développement se coordonnent sur les paires clé-valeur qui seront utilisées (par exemple, feed_type = brand_homepage), car toutes les paires clé-valeur saisies par les marketeurs dans le tableau de bord de Braze doivent correspondre exactement aux paires clé-valeur que les développeurs créent dans la logique de l’application.
Pour obtenir la documentation pour développeurs spécifique à iOS sur la classe, les méthodes et les attributs des cartes de contenu, reportez-vous à la référence de la classe ABKContentCard pour iOS.
Considérations
- En utilisant des vues entièrement personnalisées, vous ne pourrez pas étendre ou sous-classer les méthodes utilisées dans
ABKContentCardsController. Vous devrez à la place intégrer les méthodes et les propriétés du modèle de données vous-même. - La logique et l’implémentation de la vue carrousel ne sont pas un type par défaut de carte de contenu dans Braze. Par conséquent la logique d’obtention du cas d’usage doit être fournie et prise en charge par votre équipe de développement.
- Vous devrez implémenter la logique côté client pour afficher un nombre spécifique de cartes dans le carrousel à tout moment.