Integração do Feed de notícias

Este artigo de referência aborda diferentes tipos de cartões do Feed de notícias, as diferentes propriedades específicas do cartão disponíveis e um exemplo de integração personalizada para seu aplicativo Android ou FireOS.

No Android, o feed de notícias é implementado como um fragmento disponível no projeto Braze Android UI. Consulte a documentação do Google sobre fragmentos para obter informações sobre como adicionar um fragmento a uma atividade.

A classe BrazeFeedFragment será atualizada automaticamente e exibirá o conteúdo do feed de notícias e a análise de dados de uso do registro. Os cartões que podem aparecer no feed de notícias de um usuário são definidos no dashboard do Braze.

Tipos de cartão

O Braze tem cinco tipos de cartões exclusivos: imagem de banner, imagem com legenda, anúncio de texto e notícias curtas. Cada tipo herda propriedades comuns de um modelo básico e tem as seguintes propriedades adicionais.

Propriedades do modelo do cartão básico

O modelo de cartão básico fornece o comportamento fundamental para todos os cartões.

Propriedades do cartão de imagem de banner

Os cartões de imagem de banner são imagens clicáveis em tamanho real.

Propriedades do cartão de imagem legendado

Os cartões de imagem legendados são imagens clicáveis em tamanho real com o texto descritivo que as acompanha.

Propriedades do cartão de anúncio de texto (imagem legendada sem imagem)

Os cartões de anúncio de texto são cartões clicáveis que contêm texto descritivo.

Propriedades do cartão de notícias curtas

Os cartões de notícias curtas são cartões clicáveis com imagens e texto descritivo.

Análise de dados da sessão

Os fragmentos da interface do usuário do Android não rastreiam automaticamente a análise de dados da sessão. Para garantir que as sessões sejam rastreadas corretamente, ligue para IBraze.openSession() quando o app for aberto.

Criação de link

A vinculação ao feed de notícias a partir de uma mensagem no app deve ser ativada registrando o BrazeFeedActivity em seu AndroidManifest.xml.

Integração de feed personalizado

Se quiser exibir o feed de forma totalmente personalizada, é possível fazê-lo usando suas próprias exibições preenchidas com dados de nossos modelos. Para obter modelos de feed de notícias, você precisará se inscrever para receber atualizações do feed de notícias e usar os dados do modelo resultante para preencher suas exibições. Também será necessário registrar análises de dados nos objetos do modelo à medida que os usuários interagem com as visualizações.

Parte 1: Inscrição de atualizações de feed

Primeiro, declare uma variável privada em sua classe de feed personalizado para manter seu inscrito:

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

Em seguida, adicione o seguinte código para inscrever-se para receber as atualizações do feed pela Braze, normalmente dentro de Activity.onCreate() da atividade do feed:

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();

Também recomendamos cancelar a inscrição quando a atividade do feed personalizado deixar de ser vista. Adicione o seguinte código ao método de ciclo de vida onDestroy() de sua atividade:

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

Parte 2: Análise de dados de registro

Ao usar exibições personalizadas, será necessário registrar a análise de dados manualmente, pois a análise só é tratada automaticamente quando se usa exibições da Braze.

Para registrar uma exibição do feed, chame Braze.logFeedDisplayed().

Para registrar uma impressão ou clicar em um cartão, ligue para Card.logClick() e Card.logImpression() respectivamente.