Ir para o conteúdo

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 no agendamento da entrega da mensagem.

Etapa 1: Escolha onde criar sua mensagem

Use Campaigns para mensagens únicas 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).

  1. Acesse Envio de mensagens > Campaigns e selecione Criar Campaign.
  2. Selecione Content Cards ou, para Campaigns direcionadas a vários canais, selecione Multicanal.
  3. Dê à sua Campaign um nome claro e significativo.
  4. Adicione equipes e tags conforme necessário.
    • As tags facilitam encontrar suas Campaigns e criar relatórios a partir delas. Por exemplo, ao usar o Criador de relatórios, você pode filtrar pelas tags relevantes.
  5. Adicione e nomeie quantas variantes quiser para sua Campaign. Você pode escolher diferentes plataformas, tipos de mensagem e layouts para cada uma das variantes adicionadas. Para saber mais sobre variantes, consulte Testes multivariantes e Testes A/B.
  1. Crie seu Canvas usando o criador do Canvas.
  2. Depois de configurar seu Canvas, adicione uma etapa de Mensagem no construtor do Canvas. Dê à sua etapa um nome claro e significativo.
  3. Selecione Content Cards como seu canal de envio de mensagens.
  4. Escolha quando a Braze calcula a elegibilidade do público e a personalização para o cartão de conteúdo. Isso pode acontecer na entrada da etapa ou na primeira impressão (recomendado). As etapas que contêm Content Cards podem ser agendadas ou baseadas em ação.
  5. Escolha se os Content Cards devem ser removidos quando os usuários concluírem uma compra ou realizarem um evento personalizado.
  6. Defina uma expiração para o cartão de conteúdo (tempo no feed). Isso pode ser após um período de tempo ou em um horário específico.
  7. Filtre seu público, ou os destinatários, para esta etapa conforme necessário em Configurações de entrega. Você pode refinar ainda mais seu público especificando Segments e adicionando outros filtros. As opções de público são verificadas após a postergação, no momento em que as mensagens são enviadas.
  8. Escolha 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: Clássico, Imagem com legenda e Somente imagem.

Para saber mais sobre o comportamento e a aparência de cada tipo, consulte Detalhes do criativo ou confira os links na tabela a seguir. Esses tipos de Content Card são aceitos tanto por apps móveis quanto por aplicativos web.

Tipo de mensagem Exemplo Descrição
Clássico Um Content Card clássico com um pequeno ícone e um texto incentivando a reserva de uma aula de treino. O cartão clássico tem um layout simples, com um título em negrito, o 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 Um Content Card com legenda, com a imagem de uma pessoa levantando peso e um texto incentivando a reserva de uma aula de treino. O cartão de imagem com legenda destaca seu conteúdo com texto e uma imagem que chama a atenção.
Somente imagem Um Content Card do tipo 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.

Exemplo de detalhes de um Content Card 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 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.

Uma janela com inglês, espanhol e francês selecionados como idiomas, e título, descrição e texto do link selecionados como campos a serem internacionalizados.

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 Criar mensagens da direita para a esquerda.

Título e mensagem

Mantenha títulos e mensagens claros e concisos para que os usuários entendam a oferta e ajam rapidamente. Título, mensagem, texto do link, URLs de imagem, URLs de link e pares de valores-chave compartilham um limite de carga útil de 2 KB depois que a personalização com Liquid é renderizada. Textos mais longos deixam menos espaço para URLs e outros conteúdos do cartão. Esses campos não estão disponíveis para cartões Somente imagem.

Para ver os comprimentos de linha e as proporções de imagem recomendados por tipo de cartão, consulte Detalhes criativos.

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 enviada anteriormente ou adicionar uma nova.

Cada tipo de mensagem e plataforma pode ter proporções e requisitos próprios, então confira quais são antes de encomendar ou criar uma nova imagem. As strings de URL de imagem também contam para o limite de carga útil 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 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.

Prévia lado a lado do Content Card na Braze para mobile e web, com a opção "Fixar este cartão no topo do feed" selecionada.

Comportamento ao clicar

Quando seu cliente clica em um link apresentado no cartão, o link pode levá-lo a uma parte mais profunda do seu app ou a 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 um 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 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 a classificação dos cartões.

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

Etapa 5: Criar o restante da sua Campaign ou Canvas

Crie o restante da sua Campaign. Confira as próximas seções para saber como usar nossas ferramentas da melhor forma ao criar Content Cards.

Escolher um cronograma de entrega ou gatilho

Os Content Cards podem ser entregues em um horário agendado, a partir de uma ação ou por um gatilho de API. Para saber mais, consulte Agendar 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 o número de dias até o cartão expirar, com limite de 30 dias. Todas as variantes devem usar a mesma expiração (duração ou horário específico).

A contagem regressiva da expiração começa no momento do envio do cartão:

  • Campaigns agendadas: A contagem regressiva começa no horário de lançamento agendado.
  • Campaigns baseadas em ação: A contagem regressiva começa quando o usuário realiza a ação de gatilho.

Por exemplo, se um Content Card baseado em ação for enviado hoje às 14h com expiração de 1 dia, ele expira às 14h do dia seguinte.

Na entrega baseada em ação, é esperada uma pequena postergação antes de o Content Card aparecer. Para entender por que isso acontece e como minimizar esse atraso, consulte Por que os Content Cards não aparecem imediatamente após um evento-gatilho?.

Entrega agendada

Em Campaigns de Content Cards com entrega agendada, você pode escolher quando a Braze avalia a elegibilidade do público e a personalização especificando quando o cartão é criado. Para saber mais, consulte Criação de cartões.

Escolher os usuários para direcionamento

Em seguida, direcione os usuários escolhendo Segments ou filtros para restringir seu público. Você recebe automaticamente uma prévia do tamanho aproximado da população desse Segment. Lembre-se de que a associação exata ao Segment é sempre calculada antes do envio da mensagem.

Escolher eventos de conversão

A Braze permite rastrear com que frequência os usuários realizam ações específicas, os eventos de conversão, depois de receber uma Campaign. Você pode definir uma janela de até 30 dias durante a 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 do Canvas. Para saber como criar o restante do seu Canvas, incluindo testes multivariantes e Otimizar com BrazeAITM, consulte Criar seu Canvas.

Etapa 6: Revise e implemente

Depois de terminar de criar sua Campaign ou seu 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 Campaigns de Content Cards.

Informações importantes

Limitações de carga útil e de 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 de dados completa de um único Content Card não pode exceder 2 KB depois que a personalização com Liquid é 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 da Campaign exibe um alerta se o seu conteúdo estático ultrapassar o limite. Não fazemos a previsão do tamanho de conteúdo dinâmico que usa Liquid. Se o tamanho da mensagem ultrapassar 2 KB, ela será interrompida no momento do envio. Você pode ver essas interrupções em Messaging Observability 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. Usar um serviço de encurtamento de URL pode reduzir bastante a contagem de caracteres e liberar espaço na carga útil.
  • Corte o conteúdo dinâmico com Liquid. Ao personalizar cartões com texto dinâmico vindo de atributos de usuário ou chamadas de API, o comprimento do conteúdo pode ser imprevisível. Use filtros Liquid como truncate de forma proativa 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 Banners para conteúdos mais ricos. Para casos de uso que sempre exigem grandes volumes de conteúdo, os Content Cards podem não ser o canal certo. 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 de um app ou website.

Número de cartões no feed

Cada usuário pode ter até 250 Content Cards não expirados no feed a qualquer momento. 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 as seguintes 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.
  • 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 encher o feed com cartões demais ao longo do tempo.

Entendendo a elegibilidade para reentrada nos Content Cards

A elegibilidade para reentrada 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 elegibilidade para reentrada é calculada

Se você ativar a elegibilidade para reentrada, a contagem regressiva para quando um usuário pode “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 elegibilidade para reentrada.
  • Content Cards criados no lançamento da Campaign, em Campaigns multicanal ou na entrada da etapa do Canvas usam o que ocorrer por último entre o horário de envio e o horário da impressão.

A expiração de 30 dias e a elegibilidade para reentrada

Uma fonte comum de confusão é a interação entre a elegibilidade para reentrada 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 elegibilidade para reentrada desativada, um usuário ainda pode receber o mesmo cartão novamente após 30 dias. Quando o cartão original é excluído, o sistema deixa de ver um registro de que aquele usuário recebeu a Campaign. Então, ele volta a ser elegível 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 (de forma parecida com o que acontece com e-mails). Depois que o conteúdo é inserido no Content Card (no momento da exibição), ele não pode ser alterado durante a vida útil do cartão. Isso vale mesmo que você esteja chamando uma API pelo Connected Content e os dados do endpoint mudem. Esses dados não são atualizados. Só é possível impedir que o cartão seja enviado a novos usuários e removê-lo dos feeds dos usuários. Se você modificar uma Campaign, apenas os cartões enviados após a modificação incluirão a atualização.

Atualizando cartões lançados

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

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 como 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 análises de dados separadas.

Digamos que você configure uma Campaign para ser disparada pelo início de sessão, com elegibilidade para reentrada definida como 30 dias. Um usuário recebeu a Campaign há dois dias, e você quer alterar o texto. Primeiro, arquive a Campaign e remova os cartões do feed. Depois, duplique a Campaign e relance-a 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 todas as suas análises de dados unificadas em uma única Campaign. Usuários que se tornarem 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 sua Campaign conforme necessário.
  3. Reinicie sua 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 elegibilidade para reentrada estiver desativada, eles nunca recebem o novo cartão.
  • Relatórios: Uma única Campaign contém todas as análises de dados dos relatórios das versões lançadas do cartão. A Braze não diferencia as versões lançadas.

Digamos que você tenha uma Campaign disparada pelo início de sessão, com elegibilidade para reentrada definida como 30 dias. Um usuário recebeu a Campaign há dois dias, e você quer alterar o texto. Primeiro, interrompa a Campaign e remova o cartão do feed. Depois, publique novamente a Campaign 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 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, em seguida, remove o cartão do feed dele.

Painel de condições de remoção de Content Card com a opção de evento de remoção de Content Card.

Expiração de cartões

Os Content Cards ficam 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 exclui dos sistemas da Braze.

Fazendo os 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 substitui o cartão a cada 30 dias:

  1. Defina a duração do Content Card como 30 dias.
  2. Defina a elegibilidade para reentrada da Campaign como 30 dias.
  3. Defina 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 sua integração SDK afeta quando os cartões são atualizados no início da sessão. Em 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. As contagens de impressões podem ser menores que as contagens de envios, porque os usuários não conseguem gerar impressões de 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?

Em Campaigns de entrega baseada em ação (como início de sessão), é esperada uma pequena postergação entre o evento-gatilho e a disponibilização do cartão. Essa postergação 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 de SDK compatíveis, 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 acontecer antes do registro da elegibilidade do usuário, ela não retorna nada.

Para novos usuários na primeira sessão, essa postergação de processamento é inevitável. Para usuários existentes que precisam de disponibilidade instantânea, considere usar a entrega agendada.

Se você precisar minimizar postergações 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 de entrega agendada. Os cartões são criados previamente 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 gatilho da primeira sessão.

Essa abordagem garante que os usuários existentes vejam os cartões instantaneamente e, ao mesmo tempo, alcança os novos usuários após uma breve postergação na primeira sessão. Para mais estratégias de melhoria da 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 permanecer no feed do usuário até que os Content Cards sejam atualizados. Por isso, os registros de data e hora de impressão e dispensa podem ser posteriores à 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 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 várias 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.

New Stuff!