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 únicos e simples (como informar os usuários sobre um produto com uma única mensagem). Use Canvas para jornadas do usuário com várias etapas (como enviar sugestões de produtos personalizadas com base no comportamento do usuário ao longo do tempo).

• campaign
• canvas

Etapa 2: Especifique seus tipos de mensagem

Selecione um dos três tipos essenciais de Content Card: Clássico, Imagem com legenda e Somente imagem.

Para saber mais sobre o comportamento 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 em apps móveis quanto em aplicativos web.

Tipo de mensagem	Exemplo	Descrição
Clássico		O cartão clássico tem um layout simples, com título em negrito, texto da mensagem e uma imagem opcional posicionada no início do título e do texto. O ideal é usar uma imagem quadrada ou um ícone com o cartão clássico.
Imagem com legenda		O cartão de imagem com legenda destaca seu conteúdo com texto e uma imagem que chama a atenção.
Somente imagem		O cartão somente imagem chama a atenção com espaço para imagens, GIFs e outros conteúdos criativos sem texto.

Etapa 3: Criar um Content Card

Você pode editar todos os aspectos do conteúdo e do comportamento da sua mensagem na guia Criar do editor de mensagens.

O conteúdo aqui varia de acordo com o Tipo de cartão escolhido na etapa anterior, mas pode incluir qualquer uma das seguintes opções:

Idioma

Selecione Adicionar idiomas para adicionar os idiomas desejados a partir da lista fornecida. Isso insere Liquid na sua mensagem. Recomendamos selecionar os idiomas antes de escrever o conteúdo, assim você pode preencher o texto no lugar certo dentro do 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 para criar mensagens da direita para a esquerda que sejam exibidas da forma mais precisa possível, consulte Criação de mensagens da direita para a esquerda.

Título e mensagem

Escreva o que quiser. Não há limites, mas quanto mais rápido você transmitir sua mensagem e fizer seu 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 com imagem.

Imagem

Para adicionar uma imagem ao seu Content Card, você pode selecionar Adicionar imagem ou fornecer um URL de imagem. Ao selecionar Adicionar imagem, a Biblioteca de mídia é aberta. Lá, você pode selecionar uma imagem já enviada ou adicionar uma nova.

Cada tipo de mensagem e plataforma pode ter suas próprias proporções e requisitos sugeridos, então confira quais são antes de encomendar ou criar uma nova imagem. Lembre-se de que os campos de mensagem do Content Card são limitados a 2 KB de tamanho total.

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. Quando a Braze entrega um Content Card, ele está fixado ou não fixado, e esse status não muda durante toda a vida útil do cartão. Se você alterar a configuração de fixação em uma campanha, a atualização se aplica apenas aos cartões enviados após a modificação. Ela não altera o status de fixação dos cartões que já estão no feed do usuário.

Comportamento ao clicar

Quando seu 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 o seu Content Card, lembre-se de atualizar o Texto do link de acordo.

As seguintes ações estão disponíveis para links de Content Cards:

Ação	Descrição
Redirecionar para URL da web	Abre uma página da web não nativa.
Deep link para o app	Faz 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 Registrar evento personalizado e Registrar atributo personalizado exigem a seguinte compatibilidade de versão do SDK:

Etapa 4: Defina configurações adicionais (opcional)

Você pode usar pares de chave-valor para criar categorias para seus cartões, criar vários feeds de Content Cards e personalizar como os cartões são classificados.

Para adicionar pares de chave-valor à sua mensagem, acesse a guia Configurações e selecione Adicionar novo par.

Etapa 5: Crie o restante de sua Campaign ou Canvas

• campaign
• canvas

Etapa 6: Revisar e implementar

Depois de terminar de criar sua campanha ou Canvas, revise os detalhes, teste e envie. Para saber mais, consulte Enviar mensagens de teste.

Em seguida, confira os relatórios de Content Cards para saber como acessar os resultados das suas campanhas de Content Cards.

O que você precisa saber

Limitações de carga útil e feed

Para garantir o desempenho, os Content Cards têm duas restrições principais: um limite de 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 dos Content Cards

A carga útil completa de um único Content Card não pode ultrapassar 2 KB depois que toda a personalização com Liquid for renderizada. Isso inclui:

• Título
• Mensagem
• URL da imagem (o comprimento da própria string da URL, não o tamanho do arquivo de imagem)
• Texto do link
• URLs de link de todas as plataformas especificadas (URLs separadas para iOS, Android e web contam para o total)
• Pares de chave-valor (tanto os nomes das chaves quanto seus valores)

Usar Liquid para inserir strings de texto longas (como as de atributos personalizados) pode fazer você ultrapassar o limite.

O criador de Campaigns exibe um alerta se o seu conteúdo estático ultrapassar o limite. Não estimamos o tamanho do conteúdo dinâmico que usa Liquid. Se o tamanho da mensagem ultrapassar 2 KB, ela é interrompida no momento do envio. Você pode ver essas interrupções em Observabilidade de mensagens com o resultado Content Card invalid.

Confira algumas práticas recomendadas para gerenciar o tamanho da carga útil dos Content Cards:

• Use encurtadores de URL para links longos. URLs, principalmente as que têm muitos parâmetros de rastreamento, podem causar problemas com o limite de tamanho. Um serviço de encurtamento de URL pode reduzir bastante a contagem de caracteres e liberar espaço na carga útil.
• Trunque o conteúdo dinâmico com Liquid. Ao personalizar cartões com texto dinâmico de atributos de usuário ou chamadas de API, o tamanho do conteúdo pode ser imprevisível. Use proativamente filtros do Liquid como truncate para 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 diferentes 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 os Banners para conteúdos mais ricos. Para casos de uso que exigem grandes volumes de conteúdo com frequência, os Content Cards podem não ser o canal ideal. Os Banners não têm a mesma limitação de 2 KB de carga útil e são mais adequados para incorporar conteúdo mais rico diretamente na experiência do app ou do website.

Número de cartões no feed

Cada usuário pode ter até 250 Content Cards não expirados no feed ao mesmo tempo. Quando esse limite é ultrapassado, a Braze deixa de retornar os cartões mais antigos, mesmo que não tenham sido lidos. Cartões descartados também contam para esse limite. Portanto, um número alto 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 estas práticas:

• Use datas de expiração mais curtas: Para Campaigns com prazo definido (como uma promoção de fim de semana), defina uma data de expiração específica. Assim, os cartões são removidos automaticamente do feed e deixam de contar para o limite quando não forem 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 que pede ao usuário para completar o perfil deve ser removido assim que um evento profile_completed for registrado.
• Revise Campaigns de longa duração: Analise Campaigns recorrentes ou contínuas para garantir que elas não estejam criando uma experiência ruim para seus usuários ao encher o feed com cartões demais ao longo do tempo.

Entendendo a reelegibilidade dos Content Cards

A reelegibilidade determina se e quando um usuário pode receber uma mensagem da mesma Campaign mais de uma vez. Nos Content Cards, entender como isso funciona é essencial para gerenciar Campaigns recorrentes e garantir que os usuários não recebam mensagens duplicadas ou desatualizadas.

Como a reelegibilidade é calculada

Se você ativar a reelegibilidade, a contagem para que um usuário possa “reentrar” em uma Campaign começa depois que a mensagem é enviada a ele. O momento exato em que essa contagem começa depende das suas configurações de criação de cartões:

• Content Cards criados na primeira impressão usam o horário da impressão para calcular a reelegibilidade.
• Content Cards criados no lançamento da Campaign, em Campaigns multicanal ou na entrada da etapa do Canvas usam o horário mais recente entre o envio e a 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 excluídos automaticamente dos sistemas da Braze 30 dias depois de 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 de novo depois de 30 dias. Quando o cartão original é excluído, o sistema deixa de ter o registro de que aquele usuário recebeu a Campaign, e ele se torna elegível de novo na próxima sessão.

Para que os usuários recebam uma mensagem de uma Campaign específica apenas uma vez, adicione à sua Campaign ou etapa do Canvas um filtro de público para usuários que não receberam mensagem dessa Campaign. Esse filtro é a forma mais confiável de evitar envios duplicados em Campaigns de longa duração.

Gerenciando Content Cards ativos

Depois de enviados, os Content Cards ficam aguardando em uma “caixa de entrada”, prontos para serem entregues ao usuário (parecido com o 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 a vida útil do cartão. Isso vale mesmo se você estiver chamando uma API pelo Connected Content e os dados do endpoint mudarem. Esses dados não são atualizados. O cartão só pode deixar de ser enviado para novos usuários e ser removido dos feeds dos usuários. Se você modificar uma Campaign, apenas os cartões enviados depois da modificação terão a atualização.

Atualizando cartões já lançados

Para alterar um cartão para usuários que já o receberam, use um dos métodos a seguir:

Opção 1: Duplicar a Campaign (recomendado para alterações imediatas)

A primeira abordagem é arquivar a Campaign e lançar uma nova Campaign duplicada:

1. Interrompa a Campaign original e, quando solicitado, selecione Remove card after the next sync.
2. Duplique a Campaign, faça suas edições e lance a nova versão.

Ao duplicar a Campaign, você precisa definir o público da nova versão. Use filtros de segmentação para controlar quem recebe o cartão atualizado:

• Se os usuários nunca devem voltar a ser elegíveis para um Content Card, você pode filtrar usuários que não receberam a versão anterior do Content Card definindo o filtro Received Message from Campaign com a condição Has Not.
• Se os usuários que receberam o cartão anterior devem voltar a ser elegíveis em X dias, você pode definir o filtro Last Received Message from specific campaign para mais de X dias atrás OU Received Message from Campaign com a condição Has Not.

Impacto

• Destinatários existentes: Destinatários novos e existentes veem o cartão atualizado na próxima atualização do feed, se forem elegíveis.
• Relatórios: Cada versão do cartão tem uma análise de dados separada.

Digamos que você configurou uma Campaign para ser disparada pelo início de sessão, com reelegibilidade de 30 dias. Um usuário recebeu a Campaign há dois dias, e você quer mudar o texto. Primeiro, arquive a Campaign e remova os cartões do feed. Depois, duplique a Campaign e lance-a de novo com o novo texto. Se o usuário iniciar outra sessão, ele recebe o novo cartão imediatamente.

Opção 2: Interromper e relançar a mesma Campaign

Essa abordagem mantém toda a sua análise de dados unificada em uma única Campaign. Usuários que se tornam elegíveis recebem o novo cartão, mas a atualização para os destinatários existentes só acontece quando eles voltam a ser elegíveis:

1. Interrompa sua Campaign e, quando solicitado, selecione Remove card after the next sync.
2. Edite a Campaign conforme necessário.
3. Reinicie a Campaign.

Impacto

• Destinatários existentes: Usuários que já receberam o cartão só recebem os cartões atualizados quando voltam a ser elegíveis. Se a reelegibilidade estiver desativada, eles nunca recebem o novo cartão.
• Relatórios: Uma única Campaign reúne toda a análise de dados das versões do cartão lançadas. A Braze não diferencia as versões lançadas.

Digamos que você tem uma Campaign disparada pelo início de sessão, com reelegibilidade de 30 dias. Um usuário recebeu a Campaign há dois dias, e você quer mudar o texto. Primeiro, interrompa a Campaign e remova o cartão do feed. Depois, publique a Campaign de novo com o novo texto. Se o usuário iniciar outra sessão, ele recebe o novo cartão em 28 dias.

Removendo e expirando cartões

Remoção manual de cartões

Você pode remover cartões manualmente dos feeds de todos os usuários a qualquer momento interrompendo a Campaign.

1. Abra a Campaign de Content Card e selecione Stop Campaign.
2. Quando solicitado, selecione Remove card after the next sync. O cartão é removido na próxima atualização do feed.

Remoção automática de cartões

Você pode remover um cartão automaticamente 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, a Braze processa o evento e então remove o cartão do feed dele.

Expiração de cartões

Os Content Cards ficam disponíveis por até 30 dias a partir do envio. Depois de 30 dias, a Braze os remove dos feeds dos usuários e os exclui dos sistemas da Braze.

Fazendo os cartões durarem mais de 30 dias

Se você quer que um cartão pareça estar sempre disponível, pode criar uma Campaign recorrente que, na prática, substitui o cartão a cada 30 dias:

1. Defina a duração do Content Card para 30 dias.
2. Defina a reelegibilidade da Campaign para 30 dias.
3. Configure a Campaign para ser disparada em “Session Start”.

Sincronização e atualização de Content Cards

Os Content Cards são sincronizados de acordo com um cronograma e quando seu app atualiza o feed. O comportamento da sincronização é diferente entre sincronizações completas e parciais, e a sua integração SDK afeta quando os cartões são atualizados no início da sessão. Nas versões de SDK compatíveis, a Braze também entrega envios e remoções durante uma sessão ativa por meio da entrega em tempo real. Para detalhes de implementação, consulte Personalizar o feed de Content Cards e Criando Content Cards.

Impacto de interromper Campaigns de Content Cards

Quando você interrompe uma Campaign e seleciona Remove card after the next sync, a Braze remove o cartão dos feeds dos usuários na próxima atualização. A contagem de impressões pode ser menor que a de envios, porque os usuários não conseguem gerar impressões de cartões removidos antes de visualizá-los.

Solução de problemas

Por que os Content Cards não aparecem logo após um evento-gatilho?

Em Campaigns com entrega baseada em ação (como início de sessão), é normal haver um pequeno atraso entre o evento-gatilho e a disponibilidade do cartão. Esse atraso acontece porque:

• O evento-gatilho é enviado aos servidores da Braze
• A Campaign é disparada e a elegibilidade do usuário é registrada
• O Content Card é criado no banco de dados para esse usuário
• O cartão chega ao dispositivo

Nas versões compatíveis do SDK, a entrega em tempo real envia o cartão ao dispositivo assim que a Braze o cria. Assim, o cartão chega durante a sessão atual. Nas versões anteriores, o SDK busca o cartão na próxima sincronização. Se essa sincronização ocorrer antes de a elegibilidade do usuário ser registrada, nenhum cartão é retornado.

Para novos usuários na primeira sessão, esse atraso de processamento é inevitável. Para usuários existentes que precisam de disponibilidade imediata, considere usar a entrega agendada.

Se você precisar minimizar os atrasos tanto para novos usuários quanto para os existentes, pode criar duas Campaigns:

• Usuários existentes com contagem de sessões maior que 0: Use uma Campaign com entrega agendada. Os cartões são criados previamente e ficam disponíveis na hora.
• Novos usuários com contagem de sessões igual a 0: Use uma Campaign disparada por ação. Os cartões são criados após o gatilho da primeira sessão.

Essa abordagem garante que os usuários existentes vejam os cartões instantaneamente, sem deixar de alcançar os novos usuários após um breve atraso na primeira sessão. Para outras estratégias de redução de latência, consulte Melhorar a baixa latência para Content Cards.

Por que os registros de data e hora de impressão ou dispensa ficam fora do cronograma da Campaign?

Os registros de data e hora de impressão e dispensa na análise de dados e no Currents refletem quando um usuário visualiza ou dispensa um Content Card, e não quando a Braze cria ou envia o cartão. Um cartão pode continuar no feed do usuário até que os Content Cards sejam atualizados. Por isso, esses registros podem ficar depois da janela de envio da Campaign.

Se os horários ainda parecerem estranhos:

• Confirme se você está vendo a análise de dados no fuso horário da sua empresa ou no fuso horário do usuário no Currents.
• Verifique se o usuário realmente visualizou ou dispensou o cartão depois de recebê-lo, em vez de comparar apenas com o horário de envio.

Para saber mais sobre as métricas de Content Cards, consulte Relatórios de Content Cards.

Erro “All expiration values for a campaign must match”

Esse erro aparece quando uma Campaign de Content Card com múltiplas variantes usa configurações de expiração diferentes entre as variantes. Defina a mesma expiração (duração ou horário específico) em todas as variantes, ou reduza a Campaign a uma única variante, e salve novamente. Para saber como definir a expiração ao criar uma Campaign, consulte Escolher um cronograma de entrega ou gatilho.