Integração do cartão de conteúdo

Este artigo de referência aborda a integração do Content Card e os diferentes modelos de dados e propriedades específicas do cartão disponíveis para seu aplicativo Swift. Quando estiver pronto para começar a implementação e a personalização, consulte o Guia de personalização do cartão de conteúdo.

Sobre a integração

A interface padrão dos cartões de conteúdo pode ser integrada a partir da biblioteca BrazeUI do SDK da Braze. Crie o controlador de visualização Content Cards usando a instância braze. Se quiser interceptar e reagir ao ciclo de vida da interface do usuário do Content Card, implemente BrazeContentCardUIViewControllerDelegate como o delegado de seu BrazeContentCardUI.ViewController.

A biblioteca BrazeUI do Swift SDK apresenta dois contextos de controle de exibição padrão: navegação ou modal. Isso significa que você pode integrar os cartões de conteúdo nesses contextos adicionando algumas linhas de código ao seu app ou site. Ambas as visualizações oferecem opções de personalização e estilo, conforme descrito no guia de personalização. Você também pode criar um controlador de visualização de cartão de conteúdo personalizado em vez de usar o controlador padrão do Braze para ter ainda mais opções de personalização - consulte o tutorial Content Cards UI para obter um exemplo.

Contexto de navegação

Um navigation controller é um view controller que gerencia um ou mais child view controllers em uma interface de navegação. Veja um exemplo de como inserir uma instância BrazeContentCardUI.ViewController em um navigation controller:

• swift
• objective 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];
}

Contexto modal

Use apresentações modais para criar interrupções temporárias no fluxo de trabalho do seu app, como solicitar informações importantes ao usuário. Essa visualização de modelo tem uma barra de navegação na parte superior e um botão Concluído na lateral da barra. Veja um exemplo de como inserir uma instância BrazeContentCard.ViewController em um modal controller:

• swift
• objective 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];
}

Para obter um exemplo de uso dos controladores de visualização BrazeUI, confira as amostras correspondentes da interface do usuário dos cartões de conteúdo em nosso app Examples.

Modelo de dados dos cartões de conteúdo

O modelo de dados dos cartões de conteúdo está disponível no módulo BrazeKit para o iOS Swift SDK.

O Braze oferece cinco tipos de cartão de conteúdo: somente imagem, imagem com legenda, clássico, imagem clássica e controle. Cada tipo é uma implementação do tipo Braze.ContentCard. Observe que BrazeKit oferece uma classe ContentCardRaw alternativa para compatibilidade com Objective C.

Para obter uma lista completa das propriedades de cartões de conteúdo, bem como detalhes sobre o uso de cartões de conteúdo, consulte a documentação da classeContentCard.

Para acessar o modelo de dados dos cartões de conteúdo, chame contentCards.cards em sua instância braze. Consulte Análise de registros para saber mais sobre a assinatura de dados de cartões.

Métodos do cartão

Cada cartão é inicializado com um objeto Context, que contém vários métodos para gerenciar o estado do cartão. Chame esses métodos quando quiser modificar a propriedade de estado correspondente em um objeto de cartão específico.

Para saber mais, consulte a Contextdocumentação de referência da classe