Intégration d’une carte de contenu

Cet article de référence traite de l’intégration de la carte de contenu et des différents modèles de données et propriétés spécifiques à la carte disponibles pour votre application Swift. Lorsque vous êtes prêt à vous lancer dans la mise en œuvre et la personnalisation, consultez le Guide de personnalisation des cartes de contenu.

À propos de l’intégration

L’interface utilisateur par défaut des cartes de contenu peut être intégrée à partir de la bibliothèque BrazeUI du SDK Braze. Créez le contrôleur de vue des cartes de contenu en utilisant l’instance braze. Si vous souhaitez intercepter le cycle de vie de l’interface utilisateur de la carte de contenu et y réagir, implémentez BrazeContentCardUIViewControllerDelegate en tant que délégué pour votre BrazeContentCardUI.ViewController.

La bibliothèque BrazeUI du SDK Swift propose deux contextes de contrôleur de vue par défaut : navigation ou fenêtre modale. Cela signifie que vous pouvez intégrer les cartes contenu dans ces contextes en ajoutant quelques lignes de code à votre app ou site. Les deux vues offrent des options de personnalisation et de style décrites dans le guide de personnalisation. Vous pouvez également créer un contrôleur de vue de cartes de contenu personnalisé au lieu d’utiliser le contrôleur de vue standard de Braze pour bénéficier d’encore plus d’options de personnalisation. Reportez-vous au tutoriel sur l’interface utilisateur des cartes de contenu pour voir un exemple.

Contexte de navigation

Un contrôleur de navigation est un contrôleur de vue qui gère un ou plusieurs contrôleurs de vue enfant dans une interface de navigation. Voici un exemple d’introduction d’une instance de BrazeContentCardUI.ViewController dans un contrôleur de navigation :

• swift
• objectif-c

1
2
3
4
5
6
7
func pushViewController() {
  guard let braze = AppDelegate.braze else { return }
  let contentCardsController = BrazeContentCardUI.ViewController(braze: braze)
  // Implement and set `BrazeContentCardUIViewControllerDelegate` if you wish to intercept click actions.
  contentCardsController.delegate = self
  self.navigationController?.pushViewController(contentCardsController, animated: true)
}

1
2
3
4
5
6
- (void)pushViewController {
  BRZContentCardUIViewController *contentCardsController = [[BRZContentCardUIViewController alloc] initWithBraze:self.braze];
  // Implement and set `BrazeContentCardUIViewControllerDelegate` if you wish to intercept click actions.
  [contentCardsController setDelegate:self];
  [self.navigationController pushViewController:contentCardsController animated:YES];
}

Contexte modal

Utilisez les présentations modales pour créer des interruptions temporaires dans le flux de travail de votre application, par exemple en demandant à l’utilisateur de fournir des informations importantes. Cette vue modèle comporte une barre de navigation en haut et un bouton Terminé sur le côté de la barre. Voici un exemple d’insertion d’une instance de BrazeContentCard.ViewController dans un contrôleur modal :

• swift
• objectif-c

1
2
3
4
5
6
7
func presentModalViewController() {
  guard let braze = AppDelegate.braze else { return }
  let contentCardsModal = BrazeContentCardUI.ModalViewController(braze: braze)
  // Implement and set `BrazeContentCardUIViewControllerDelegate` if you wish to intercept click actions.
  contentCardsModal.viewController.delegate = self
  self.navigationController?.present(contentCardsModal, animated: true, completion: nil)
}

1
2
3
4
5
6
- (void)presentModalViewController {
  BRZContentCardUIModalViewController *contentCardsModal = [[BRZContentCardUIModalViewController alloc] initWithBraze:AppDelegate.braze];
  // Implement and set `BrazeContentCardUIViewControllerDelegate` if you wish to intercept click actions.
  [contentCardsModal.viewController setDelegate:self];
  [self.navigationController presentViewController:contentCardsModal animated:YES completion:nil];
}

Pour un exemple d’utilisation des contrôleurs de vue BrazeUI, consultez les exemples d’interface utilisateur des cartes de contenu correspondants dans notre application Exemples.

Modèle de données de cartes de contenu

Le modèle de données des cartes de contenu est disponible dans le module BrazeKit du SDK Swift pour iOS.

Braze propose cinq types de cartes de contenu : image seule, image légendée, classique, image classique et contrôle. Chaque type est une implémentation du type Braze.ContentCard. Notez que BrazeKit propose une classe ContentCardRaw alternative pour la compatibilité avec Objective-C.

Pour obtenir une liste complète des propriétés des cartes de contenu, ainsi que des détails sur l’utilisation des cartes de contenu, reportez-vous à la documentation de classe ContentCard.

Pour accéder au modèle de données des cartes de contenu, appelez contentCards.cards sur votre instance braze. Voir Enregistrer les analyses pour plus d’informations sur l’abonnement aux données de cartes.

Méthodes de carte

Chaque carte est initialisée avec un objet Context, qui contient diverses méthodes pour gérer l’état de votre carte. Appelez ces méthodes lorsque vous souhaitez modifier la propriété d’état correspondante d’un objet de carte particulier.

Pour plus de détails, reportez-vous à la documentation de la classeContext