integração do cartão de conteúdo
Este artigo aborda como configurar os cartões de conteúdo para seu app Flutter.
O SDK da Braze inclui um feed de cartão padrão para você começar com os Cartões de Conteúdo. Para mostrar o feed do cartão, você pode usar o método braze.launchContentCards()
. O feed de cartão padrão incluído com o SDK da Braze lidará com toda a análise de dados, rastreamento, dispensas e renderização para os cartões de conteúdo de um usuário.
Personalização
Você pode usar esses métodos adicionais para criar um feed de cartões de conteúdo personalizado em seu app usando os seguintes métodos disponíveis na interface pública do plug-in:
Método | Descrição |
---|---|
braze.requestContentCardsRefresh() |
Solicita os cartões de conteúdo mais recentes do servidor SDK da Braze. |
braze.logContentCardClicked(contentCard) |
Registra um clique para o objeto do cartão de conteúdo fornecido. |
braze.logContentCardImpression(contentCard) |
Registra uma impressão para o objeto de cartão de conteúdo fornecido. |
braze.logContentCardDismissed(contentCard) |
Registra uma dispensa para o objeto do cartão de conteúdo fornecido. |
Recebimento de dados do cartão de conteúdo
Para receber dados de cartões de conteúdo em seu app Flutter, o BrazePlugin
é compatível com o envio de dados de cartões de conteúdo usando o Dart Streams.
O objeto BrazeContentCard
é compatível com um subconjunto de campos disponíveis nos objetos do modelo nativo, incluindo , description
, title
, image
, url
, extras
, entre outros.
Etapa 1: Ouça os dados do cartão de conteúdo na camada Dart
Para receber os dados do cartão de conteúdo na camada Dart, use o código abaixo para criar um StreamSubscription
e chamar braze.subscribeToContentCards()
. Lembre-se de cancel()
a inscrição de fluxo quando ela não for mais necessária.
1
2
3
4
5
6
7
8
9
// Create stream subscription
StreamSubscription contentCardsStreamSubscription;
contentCardsStreamSubscription = braze.subscribeToContentCards((List<BrazeContentCard> contentCards) {
// Handle Content Cards
}
// Cancel stream subscription
contentCardsStreamSubscription.cancel();
Para obter um exemplo, consulte main.dart em nosso app de amostra.
Etapa 2: Encaminhar dados do cartão de conteúdo da camada nativa
Para receber os dados na camada Dart da etapa 1, adicione o seguinte código para encaminhar os dados do cartão de conteúdo das camadas nativas.
Os dados do cartão de conteúdo são encaminhados automaticamente da camada do Android.
-
Implemente
contentCards.subscribeToUpdates
para assinar atualizações de cartões de conteúdo, conforme descrito na documentação subscribeToUpdates. -
Sua implementação de retorno de chamada
contentCards.subscribeToUpdates
deve chamarBrazePlugin.processContentCards(contentCards)
.
Para obter um exemplo, consulte AppDelegate.swift em nosso app de amostra.
Reprodução da chamada de retorno para cartões de conteúdo
Para armazenar quaisquer cartões de conteúdo disparados antes que o retorno de chamada esteja disponível e reproduzi-los depois que ele for definido, adicione a seguinte entrada ao mapa customConfigs
ao inicializar o BrazePlugin
:
1
BrazePlugin braze = new BrazePlugin(customConfigs: {replayCallbacksConfigKey: true});
Teste de exibição do cartão de conteúdo de amostra
Siga estas etapas para testar um cartão de conteúdo de amostra.
- Defina um usuário ativo no app React chamando o método
braze.changeUserId('your-user-id')
. - Vá para Campaigns (Campanhas ) e siga este guia para criar uma nova campanha de Content Card (Cartão de conteúdo).
- Crie sua campanha de teste do cartão de conteúdo e vá para a guia Teste. Adicione o mesmo
user-id
que o usuário teste e clique em Send Test (Enviar teste). - Toque na notificação por push e isso deve abrir um cartão de conteúdo em seu dispositivo. Talvez seja necessário atualizar seu feed para que ele seja exibido.
Para obter mais detalhes sobre cada plataforma, siga os guias de integração do Android ou do iOS.
Suporte a GIFs
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.