Criar um cartão de conteúdo
Este artigo aborda como criar um cartão de conteúdo na Braze ao construir Campaigns e Canvas. Aqui, vamos orientar você na escolha de um tipo de mensagem, na composição do seu cartão e na programação da entrega da mensagem.
Etapa 1: Escolha onde criar sua mensagem
Use Campaigns para envios de mensagens simples e únicos (como informar os usuários sobre um produto com uma única mensagem). Use Canvas para jornadas de usuário com várias etapas (como enviar sugestões de produtos personalizadas com base no comportamento do usuário ao longo do tempo).
- Acesse Messaging > Campaigns e selecione Create Campaign.
- Selecione Content Cards ou, para Campaigns direcionadas a vários canais, selecione Multichannel.
- Dê à sua Campaign um nome claro e significativo.
- Adicione equipes e tags conforme necessário.
- As tags facilitam a localização das suas Campaigns e a criação de relatórios. Por exemplo, ao usar o Criador de relatórios, você pode filtrar pelas tags relevantes.
- Adicione e nomeie quantas variantes quiser para sua Campaign. Você pode escolher diferentes plataformas, tipos de mensagem e disposições para cada variante adicionada. Para saber mais sobre variantes, consulte Testes multivariantes e A/B.

Se todas as mensagens da sua Campaign forem semelhantes ou tiverem o mesmo conteúdo, redija sua mensagem antes de adicionar variantes extras. Em seguida, 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 Content Cards como seu canal de envio de mensagens.
- Escolha quando a Braze calcula a elegibilidade do público e a personalização para o Content Card. Isso pode ser na entrada da etapa ou na primeira impressão (recomendado). Etapas que contêm Content Cards podem ser agendadas ou baseadas em ação.
- Escolha se deseja remover os Content Cards quando os usuários concluírem uma compra ou realizarem um evento personalizado.
- Defina uma expiração para o Content Card (tempo no feed). Isso pode ser após um período de tempo ou em um momento específico.
- Filtre seu público, ou os destinatários, para esta etapa conforme necessário em Delivery Settings. Você pode refinar ainda mais seu público especificando Segments e adicionando filtros adicionais. As opções de público são verificadas após a postergação, no momento em que as mensagens são enviadas.
- Escolha quaisquer outros canais de envio de mensagens que você queira combinar com sua mensagem.
Etapa 2: Especifique seus tipos de mensagem
Selecione um dos três tipos essenciais de Content Card: Classic, Captioned Image e Image Only.
Para saber mais sobre o comportamento esperado e a aparência de cada tipo, consulte Detalhes criativos ou confira os links na tabela a seguir. Esses tipos de Content Card são aceitos tanto por apps móveis quanto por aplicações web.
| Tipo de mensagem | Exemplo | Descrição |
|---|---|---|
| Classic | ![]() |
O cartão clássico tem uma disposição direta com um título em negrito, texto da mensagem e uma imagem opcional posicionada à esquerda do título e do texto. É melhor usar uma imagem quadrada ou ícone com o cartão clássico. |
| Captioned Image | ![]() |
O cartão de imagem com legenda destaca seu conteúdo com texto e uma imagem chamativa. |
| Image Only | ![]() |
O cartão somente imagem chama a atenção com espaço para imagens, GIFs e outros conteúdos criativos sem texto. |
Etapa 3: Redija um Content Card
Você pode editar todos os aspectos do conteúdo e do comportamento da sua mensagem na guia Compose do editor de mensagens.

O conteúdo aqui varia com base no Tipo de cartão escolhido na etapa anterior, mas pode incluir qualquer uma das seguintes opções:
Idioma
Selecione Add Languages para adicionar os idiomas desejados da lista fornecida. Isso insere Liquid na sua mensagem. Recomendamos selecionar seus idiomas antes de escrever o conteúdo para que você possa preencher o texto nos locais corretos no Liquid. Para ver a lista completa de idiomas disponíveis, consulte Idiomas suportados.

Criar mensagens da direita para a esquerda
A aparência final das mensagens da direita para a esquerda depende muito de como os prestadores de serviço as renderizam. Para conhecer as práticas recomendadas na criação de mensagens da direita para a esquerda que sejam exibidas da forma mais precisa possível, consulte Criando mensagens da direita para a esquerda.
Título e mensagem
Escreva o que quiser. Não há limites, mas quanto mais rápido você conseguir transmitir sua mensagem e fazer o cliente clicar, melhor! Recomendamos títulos e conteúdos de mensagem claros e concisos. Esses campos não estão disponíveis para cartões somente imagem.
Imagem
Para adicionar uma imagem ao seu Content Card, selecione Add Image ou forneça uma URL de imagem. Ao selecionar Add Image, a Biblioteca de mídia é aberta, onde você pode selecionar uma imagem carregada anteriormente ou adicionar uma nova.
Cada tipo de mensagem e plataforma pode ter suas próprias proporções e requisitos sugeridos, então verifique quais são antes de encomendar ou criar uma imagem do zero. Lembre-se de que os campos de mensagem do Content Card são limitados a 2 KB no tamanho total.

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.
Fixar no topo
A Braze exibe um cartão fixado no topo do feed do usuário, e o usuário não pode descartá-lo. Se o feed de um usuário tiver vários cartões fixados, a Braze os ordena cronologicamente. Depois de enviar um cartão, não é possível atualizar retroativamente sua opção de fixação. Alterar essa opção após o envio de uma Campaign afeta apenas envios futuros.

Comportamento ao clicar
Quando o cliente clica em um link apresentado no cartão, o link pode levá-lo para uma área mais profunda do seu app ou para outro site. Se você escolher um comportamento ao clicar para seu Content Card, lembre-se de atualizar o Link Text de acordo.
As seguintes ações estão disponíveis para links de Content Card:
| Ação | Descrição |
|---|---|
| Redirecionar para URL da web | Abrir uma página web não nativa. |
| Deep link para o app | Deep link para uma tela existente no seu app. |
| Registrar evento personalizado | Escolha um evento personalizado para disparar. Pode ser usado para exibir outro Content Card ou disparar envios de mensagens adicionais. |
| Registrar atributo personalizado | Escolha um atributo personalizado para definir para o usuário atual. |
As opções Log Custom Event e Log Custom Attribute exigem a seguinte compatibilidade de versão do SDK:
Etapa 4: Configure definições adicionais (opcional)
Você pode usar pares chave-valor para criar categorias para seus cartões, criar múltiplos feeds de Content Cards e personalizar como os cartões são ordenados.
Para adicionar pares chave-valor à sua mensagem, acesse a guia Settings e selecione Add New Pair.
Etapa 5: Construa o restante da sua Campaign ou Canvas
Construa o restante da sua Campaign. Continue nas próximas seções para mais detalhes sobre como usar nossas ferramentas da melhor forma para criar Content Cards.
Escolha um cronograma de entrega ou gatilho
Content Cards podem ser entregues com base em um horário agendado, uma ação ou um gatilho de API. Para saber mais, consulte Agendando sua Campaign.
Você também pode definir a duração da Campaign e o horário de silêncio, além de determinar a expiração do Content Card. Defina uma data de expiração específica ou os dias até o cartão expirar, até 30 dias. Todas as variantes têm datas de expiração idênticas.
Se você optar por expirar um cartão após um período definido (por exemplo, após duas semanas), a expiração é calculada a partir do momento do envio do cartão. Para Campaigns agendadas, esse é o horário de lançamento programado. Para Campaigns baseadas em ação, esse é o momento em que o usuário realiza a ação de gatilho. Por exemplo, se um cartão baseado em ação for enviado às 14h hoje com expiração de 1 dia, ele expira às 14h do dia seguinte.

A limitação de frequência não se aplica aos Content Cards.
Para entrega baseada em ação, há um pequeno atraso esperado antes que o Content Card apareça. Por exemplo, quando uma Campaign é disparada no início da sessão, esse evento de gatilho precisa primeiro ser enviado aos servidores da Braze. Em seguida, a elegibilidade do usuário para a Campaign é registrada. Quando o SDK sincroniza, o cartão é criado e retornado na mesma resposta de sincronização. Se a sincronização do SDK aconteceu antes da elegibilidade do usuário ser registrada, ele não recebe o cartão. Para usuários de primeira sessão, esse atraso é inevitável. Para usuários existentes que precisam de disponibilidade imediata, considere usar a entrega agendada.
Entrega agendada
Para Campaigns de Content Card com entrega agendada, você pode escolher quando a Braze avalia a elegibilidade do público e a personalização para novas Campaigns de Content Card, especificando quando o cartão é criado. Para saber mais, consulte criação de cartão.
Escolha os usuários-alvo
Em seguida, direcione os usuários escolhendo Segments ou filtros para refinar seu público. Você recebe automaticamente uma pré-visualização de como é a população aproximada desse Segment. Lembre-se de que a composição exata do Segment é sempre 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.
Escolha eventos de conversão
A Braze permite que você rastreie com que frequência os usuários realizam ações específicas, eventos de conversão, após receberem uma Campaign. 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 o fez, 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 Construa seu Canvas da nossa documentação de Canvas.
Etapa 6: Revise e implante
Após terminar de construir a última parte da sua Campaign ou Canvas, revise os detalhes, teste e envie quando estiver pronto. Para saber mais, consulte Enviar mensagens de teste.

Depois que um Content Card é lançado, ele não pode ser editado. Ele só pode ser impedido de ser enviado a novos usuários e removido dos feeds dos usuários. Consulte Atualizando cartões lançados para entender como lidar com esse cenário.
Em seguida, confira Relatórios de Content Cards para saber como acessar os resultados das suas Campaigns de Content Card.
Informações importantes
Limitações de carga útil e feed
Para garantir o desempenho, Content Cards têm duas restrições principais: um limite no tamanho da carga útil de cada cartão e um número máximo de cartões que podem aparecer em um feed.
Limitações de tamanho para Content Cards
A carga útil total de dados de um único Content Card não pode exceder 2 KB após qualquer personalização Liquid ser renderizada. Isso inclui:
- Título
- Mensagem
- URL da imagem (o comprimento da string da URL em si, não o tamanho do arquivo de imagem)
- Texto do link
- URLs de link para todas as plataformas especificadas (URLs separadas para iOS, Android e Web contam para o total)
- Pares chave-valor (tanto os nomes das chaves quanto seus valores)
Usar Liquid para puxar strings longas de texto (como de atributos personalizados) pode fazer com que você exceda o limite.
O criador de Campaign exibe um aviso se o conteúdo estático exceder o limite. (Não é possível prever o tamanho de conteúdo dinâmico usando Liquid.) Se o tamanho da mensagem exceder 2 KB, ela é abortada no momento do envio. Você pode ver esses abortos no Registro de atividades de envio de mensagem com o motivo Content card maximum size exceeded.

Durante envios de teste, Content Cards que excedem 2 KB ainda podem ser entregues e exibidos corretamente.
Aqui estão algumas práticas recomendadas para gerenciar o tamanho da carga útil do Content Card:
- Use encurtadores de URL para links longos. URLs, especialmente aquelas com parâmetros de rastreamento extensos, podem ter problemas com o limite de tamanho. Usar um serviço de encurtamento de URL pode reduzir drasticamente a contagem de caracteres e liberar espaço na carga útil.
- Trunque conteúdo dinâmico com Liquid. Ao personalizar cartões com texto dinâmico de atributos de usuário ou chamadas de API, o comprimento do conteúdo pode ser imprevisível. Use proativamente filtros Liquid como
truncatepara limitar o comprimento de qualquer texto dinâmico. - Seja eficiente com URLs multiplataforma. O limite de 2 KB inclui as URLs de todas as plataformas que você definir. Usar URLs longas e exclusivas para cada plataforma pode multiplicar o tamanho da carga útil. Se possível, use um único link que funcione em todas as plataformas ou use encurtadores de URL conforme necessário.
- Considere Banners para conteúdo mais rico. Para casos de uso que consistentemente exigem grandes quantidades de conteúdo, Content Cards podem não ser o canal certo. Os Banners não têm a mesma limitação de carga útil de 2 KB e são mais adequados para incorporar conteúdo mais rico diretamente em uma experiência de app ou site.
Número de cartões no feed
Cada usuário pode ter até 250 Content Cards não expirados em seu feed a qualquer momento. Quando esse limite é excedido, a Braze para de retornar os cartões mais antigos, mesmo que não tenham sido lidos. Cartões descartados também contam para esse limite, o que significa que um grande número de cartões descartados pode reduzir o espaço disponível para os mais antigos.
Para evitar problemas com o limite de cartões, recomendamos as seguintes práticas:
- Use datas de expiração mais curtas: Para Campaigns sensíveis ao tempo (como uma promoção de fim de semana), defina uma data de expiração específica. Dessa forma, os cartões são automaticamente removidos do feed e não contam para o limite depois que não são mais relevantes.
- Aproveite a remoção baseada em ação: Configure eventos de remoção para cartões transacionais ou baseados em metas. Por exemplo, um cartão solicitando que o usuário complete seu perfil deve ser removido assim que um evento
profile_completedfor registrado. - Audite Campaigns de longa duração: Revise Campaigns recorrentes ou contínuas para garantir que não estejam criando uma experiência ruim para seus usuários ao encher o feed com muitos cartões ao longo do tempo.
Entendendo a reelegibilidade para Content Cards
A reelegibilidade determina se e quando um usuário pode receber uma mensagem da mesma Campaign mais de uma vez. Para Content Cards, entender como isso funciona é fundamental para gerenciar Campaigns recorrentes e garantir que os usuários não recebam mensagens duplicadas ou desatualizadas.

Quer que seu conteúdo dure mais de 30 dias? Experimente os Banners.
Como a reelegibilidade é calculada
Se você ativar a reelegibilidade, a contagem regressiva para quando um usuário pode “reentrar” em uma Campaign começa após o envio da mensagem. O momento específico em que essa contagem começa depende das suas configurações de criação de cartão:
- Content Cards que usam na primeira impressão usam o momento da impressão para calcular a reelegibilidade.
- Content Cards criados no lançamento da Campaign ou na entrada da etapa do Canvas usam o que for mais recente entre o momento do envio e o momento da impressão.
A expiração de 30 dias e a reelegibilidade
Uma fonte comum de confusão é a interação entre a reelegibilidade da Campaign e a expiração automática de 30 dias de todos os Content Cards.
Todos os Content Cards são automaticamente removidos dos sistemas da Braze 30 dias após serem enviados ou removidos. Se você tiver uma Campaign recorrente de longa duração com a reelegibilidade desativada, um usuário ainda pode receber o mesmo cartão novamente após 30 dias. Quando o cartão original é removido, o sistema não vê mais um registro de que o usuário recebeu a Campaign, tornando-o elegível novamente na próxima sessão.
Para que os usuários recebam uma mensagem de uma Campaign específica apenas uma vez, adicione um filtro de público à sua Campaign ou etapa do Canvas para usuários que não receberam uma mensagem desta Campaign. Esse filtro é a forma mais confiável de evitar envios duplicados em Campaigns de longa duração.
Gerenciando Content Cards ativos
Depois que os Content Cards são enviados, eles ficam aguardando em uma “caixa de entrada” prontos para serem entregues ao usuário (semelhante ao que acontece com e-mails). Depois que o conteúdo é carregado no Content Card (no momento da exibição), ele não pode ser alterado durante sua vida útil. Isso se aplica mesmo se você estiver chamando uma API por meio de Conteúdo conectado e os dados do endpoint mudarem. Esses dados não serão atualizados. O cartão só pode ser impedido de ser enviado a novos usuários e removido dos feeds dos usuários. Se você modificar uma Campaign, apenas cartões futuros que forem enviados terão a atualização.
Atualizando cartões lançados
Para alterar um cartão para usuários que já o receberam, você deve usar um dos seguintes métodos:
Opção 1: Duplicar a Campaign (recomendado para alterações imediatas)

Recomendamos esta opção para mensagens em que você está mostrando o conteúdo mais recente no cartão, as alterações devem ser exibidas imediatamente ou quando a reelegibilidade está desativada.
A primeira abordagem é arquivar a Campaign e lançar uma nova Campaign duplicada:
- Interrompa a Campaign original e, quando solicitado, selecione
Remove card after the next sync. - Duplique a Campaign, faça suas edições e lance a nova versão.
Ao duplicar a Campaign, você precisa definir o público para a nova versão. Use filtros de segmentação para controlar quem recebe o cartão atualizado:
- Se os usuários nunca devem ser reelegíveis para um Content Card, você pode filtrar por usuários que não receberam a versão anterior do Content Card definindo o filtro
Received Message from Campaigncom a condiçãoHas Not. - Se os usuários que receberam o cartão anterior devem ser reelegíveis em X dias, você pode definir o filtro para
Last Received Message from specific campaigncomo mais de X dias atrás OUReceived Message from Campaigncom a condiçãoHas Not.
Impacto
- Destinatários existentes: Destinatários novos e existentes veriam o cartão atualizado na próxima atualização do feed, se forem elegíveis.
- Relatórios: Cada versão do cartão teria análises de dados separadas.
Digamos que você configurou uma Campaign para ser disparada no início da sessão, com reelegibilidade definida para 30 dias. Um usuário recebeu a Campaign dois dias atrás e você quer alterar o texto. Primeiro, você arquivaria a Campaign e removeria os cartões do feed. Segundo, duplicaria a Campaign e relançaria com o novo texto. Se o usuário tiver outra sessão, receberá imediatamente o novo cartão.
Opção 2: Interromper e relançar a mesma Campaign

Recomendamos usar esta opção para mensagens únicas em uma central de notificações ou caixa de mensagens (como promoções), quando é importante que a análise de dados seja unificada, ou quando a urgência da mensagem não é uma preocupação (ou seja, os destinatários existentes podem esperar pelo período de elegibilidade antes de ver os cartões atualizados).
Essa abordagem mantém toda a sua análise de dados unificada em uma única Campaign. Usuários recém-elegíveis recebem o novo cartão, mas a atualização é atrasada para os destinatários existentes até que se tornem reelegíveis:
- Interrompa sua Campaign e, quando solicitado, selecione Remove card after the next sync.
- Edite sua Campaign conforme necessário.
- Reinicie sua Campaign.
Impacto
- Destinatários existentes: Usuários que já receberam o cartão não receberiam os cartões atualizados até se tornarem reelegíveis. Se a reelegibilidade estiver desativada, eles nunca receberiam o novo cartão.
- Relatórios: Uma Campaign contém toda a análise de dados de relatórios para as versões de cartão lançadas. A Braze não diferenciará entre as versões lançadas.
Digamos que você tem uma Campaign disparada no início da sessão com reelegibilidade definida para 30 dias. Um usuário recebeu a Campaign dois dias atrás e você quer alterar o texto. Primeiro, interrompa a Campaign e remova o cartão do feed. Segundo, republique a Campaign com o novo texto. Se o usuário tiver outra sessão, receberá o novo cartão em 28 dias.
Removendo e expirando cartões
Remoção manual de cartões
Você pode remover manualmente cartões dos feeds de todos os usuários a qualquer momento interrompendo a Campaign.
- Abra a Campaign de Content Card e selecione Stop Campaign.
- Quando solicitado, selecione Remove card after the next sync. O cartão é removido na próxima atualização do feed.
Remoção automatizada de cartões
Você pode remover automaticamente um cartão quando um usuário realiza uma ação específica, como concluir uma compra ou ativar um recurso.
Na sua Campaign ou etapa do Canvas, especifique um evento de remoção. Quando um usuário realiza esse evento, o cartão é removido do feed em uma atualização subsequente após a Braze processar o evento.

Essa remoção não é instantânea. Há um atraso de processamento, então pode levar vários minutos e mais de uma atualização do feed para o cartão desaparecer.

Você pode especificar vários eventos personalizados e compras que devem remover um cartão do feed de um usuário. Quando qualquer uma dessas ações for realizada pelo usuário, quaisquer cartões existentes enviados pela Campaign são removidos. Quaisquer cartões futuros elegíveis continuam a ser enviados de acordo com o cronograma da mensagem.

Expiração de cartões
Content Cards permanecem disponíveis por até 30 dias a partir do envio; após 30 dias, a Braze os remove dos feeds dos usuários e os elimina dos sistemas da Braze.
Fazendo cartões durarem mais de 30 dias

Para casos de uso que exigem que as mensagens persistam por mais tempo que o limite de 30 dias dos Content Cards, considere usar Banners. Os Banners são projetados para persistência e não têm uma data de expiração obrigatória, permitindo que permaneçam visíveis pelo tempo que for necessário.
Se você quiser que um cartão pareça estar sempre disponível, pode criar uma Campaign recorrente que efetivamente substitui o cartão a cada 30 dias:
- Defina a duração do Content Card para 30 dias.
- Defina a reelegibilidade da Campaign para 30 dias.
- Configure a Campaign para ser disparada no “Início da sessão”.


