Ir para o conteúdo

Esta página foi traduzida automaticamente e pode conter imprecisões. Para relatar um erro de tradução, use o componente de feedback na parte inferior do sumário, à direita da página.

Banners

Com Banners, você pode criar mensagens personalizadas para seus usuários, enquanto amplia o alcance de seus outros canais, como e-mail ou notificações por push. Você pode incorporar Banners diretamente no seu app ou site, o que permite interagir com os usuários por meio de uma experiência que parece natural.

Pré-requisitos

A disponibilidade de Banners depende do seu pacote da Braze. Entre em contato com seu gerente de conta ou gerente de sucesso do cliente para começar.

Antes de começar, verifique se você criou posicionamentos de Banner no seu app ou website.

Um exemplo de Banner exibido em um dispositivo.

Por que usar Banners?

Os Banners permitem que as equipes de marketing e de produto personalizem o conteúdo do app ou do website de forma dinâmica, refletindo a elegibilidade e o comportamento do usuário em tempo real. Eles exibem mensagens de forma persistente e integrada ao conteúdo, oferecendo experiências não intrusivas e contextualmente relevantes. Essas mensagens podem ser atualizadas no início de uma sessão ou durante a sessão, quando seu app ou website solicitar explicitamente.

Depois que os Banners são integrados a um app ou website, os profissionais de marketing podem criar e lançar Banners usando um editor de arrastar e soltar ou um editor de HTML completo. Assim, não é preciso contar com a ajuda contínua de desenvolvedores, o que reduz a complexidade e melhora a eficiência.

Caso de uso	Explicação
Anúncios	Mantenha anúncios, como eventos futuros ou mudanças de política, em destaque na experiência de aplicativo.
Ofertas personalizadas	Mostre promoções e incentivos personalizados com base no histórico de navegação, no conteúdo do carrinho, no nível de inscrição e no status de fidelidade de cada usuário.
Direcionamento para engajamento de novos usuários	Oriente novos usuários durante os fluxos de integração e a configuração da conta.
Vendas e promoções	Destaque conteúdos em evidência, produtos em alta e campanhas de marca em andamento de forma persistente e diretamente na sua página inicial, sem atrapalhar a experiência do usuário.

Recursos

Os recursos dos Banners incluem:

Criação fácil de conteúdo: Crie e visualize a prévia do seu Banner com um editor visual de arrastar e soltar. Ele oferece suporte a imagens, texto, botões, formulários de captura de e-mail, código personalizado e muito mais. Se a sua equipe preferir gerenciar a própria marcação, pode usar o editor de HTML para ter controle total sobre o HTML e os estilos do Banner. Outra opção é pedir ao BrazeAI Operator™ que gere o HTML a partir de uma descrição.
Posicionamentos flexíveis: Defina vários locais no seu aplicativo ou website onde os Banners podem aparecer. Assim, você consegue um direcionamento preciso para contextos ou experiências de usuário específicos.
Direcionamento web (acesso antecipado): Aponte um posicionamento web para um seletor CSS na sua página, e o Web SDK da Braze insere o Banner automaticamente nesse local, sem precisar de código de inserção para cada posicionamento. Confira Direcionamento web para Banners e Direcionamento web: inserção automática de Banners.
Personalização dinâmica: Os Banners recalculam a personalização (lógica Liquid) e a segmentação sempre que o banner é atualizado. Se um usuário atualizar o perfil ou um atributo personalizado mudar, a próxima atualização do Banner já reflete essas mudanças.
Priorização nativa: Defina a prioridade de exibição para quando vários Banners tiverem o mesmo posicionamento como alvo. Dessa forma, a mensagem certa chega aos usuários no momento certo.
Bloco de editor de código personalizado: Use o bloco de editor de código personalizado para adicionar HTML personalizado e fazer personalizações avançadas ou integrar o Banner aos estilos web que você já usa.

Sobre os Banners

IDs de posicionamento

Os posicionamentos de Banner são locais específicos no seu app ou site que você cria com o SDK da Braze e que definem onde os Banners podem aparecer.

Entre os locais mais comuns estão o topo da página inicial, as páginas de detalhes de produtos e os fluxos de checkout. Depois de criar os posicionamentos, você pode atribuir os Banners na sua Campaign de Banner.

Não há um limite fixo para o número de posicionamentos que você pode criar por espaço de trabalho. Você pode criar quantos IDs de posicionamento sua experiência exigir. Cada posicionamento deve ser único dentro de um espaço de trabalho. Um único ID de posicionamento pode ser referenciado por até 200 mensagens ativas ao mesmo tempo.

Importante

Evite modificar IDs de posicionamento depois de lançar uma Campaign de Banner.

Prioridade do Banner

Quando várias mensagens de Banner referenciam o mesmo ID de posicionamento, os Banners são exibidos em ordem de prioridade: alta, média ou baixa. Por padrão, os Banners têm prioridade média, mas você pode definir a prioridade manualmente ao criar ou editar sua Campaign de Banner.

Se vários Banners tiverem a mesma prioridade, o Banner mais recente para o qual o usuário for elegível será exibido primeiro.

Solicitações de posicionamento

Quando você cria posicionamentos no seu app ou site, seu app envia uma solicitação para a Braze buscar mensagens de Banner para cada posicionamento.

Você pode solicitar até 10 posicionamentos por solicitação de atualização.
Para cada posicionamento, a Braze retorna o Banner de maior prioridade que o usuário é elegível para receber.
Se mais de 10 posicionamentos forem solicitados em uma atualização, apenas os primeiros 10 são retornados; os demais são descartados.

Por exemplo, um app pode solicitar três posicionamentos em uma solicitação de atualização: homepage_promo, cart_abandonment e seasonal_offer. Cada solicitação retorna o Banner mais relevante para aquele posicionamento.

Limite de frequência para solicitações de atualização

Se você estiver em versões mais antigas do SDK (antes do Swift 13.1.0, Android 38.0.0, Web 6.1.0, React Native 17.0.0 e Flutter 15.0.0), apenas uma solicitação de atualização é permitida por sessão de usuário.

Se você estiver em versões mínimas mais novas do SDK (Swift 13.1.0+, Android 38.0.0+, Web 6.1.0+, React Native 17.0.0+ e Flutter 15.0.0+), as solicitações de atualização são controladas por um algoritmo de token bucket para evitar polling excessivo:

Cada sessão de usuário começa com cinco tokens de atualização.
Os tokens são reabastecidos a uma taxa de um token a cada 180 segundos (3 minutos).

Cada chamada explícita para requestBannersRefresh consome um token. A atualização automática que ocorre no início de uma nova sessão ou quando changeUser é chamado não consome um token, pois essa atualização é uma publicação do último Banner em cache para aquele usuário. Se você tentar uma atualização quando não houver tokens disponíveis, o SDK não faz a solicitação e registra um erro até que um token seja reabastecido. Isso é importante para atualizações durante a sessão e atualizações disparadas por eventos. Para implementar atualizações dinâmicas (por exemplo, após um usuário completar uma ação na mesma página), chame o método de atualização após o evento personalizado ser registrado, mas observe um delay necessário para a Braze ingerir e processar o evento antes que o usuário se qualifique para uma Campaign de Banner diferente.

Entrega de mensagens

As mensagens de Banner são entregues ao seu app ou site como conteúdo HTML, normalmente renderizado dentro de um iframe. Isso garante que seus Banners sejam renderizados de forma consistente em diferentes dispositivos e ajuda a manter os estilos e scripts deles separados do restante do seu código.

Os iframes permitem atualizações de conteúdo dinâmico e personalizado sem exigir alterações na sua base de código. Cada iframe recupera e exibe o HTML em cada sessão de usuário usando a lógica de direcionamento e personalização da Campaign.

Importante

Content Cards, mensagens no app, Banners e Feature Flags dependem da conectividade do dispositivo para sincronizar com os servidores da Braze. Como as condições de rede podem variar, existe a possibilidade de que o conteúdo ou as atualizações não sejam sincronizados, exibidos ou removidos imediatamente (por exemplo, se o usuário estiver offline). Recomendamos evitar esses canais para atualizações críticas e urgentes.

Dimensões e tamanhos

Veja o que você precisa saber sobre dimensões e tamanhos de Banners:

Embora o criador permita visualizar Banners em diferentes dimensões, essa informação não é salva nem enviada para o SDK.
O HTML ocupa toda a largura do contêiner em que é renderizado.
Recomendamos criar um elemento de dimensão fixa e testar essas dimensões no criador.

Connected Content

Importante

Connected Content for Banners está atualmente em acesso antecipado. Fale com o seu Braze account manager se tiver interesse em participar do acesso antecipado.

Você pode usar o Connected Content para trazer dados em tempo real de APIs externas para o seu Banner. Como os Banners são renderizados inline durante a atualização da sessão, o Connected Content tem limitações específicas neste canal:

Somente requisições GET: Os Banners renderizam apenas requisições de Connected Content do tipo GET. Requisições POST não são compatíveis.
Orçamento de renderização compartilhado: Todos os posicionamentos retornados em uma única requisição de atualização (até 10) compartilham um orçamento de renderização de aproximadamente dois segundos. Cada chamada de Connected Content consome esse orçamento compartilhado. Então, um posicionamento com chamadas lentas ou numerosas pode consumir o tempo de que outros posicionamentos precisam.
Sem novas tentativas: Se uma chamada de Connected Content falhar, expirar ou exceder o orçamento de renderização, o resultado do Connected Content para aquele posicionamento será tratado como nulo. Diferentemente de outros canais, os Banners não tentam a requisição novamente nem adiam a entrega.

Práticas recomendadas de implementação

Gerenciamento do logout do usuário

Quando um usuário sair do seu app ou website, chame o método de logout do SDK. Assim, você evita que o conteúdo de Banner em cache (e outros dados personalizados) continue disponível para o próximo usuário. Isso é especialmente importante em dispositivos compartilhados ou quando os usuários podem alternar entre contas.

No Web SDK, use logout() ou wipeData() quando um usuário sair. Para saber mais, consulte Limpeza de dados armazenados anteriormente.

Limitações

Cada espaço de trabalho pode ter até 200 Campaigns de banner ativas. Se esse limite for atingido, será necessário arquivar ou desativar uma Campaign existente antes de criar uma nova.

Além disso, as mensagens de banner não são compatíveis com os seguintes recursos:

Campaigns disparadas por API e baseadas em ação
Conteúdo conectado (em acesso antecipado)
Códigos promocionais
catalog_items usando a tag :rerender

Próximas etapas

Dica

Quer ajudar a priorizar as próximas novidades? Entre em contato pelo [email protected].

New Stuff!