Manter notificações por push em uma caixa de entrada de mensagens com Content Cards

Mantenha conteúdos importantes de push disponíveis depois que uma notificação for descartada. Envie um cartão de conteúdo correspondente para uma caixa de entrada de mensagens personalizada no app e filtre essa caixa de entrada com pares de chave-valor.

Sobre este exemplo

A Pyrite Financial, uma marca fictícia de banco digital, está começando a enviar notificações por push com a Braze. Depois que um consumidor descarta uma notificação por push, a mensagem some da interface do dispositivo.

As equipes de Marketing e Produto querem que os consumidores abram uma caixa de entrada de mensagens persistente a partir de um ícone de sino no app. Lá, os consumidores podem reabrir alertas de documentos prontos, avisos de transações e mensagens sobre interrupções programadas.

Eles já usam Content Cards em outra parte do app (por exemplo, artigos). Esse padrão adiciona um segundo posicionamento de Content Cards: uma caixa de entrada de mensagens que pode receber:

• Somente uma notificação por push
• Somente um cartão de conteúdo
• Uma notificação por push e um cartão de conteúdo correspondente juntos

Um toque na notificação por push e um toque no cartão de conteúdo podem levar, por deep link, ao mesmo destino (por exemplo, documentos). Para algumas mensagens push, o toque abre a própria caixa de entrada.

Este exemplo mostra como orquestrar a entrega de notificações por push e Content Cards. Para criar a interface personalizada da caixa de entrada no SDK, consulte Tutorial: Caixas de entrada de Content Cards. Para detalhes sobre o layout dos cartões, consulte Criação de Content Cards personalizados.

Considerações

• Os Content Cards ficam disponíveis por até 30 dias após o envio. Eles contam para o limite de 250 cartões não expirados no feed de cada usuário, incluindo cartões descartados. Cada carga útil de cartão é limitada a 2 KB depois que o Liquid é renderizado. Consulte Criar um cartão de conteúdo.
• Se você já usa Content Cards em outro lugar do app, use pares de chave-valor (por exemplo, feed_type: inbox versus feed_type: article) para criar posicionamentos separados. Assim, cada tela mostra apenas seus próprios cartões. Todos os cartões compartilham um único feed do SDK até que seu app os filtre. Consulte Personalização de feeds de Content Cards.
• Os Content Cards são atualizados automaticamente no início da sessão. Atualizações adicionais usam requestContentCardsRefresh. Atualize quando a caixa de entrada for aberta ou ao puxar para atualizar. Evite atualizações contínuas ou a cada troca de guia para não atingir os limites de frequência de atualização.
• Interfaces de caixa de entrada personalizadas precisam registrar impressões, cliques e descartes manualmente. Os indicadores de não lido (por exemplo, um ponto no ícone de sino) são gerenciados pelo seu app.
• Toda notificação por push que deve permanecer na caixa de entrada precisa de um cartão de conteúdo correspondente. Inclua os pares de chave-valor e os deep links corretos. Use um modelo de Campaign multicanal ou um modelo de Canvas para que o canal de Content Cards continue incluído.
• Use uma Campaign multicanal para enviar uma notificação por push e um cartão de conteúdo simultaneamente, sem lógica de acompanhamento. Use o Canvas quando precisar de postergações, ramificações, reengajamento ou etapas posteriores baseadas no engajamento.

Configuração

Etapa 1: Defina os pares de chave-valor e os deep links da caixa de entrada

Combine quais extras (pares de chave-valor) o app usa para filtrar e agir sobre os cartões da caixa de entrada. A tabela a seguir mostra um conjunto de exemplo.

Defina os destinos dos deep links para cada caso de uso. A tabela a seguir lista destinos de exemplo.

Peça à sua equipe de engenharia para implementar a filtragem, o estado opcional de não lido e a análise de dados com base nessas chaves. Reutilize as mesmas chaves em todos os Content Cards da caixa de entrada.

Etapa 2: Escolha entre uma Campaign multicanal ou um Canvas

Escolha uma Campaign multicanal ou um Canvas de acordo com a jornada. A tabela a seguir compara as duas opções.

Para ver um exemplo desse padrão, consulte Content Cards no Canvas — Caixa de entrada de notificações por push.

Etapa 3: Configure a entrega das mensagens

Campaign multicanal

1. Acesse Envio de mensagens > Campanhas, selecione Criar campanha e depois selecione Multicanal.
2. Na etapa Escrever, selecione Adicionar canal e adicione push e Content Cards.
3. Escreva a notificação por push. Em Comportamento ao clicar, defina o deep link para a caixa de entrada ou para outro destino no app.
4. Escreva o cartão de conteúdo com um texto correspondente ou complementar. Na guia Configurações, selecione Adicionar novo par e adicione os pares de chave-valor da caixa de entrada da Etapa 1. Defina o deep link do cartão de conteúdo.
5. Agende a entrega baseada em ação para eventos como um novo documento. Use a entrega agendada para interrupções programadas. Defina o público.
6. Salve um modelo ou uma lista de verificação para que futuras Campaigns de push vinculadas à caixa de entrada incluam o canal de Content Cards e os mesmos extras.

Canvas

1. Acesse Envio de mensagens > Canvas e selecione Criar Canvas. Defina o cronograma de entrada e o público da jornada (por exemplo, um evento personalizado quando um documento estiver pronto).
2. Adicione uma etapa de Mensagem que inclua push e Content Cards. Use etapas de Mensagem consecutivas se o fluxo precisar delas.
3. Escreva a notificação por push e o cartão de conteúdo da mesma forma que na opção de Campaign, incluindo deep links e pares de chave-valor da caixa de entrada.
4. Se quiser, adicione etapas posteriores que usem o engajamento com o cartão de conteúdo. Por exemplo, se nenhum clique ocorrer em 48 horas, envie uma mensagem de acompanhamento. Antes de depender desses filtros, confirme quais dados de análise sua caixa de entrada personalizada registra.

Etapa 4: Confirme o comportamento da caixa de entrada no app

Antes do lançamento, confirme com sua equipe de engenharia que o app:

1. Faz uma única inscrição nas atualizações de Content Cards no início do ciclo de vida do app. Reutilize uma inscrição existente se os Content Cards já estiverem ativos em outro lugar.
2. Renderiza a caixa de entrada a partir dos cartões em cache e, depois, atualiza ao abrir ou ao puxar para atualizar.
3. Filtra os cartões cujos extras correspondem à caixa de entrada (por exemplo, feed_type igual a inbox).
4. Registra impressões, cliques e descartes na interface personalizada. No React Native, use estes métodos do SDK:
   • getCachedContentCards
   • requestContentCardsRefresh
   • logContentCardImpression
   • logContentCardClicked
   • logContentCardDismissed
   • processContentCardClickAction
   • Prefira getCachedContentCards ao método obsoleto getContentCards.
5. Opcionalmente, descarta um cartão quando o consumidor conclui a ação relacionada (por exemplo, abre o doc_id em documentos). Faça isso além do toque para descartar na caixa de entrada.

Etapa 5: Teste os três modos de entrega

• Somente notificação por push: A notificação chega e nenhum cartão aparece na caixa de entrada.
• Somente cartão de conteúdo: O cartão aparece na caixa de entrada e nenhuma notificação por push é enviada.
• Notificação por push e cartão de conteúdo: Os dois são enviados juntos e os deep links funcionam conforme o planejado. O cartão permanece depois que a notificação por push é descartada. O indicador de não lido, o descarte e a análise de dados funcionam como esperado.

Teste a atualização com uma navegação realista para que os limites de frequência não bloqueiem as atualizações da caixa de entrada durante os testes.

Artigos relacionados

• Criar um cartão de conteúdo
• Content Cards no Canvas
• Criar uma Campaign multicanal
• Tutorial: Caixas de entrada de Content Cards
• Criação de Content Cards personalizados
• Personalização do feed de Content Cards
• Registro de análise de dados de Content Cards
• Criar uma mensagem push