Perguntas frequentes

Estas são respostas para perguntas frequentes sobre Banners na Braze. Para informações mais gerais, consulte Sobre Banners.

Quando as atualizações de Banners aparecem para os usuários?

Os Banners são atualizados com os dados mais recentes sempre que você chama o método de atualização — não é necessário reenviar ou atualizar sua Campaign de Banner.

Quantos posicionamentos posso solicitar em uma sessão?

Em uma única solicitação de atualização, você pode solicitar no máximo 10 posicionamentos. Para cada um solicitado, a Braze retorna o Banner de maior prioridade para o qual o usuário é elegível. Solicitações adicionais retornam um erro.

Para saber mais, consulte Solicitações de posicionamento.

Quantas Campaigns de Banner podem estar ativas simultaneamente?

Cada espaço de trabalho suporta até 200 Campaigns de Banner ativas. Se esse limite for atingido, você precisará arquivar ou desativar uma Campaign existente antes de criar uma nova.

Para Campaigns que compartilham um posicionamento, qual Banner é exibido primeiro?

Se um usuário se qualifica para múltiplas Campaigns de Banner que compartilham o mesmo posicionamento, o Banner com a maior prioridade é exibido. Para saber mais, consulte Prioridade de Banner.

Posso usar Banners no meu feed de Content Cards existente?

Banners são diferentes de Content Cards, o que significa que você não pode usar Banners e Content Cards no mesmo feed. Para substituir feeds de Content Cards existentes por Banners, você precisará criar posicionamentos no seu app ou website.

Qual é a diferença entre Banners e mensagens no app?

Banners e mensagens no app alcançam os usuários dentro do seu app ou website, mas usam modelos de entrega diferentes. Se você está comparando Banners com uma configuração existente de mensagem no app, espere diferenças em disparadores, tempo de atualização e testes — não uma substituição direta.

Os Banners podem incluir vídeo?

O construtor padrão de Banners suporta imagens, texto e botões. Para incluir um vídeo em um Banner, você pode usar um bloco de Custom Code no construtor, ou criar o Banner inteiro com o editor de HTML e incorporar um reprodutor de vídeo diretamente no seu HTML.

Posso disparar um banner com base em ações do usuário?

Embora os Banners não suportem entrega baseada em ação, você pode direcionar usuários com base em suas ações anteriores usando segmentação e prioridade.

Por exemplo, para exibir um Banner especial apenas para usuários que completaram um evento purchase:

1. Direcionamento: Na sua Campaign, direcione para um Segment de usuários que realizaram o evento personalizado purchase pelo menos uma vez.
2. Prioridade: Se você tem um Banner geral para todos os usuários e esse Banner específico para compradores direcionado ao mesmo posicionamento, defina a prioridade do Banner específico como High e a do Banner geral como Medium ou Low.

Quando o usuário inicia uma nova sessão ou atualiza os Banners após realizar a ação, a Braze avalia sua elegibilidade. Se ele corresponder ao Segment “Purchase”, o Banner de alta prioridade é exibido.

Os usuários podem dispensar um Banner?

Sim. Você pode permitir que os usuários dispensem manualmente um Banner. Consulte Configurar comportamento de dispensa para detalhes sobre como configurar a dispensa tanto no construtor quanto no editor de HTML.

Os usuários podem dispensar Banners manualmente apenas se o comportamento de dispensa estiver ativado. Se a dispensa não estiver ativada, você pode controlar a visibilidade do Banner gerenciando a elegibilidade do Segment de usuários. Quando um usuário não atende mais aos critérios de direcionamento de uma Campaign de Banner, ele não o verá novamente na próxima sessão.

Quando um usuário dispensa um Banner, ele se torna inelegível para essa Campaign por padrão. Para permitir que usuários que dispensaram vejam o Banner novamente, configure a reelegibilidade na etapa Delivery Controls da Campaign. As etapas de Banner no Canvas usam as configurações de reentrada do Canvas para controlar a reelegibilidade.

Por exemplo, se você exibe um Banner promocional até que um usuário faça uma compra, registrar um evento como purchase_completed pode remover esse usuário do Segment direcionado, ocultando efetivamente o Banner nas sessões seguintes.

Como os usuários do grupo de controle são registrados no Currents e no compartilhamento de dados?

Os grupos de controle de Banners funcionam de forma diferente dos Content Cards e das mensagens no app. Os usuários de controle não são registrados em USERS_CAMPAIGNS_ENROLLINCONTROL_SHARED (ou no evento users.campaigns.EnrollInControl do Currents). Em vez disso, a exposição de controle é registrada em USERS_MESSAGES_BANNER_IMPRESSION_SHARED (Currents users.messages.banner.Impression) depois que seu app registra uma impressão, inclusive quando sua integração chama insertBanner para um Banner de controle e oculta o contêiner.

Para identificar usuários de controle nos dados exportados, filtre por message_variation_name (Control Group) ou pelo message_variation_api_id da variação de controle.

Para saber mais, consulte Como os usuários do grupo de controle são registrados no Currents para Content Cards, mensagens no app e Banners? e USERS_MESSAGES_BANNER_IMPRESSION_SHARED.

Posso exportar análise de dados de Campaigns de Banners usando a API da Braze?

Sim. Você pode usar o endpoint /campaigns/data_series para obter dados sobre quantas Campaigns de Banners foram visualizadas, clicadas ou convertidas.

Quando os usuários são segmentados?

Os usuários são segmentados no início da sessão. Se os Segments direcionados de uma Campaign dependem de atributos personalizados, eventos personalizados ou outros atributos de direcionamento, eles devem estar presentes no usuário no início da sessão.

Como posso compor Banners para garantir a menor latência?

Quanto mais simples a mensagem no seu Banner, mais rápido ele é renderizado. O ideal é testar sua Campaign de Banner em relação à latência esperada para o seu caso de uso. Por exemplo, teste atributos Liquid como catalog_items.

Se você usar Connected Content (em acesso antecipado), esteja ciente de que cada chamada conta contra um orçamento de renderização compartilhado de aproximadamente dois segundos entre todos os posicionamentos em uma única atualização. Se o orçamento for excedido ou uma chamada expirar, o resultado do Connected Content é tratado como nulo, e os Banners não fazem nova tentativa. Para minimizar a latência:

• Mantenha seus endpoints rápidos e armazene respostas em cache sempre que possível.
• Limite o número de URLs exclusivas de Connected Content entre posicionamentos que são renderizados juntos.
• Evite encadear chamadas em que uma resposta de Connected Content determina a URL da próxima.
• Use instruções de proteção Liquid ou o filtro default para lidar com resultados nulos e evitar Banners em branco.

Todas as Liquid tags são compatíveis?

Não. No entanto, a maioria das Liquid tags é compatível com mensagens de Banner, exceto catalog_items que são re-renderizados usando a tag :rerender.

Posso capturar eventos de clique?

Sim. A forma como os eventos de clique são capturados depende de como seu Banner é renderizado:

• Builder — componentes padrão: Se o seu Banner usa componentes padrão do editor (imagens, botões, texto), os cliques são rastreados automaticamente ao usar os métodos de inserção do SDK.
• Builder — blocos de Custom Code: Se você quiser rastrear cliques em elementos dentro de um bloco do editor de Custom Code, é necessário chamar brazeBridge.logClick() no seu HTML personalizado. Isso se aplica mesmo ao usar os métodos do SDK para inserir e renderizar o Banner.
• Editor de HTML: O rastreamento de cliques não é automático. Você deve chamar brazeBridge.logClick() para cada elemento clicável que deseja rastrear. Para a referência completa, consulte Custom code e ponte JavaScript para Banners.
• UI personalizada (headless): Se você está construindo uma UI totalmente personalizada usando as propriedades personalizadas do Banner em vez de renderizar o HTML do Banner, chame logClick() no objeto Banner a partir do código da sua aplicação.

Para saber mais, consulte Registro de cliques.