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 envio de mensagens simples e único (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).

• campaign
• canvas

Etapa 2: Especifique os tipos de mensagem

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

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 Cards são aceitos tanto por apps móveis quanto por aplicações web.

Tipo de mensagem	Exemplo	Descrição
Clássico		O cartão clássico tem um layout direto, com título em negrito, texto da mensagem e uma imagem opcional posicionada antes do título e do texto. É recomendável 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 chamativa.
Somente imagem		O cartão somente com imagem chama a atenção com espaço para imagens, GIFs e outros conteúdos criativos não textuais.

Etapa 3: Crie um Content Card

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

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

Idioma

Selecione Add Languages 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 para que você possa preencher o texto no local correto dentro do Liquid. Para a lista completa de idiomas disponíveis, consulte Idiomas compatíveis.

Crie mensagens da direita para a esquerda

A aparência final das mensagens da direita para a esquerda depende em grande parte de como os provedores de serviço as renderizam. Para práticas recomendadas sobre como criar mensagens da direita para a esquerda que sejam exibidas com a maior precisão 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ê 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 com imagem.

Imagem

Para adicionar uma imagem ao seu Content Card, selecione Add Image ou forneça um URL de imagem. Ao selecionar Add Image, a Media Library é aberta, onde você pode selecionar uma imagem já carregada 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 de Content Card são limitados a um tamanho total de 2 KB.

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 é fixado ou não fixado, e esse status não muda durante o tempo de vida do cartão. Se você alterar a configuração de fixação em uma Campaign, a atualização se aplica somente aos cartões enviados após a modificação. Isso não altera o status de fixação dos cartões que já estão no feed do usuário.

Comportamento ao clicar

Quando o cliente clica em um link apresentado no cartão, o link pode levá-lo para uma parte mais profunda do app ou para outro site. Se você escolher um comportamento ao clicar para o 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	Abre uma página 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 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 requerem a seguinte compatibilidade de versão do SDK:

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

Você pode usar pares 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 chave-valor à sua mensagem, acesse a guia Settings e selecione Add New Pair.

Etapa 5: Crie o restante da sua Campaign ou Canvas

• campaign
• canvas

Etapa 6: Revisar e lançar

Depois de concluir a criação da sua Campaign ou Canvas, revise os detalhes, teste-a e envie. Para saber mais, consulte Enviar mensagens de teste.

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

O que você precisa saber

Limitações de carga útil e feed

Para garantir a performance, os 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 de chave-valor (tanto os nomes das chaves quanto seus valores)

Usar Liquid para buscar 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 é feita a previsão do tamanho para conteúdo dinâmico usando Liquid. Se o tamanho da mensagem exceder 2 KB, ela será interrompida no momento do envio. Você pode ver essas interrupções no Registro de Atividade de Mensagens com o motivo Content card maximum size exceeded.

Aqui estão algumas boas práticas para gerenciar o tamanho da carga útil de Content Cards:

• Use encurtadores de URL para links longos. URLs, especialmente aquelas com parâmetros de rastreamento extensos, podem atingir problemas de 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 truncate para limitar o comprimento de qualquer texto dinâmico.
• Seja eficiente com URLs de múltiplas plataformas. 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 exigem consistentemente grandes quantidades de conteúdo, Content Cards podem não ser o canal ideal. Banners não possuem 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 website.

Número de cartões no feed

Cada usuário pode ter até 250 Content Cards não expirados em seu feed em 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 boas práticas:

• Use datas de expiração mais curtas: para Campaigns que são 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 mais 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 objetivos. Por exemplo, um cartão solicitando que um usuário complete seu perfil deve ser removido assim que um evento profile_completed for registrado.
• Audite Campaigns de longa duração: revise Campaigns recorrentes ou contínuas para garantir que elas não estejam criando uma experiência ruim para seus usuários ao preencher 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 é 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 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 configurações de criação do cartão:

• Content Cards que usam na primeira impressão utilizam o momento 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 utilizam o horário de envio ou o horário de impressão mais recente, o que for mais tardio.

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 eliminados 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 é eliminado, o sistema não encontra mais um registro de que aquele 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 dessa Campaign. Esse filtro é a forma mais confiável de evitar envios duplicados de 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). Após o conteúdo ser 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 Connected Content e os dados do endpoint mudarem. Esses dados não são atualizados. O envio só pode ser interrompido para novos usuários e removido dos feeds dos usuários. Se você modificar uma Campaign, apenas os cartões enviados após a modificação incluem a atualização.

Atualizando cartões já 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)

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 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 Campaign com a condição Has Not.
• Se os usuários que receberam o cartão anterior devem ser reelegí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 possui análises de dados separadas.

Digamos que você configurou uma Campaign para ser disparada pelo início de uma sessão, e ela tem a reelegibilidade definida para 30 dias. Um usuário recebeu a Campaign dois dias atrás, e você quer alterar o texto. Primeiro, arquive a Campaign e remova os cartões do feed. Segundo, duplique a Campaign e relance com o novo texto. Se o usuário tiver outra sessão, ele receberá o novo cartão imediatamente.

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

Essa abordagem mantém todas as suas análises de dados unificadas em uma única Campaign. Usuários recém-elegíveis recebem o novo cartão, mas isso atrasa a atualização para os destinatários existentes até que se tornem reelegíveis:

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

Impacto

• Destinatários existentes: os usuários que já receberam o cartão não recebem os cartões atualizados até que se tornem reelegíveis. Se a reelegibilidade estiver desativada, eles nunca recebem o novo cartão.
• Relatórios: uma Campaign contém todas as análises de dados dos relatórios para as versões de cartão lançadas. A Braze não diferencia entre as versões lançadas.

Digamos que você tem uma Campaign que é disparada pelo início de uma sessão e tem a 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, ele 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.

1. Abra a Campaign de Content Card e selecione Stop Campaign.
2. Quando solicitado, selecione Remove card after the next sync. O cartão será 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, a Braze processa o evento e então remove o cartão do feed do usuário.

Expiração de cartões

Os Content Cards permanecem disponíveis por até 30 dias a partir do momento em que são enviados; 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

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:

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 sincronizam em um cronograma e quando seu app atualiza o feed. O comportamento de sincronização difere entre sincronizações completas e parciais, e sua integração SDK afeta quando os cartões são atualizados no início da sessão. Em versões suportadas do SDK, a Braze também entrega envios e remoções durante uma sessão ativa por meio de 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. As contagens de impressões podem ser menores do que as contagens de envios porque os usuários não podem gerar impressões em cartões que são removidos antes de serem visualizados.

Solução de problemas

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

Para Campaigns de entrega baseada em ação (como início de sessão), há um breve atraso esperado entre o evento-gatilho e a disponibilidade do cartão. Esse atraso ocorre porque:

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

Em versões compatíveis do SDK, a entrega em tempo real envia o cartão ao dispositivo assim que a Braze o cria, de modo que o cartão chega durante a sessão atual. Em versões anteriores, o SDK busca o cartão na próxima sincronização, e uma sincronização que ocorre antes do registro da elegibilidade do usuário não retorna nada.

Para novos usuários em sua primeira sessão, esse atraso de processamento é inevitável. Para usuários existentes que precisam de disponibilidade instantânea, considere usar a entrega agendada.

Se você precisa minimizar atrasos tanto para novos quanto para usuários existentes, é possível criar duas Campaigns:

• Usuários existentes com contagem de sessões maior que 0: Use uma Campaign de entrega agendada. Os cartões são pré-criados e ficam disponíveis imediatamente.
• 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 primeiro evento-gatilho de sessão.

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

Por que os timestamps de impressão ou dispensa estão fora do cronograma da Campaign?

Os timestamps de impressão e dispensa em análise de dados e Currents refletem o momento em que um usuário visualiza ou dispensa um Content Card, não quando a Braze cria ou envia o cartão. Um cartão pode permanecer no feed do usuário até que os Content Cards sejam atualizados, então os timestamps de impressão e dispensa podem ocorrer após a janela de envio da Campaign.

Se os horários ainda parecerem inesperados:

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

Para saber mais sobre 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 Cards multivariante 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 para uma única variante, e depois salve novamente. Para saber como definir a expiração ao criar uma Campaign, consulte Escolher um cronograma de entrega ou evento-gatilho.