Criar um Banner
Saiba como criar Banners ao construir Campaigns e Canvas na Braze. Para saber mais, consulte Sobre Banners.
Pré-requisitos
Antes de lançar seu Banner, sua equipe de desenvolvimento precisa configurar os posicionamentos no seu app ou site. Você ainda pode rascunhar sua campanha de Banner enquanto isso, mas não poderá lançá-la até que os posicionamentos estejam configurados.
Criar uma mensagem de Banner
Etapa 1: Criar posicionamentos no Braze
Se ainda não o fez, você precisará criar posicionamentos de banner no Braze, que são usados para definir os locais em seu app ou site que podem exibir banners. Para criar um posicionamento, acesse Settings > Banners Placements ( Configurações > Posicionamentos de banners) e selecione Create Placement (Criar posicionamento).

Dê um nome à sua colocação e atribua uma ID de colocação. Certifique-se de consultar outras equipes antes de atribuir uma ID, pois ela será usada durante todo o ciclo de vida do cartão e não deve ser alterada posteriormente. Para saber mais, consulte Placement IDs.

Etapa 2: Escolha onde criar sua mensagem
Não tem certeza se sua mensagem deve ser enviada usando uma Campaign ou um Canvas? Campaigns são melhores para campanhas de mensagens únicas e direcionadas, enquanto Canvas são melhores para jornadas de usuário com várias etapas.
- Acesse Messaging > Campaigns e selecione Create Campaign.
- Selecione Banner.
- Dê à sua campanha um nome claro e significativo.
- Adicione equipes e tags conforme necessário. Tags facilitam encontrar suas campanhas e criar relatórios. Por exemplo, ao usar o Criador de relatórios, você pode filtrar pelas tags relevantes.
- Selecione o posicionamento que você criou anteriormente para associá-lo à sua campanha.
- Adicione variantes conforme necessário. Você pode escolher um tipo de mensagem e disposição diferentes para cada uma. Para saber mais sobre variantes, consulte Testes multivariantes e A/B.
- Escolha uma data e hora de início para sua campanha de Banner. Por padrão, os Banners duram indefinidamente. Você pode alterar isso selecionando End Time e especificando uma data e hora de encerramento.
Se todas as mensagens da sua campanha forem semelhantes ou tiverem o mesmo conteúdo, redija sua mensagem antes de adicionar variantes extras. Depois, selecione Copy from Variant no menu suspenso Add Variant.
- Crie seu Canvas usando o criador de Canvas.
- Após configurar seu Canvas, adicione uma etapa de Mensagem no construtor de Canvas. Dê à sua etapa um nome claro e significativo.
- Selecione Banner como seu canal de envio de mensagens.
- Selecione um posicionamento para o Banner.
- Defina a prioridade do Banner. A prioridade do Banner determina a ordem em que os Banners são exibidos quando compartilham o mesmo posicionamento.
- Defina uma expiração para o Banner. Pode ser após um período de tempo depois que a etapa estiver disponível ou em uma data e hora específicas.
Etapa 3: Redigir um Banner
Para redigir seu Banner, você pode escolher:
- Começar com um modelo em branco
- Usar um modelo de Banner da Braze
- Selecionar um modelo de Banner salvo

Etapa 3.1: Estilizar o Banner
Você pode arrastar e soltar blocos e linhas na área do canvas para começar a construir sua mensagem.
Se você está carregando imagens com Conteúdo conectado ou Liquid, certifique-se de que a URL da imagem comece com https://. Usar http:// pode causar falha no seu app.
Para personalizar as propriedades de fundo, configurações de borda e mais da sua mensagem, selecione Styles. Se quiser personalizar o estilo apenas de um bloco ou linha específica, selecione-o para fazer as alterações.

Etapa 3.2: Definir o comportamento ao clicar (opcional)
Quando um usuário clica em um link no Banner, você pode optar por direcioná-lo para uma área mais profunda do seu app ou redirecioná-lo para outra página da web. Além disso, você pode escolher registrar um atributo personalizado ou evento, que atualiza o perfil do usuário com dados personalizados quando ele clica no Banner.
O comportamento ao clicar pode ser substituído se um elemento específico (como um botão, link ou imagem do Banner) tiver seu próprio comportamento ao clicar. Por exemplo, considerando os seguintes comportamentos ao clicar:
- Um Banner tem um comportamento ao clicar que redireciona para a página inicial de um site.
- Uma imagem no Banner tem um comportamento ao clicar que redireciona para a página de produto de um site.
Etapa 3.3: Configurar o comportamento de dispensa (opcional)
A dispensa de Banners está atualmente em acesso antecipado. Se você tem interesse em participar do acesso antecipado, entre em contato com seu gerente de sucesso do cliente.
Marque a caixa de seleção Banner can be dismissed para permitir que os usuários dispensem o Banner. Essa opção pode ser útil em cenários em que você deseja promover uma venda por tempo limitado para todos os usuários do app, mas permitir que eles dispensem a mensagem caso não tenham interesse.
Etapa 3.4: Adicionar propriedades personalizadas (opcional)
Você pode adicionar propriedades personalizadas a um Banner para anexar metadados estruturados, como strings ou objetos JSON. Essas propriedades não afetam como o Banner é exibido, mas podem ser acessadas pelo SDK da Braze para modificar o comportamento ou a aparência do seu app. Por exemplo, você poderia:
- Enviar metadados para análise de dados de terceiros ou integrações.
- Usar metadados como um
timestampou objeto JSON para acionar lógica condicional. - Controlar o comportamento de um Banner com base em metadados incluídos como
ratioouformat.
Para adicionar uma propriedade personalizada, selecione Settings > Properties > Add property.

Para cada propriedade que deseja adicionar, preencha o seguinte:
| Campo | Descrição | Exemplo |
|---|---|---|
| Tipo de propriedade | O tipo de dado da propriedade. Os tipos suportados incluem string, booleano, número, timestamp, URL de imagem e objeto JSON. | String |
| Chave da propriedade | O identificador único da propriedade. Essa chave é usada no SDK para acessar a propriedade. | color |
| Valor | O valor atribuído à propriedade. Deve corresponder ao tipo de propriedade selecionado. | #FF0000 |
Quando terminar, selecione Done.

Etapa 4: Construir o restante da sua campanha ou Canvas
Definir a prioridade do Banner (opcional)
A prioridade do Banner determina a ordem em que os Banners são exibidos quando compartilham o mesmo posicionamento. Para definir a prioridade manualmente:
- Selecione Set exact priority.
- Arraste e solte as campanhas para ordená-las com a prioridade correta.
- Selecione Apply Sort.
Se você tem várias campanhas de Banner usando o mesmo ID de posicionamento, recomendamos usar o organizador de prioridade por arrastar e soltar para definir a prioridade exata.
Escolher seu público
- Em Target Audiences, escolha Segments ou filtros para refinar seu público. Você recebe automaticamente uma pré-visualização da população aproximada do Segment. A associação exata ao Segment é calculada antes do envio da mensagem.
Sua mensagem será enviada apenas para usuários que já atendem às condições que você definiu na etapa Público-Alvo. Depois disso, eles ainda precisam atender ao gatilho que você define na etapa Agendar Entrega. Pense no público-alvo como uma sala de espera—apenas as pessoas que já estão dentro podem avançar quando a próxima ação acontecer.
- Em Assign Conversions, acompanhe a frequência com que os usuários realizam ações específicas após receberem uma campanha, definindo eventos de conversão com um período de até 30 dias para contar a ação como uma conversão.
Escolher eventos de conversão
A Braze permite que você acompanhe eventos de conversão, ou seja, a frequência com que os usuários realizam ações específicas após receberem uma campanha. Você tem a opção de permitir um período de até 30 dias durante o qual uma conversão é contabilizada se o usuário realizar a ação especificada.
Se ainda não fez isso, conclua as seções restantes do seu componente de Canvas. Para mais detalhes sobre como construir o restante do seu Canvas, implementar testes multivariantes e Seleção inteligente, e mais, consulte a etapa Construir seu Canvas da nossa documentação de Canvas.
Etapa 5: Testar sua mensagem (opcional)
Selecione Pré-visualização para visualizar seu Banner ou enviar uma mensagem de teste.

Lembre-se de que a pré-visualização pode não ser idêntica à renderização final no dispositivo do usuário devido a diferenças de hardware.
Para enviar uma mensagem de teste, adicione um grupo de teste de conteúdo ou um ou mais usuários individuais como Destinatários de Teste e selecione Enviar Teste. Você poderá visualizar sua mensagem de teste no dispositivo por até 5 minutos. Em seguida, selecione Copiar link de pré-visualização para gerar e copiar um link compartilhável que mostra como o banner ficará para um usuário aleatório. O link ficará válido por sete dias antes de precisar ser regenerado.

Ao revisar seu Banner de teste, verifique o seguinte:
- A sua Campaign de Banner está atribuída a um posicionamento?
- As imagens e mídias aparecem e funcionam como esperado nos tipos de dispositivos e tamanhos de tela segmentados?
- Os links e botões direcionam o usuário para onde deveriam ir?
- O Liquid funciona conforme o esperado? Você definiu um valor de atributo padrão para o caso de o Liquid não retornar nenhuma informação?
- O texto está claro, conciso e correto?
Para saber mais, consulte Enviar mensagens de teste.
Etapa 6: Revisar e implantar
Após terminar de construir sua campanha ou Canvas, revise os detalhes, teste-a e envie quando estiver tudo pronto.