Blocos de conteúdo
Os blocos de conteúdo permitem que você gerencie conteúdo reutilizável e multicanal em um único local centralizado. Use-os para criar uma aparência consistente em suas campanhas, distribuir os mesmos códigos de oferta por diferentes canais ou criar ativos predefinidos para envio de mensagens consistente em escala. Você também pode criar e gerenciar seus blocos de conteúdo usando a API.
Criar um Content Block
Há dois tipos de Content Blocks: arrastar e soltar e HTML. Cada tipo corresponde ao seu editor.
- Acesse Content > Content Block. Selecione Create Content Block e selecione Drag-and-drop Content Block.
- Arraste e solte os blocos do editor para construir um Content Block de arrastar e soltar.
- Arraste e solte um bloco de formato da guia Rows no editor para criar o layout do seu Content Block.

- Adicione Content Blocks de arrastar e soltar conforme necessário para construir suas campanhas de e-mail.
- Depois de criar seu Content Block, selecione Done.
- Dê um nome ao seu Content Block. Esse nome será preenchido automaticamente como parte da Content Block Liquid Tag.
- (Opcional) Adicione uma descrição.
- Selecione a guia Preview para ver como seu Content Block aparecerá. Opcionalmente, selecione Copy preview link para gerar e copiar um link de prévia compartilhável que mostra como o e-mail ficará para um usuário aleatório. O link terá validade de sete dias antes de precisar ser gerado novamente.

- Selecione Launch Content Block.

Cada Content Block de arrastar e soltar é limitado a uma linha. No entanto, você pode usar os blocos do editor de arrastar e soltar para criar e personalizar o Content Block conforme as suas mensagens de e-mail.
- Acesse Content > Content Block. Selecione Create Content Block e selecione HTML code editor.
- Insira seu HTML na guia HTML ou construa seu Content Block na guia Classic.

- Depois de criar seu Content Block, selecione Done.
- Digite um nome para o seu Content Block. Esse nome será preenchido automaticamente como parte da Content Block Liquid Tag.
- (Opcional) Adicione uma descrição.
- Selecione a guia Preview para ver como seu Content Block aparecerá. Opcionalmente, selecione Copy preview link para gerar e copiar um link de prévia compartilhável que mostra como o e-mail ficará para um usuário aleatório. O link terá validade de sete dias antes de precisar ser gerado novamente.

- Selecione Launch Content Block.
Especificações do Content Block
| Atributo do Content Block | Especificações |
|---|---|
| Nome | Campo obrigatório com no máximo 100 caracteres. Os nomes de Content Blocks podem conter apenas letras (A-Z), números (0-9), hifens (-) e sublinhados (_). Espaços e outros caracteres especiais não são permitidos e são convertidos automaticamente (por exemplo, espaços são substituídos por sublinhados). Os nomes não podem ser alterados depois que o Content Block é salvo, e você não pode reutilizar o nome de um Content Block anterior, mesmo que esteja arquivado. |
| Descrição | (opcional) No máximo 250 caracteres. Descreva o Content Block para que outros usuários da Braze saibam para que ele serve e onde é usado. |
| Tamanho do conteúdo | No máximo 50 KB. |
| Posicionamento | Os Content Blocks não podem ser usados no rodapé de um e-mail, mas você pode criar um Content Block que inclua um rodapé para usar nos seus e-mails. |
| Criação | Editor de HTML ou editor de arrastar e soltar. |

Ao criar Content Blocks, pode ser útil visualizar o HTML e o Liquid adicionando quebras de linha. Se essas quebras de linha forem mantidas durante o envio, você corre o risco de ter espaços extras que podem afetar a renderização do bloco. Para evitar isso, use a tag Capture no seu bloco junto com o filtro | strip.
{% capture your_variable %}
{{content_blocks.${your_content_block}}}
{% endcapture %}{{your_variable | strip}}
Usar Content Blocks
Depois de criar seu Content Block, você pode inseri-lo nas suas mensagens usando o editor ou Liquid.
Usar o editor de arrastar e soltar
Para adicionar um Content Block no editor de arrastar e soltar:
- Acesse a guia Linhas no editor e selecione Content Blocks.
- Arraste e solte seu Content Block no editor de e-mail.
- (Opcional) Ajuste a largura do seu Content Block selecionando o botão no menu de navegação. A largura padrão é 100% quando não especificada nas configurações de estilo global do e-mail. Caso contrário, as configurações globais serão aplicadas.


Lançar uma edição posterior não atualiza um Content Block adicionado pela guia Linhas. Arraste o Content Block novamente para substituí-lo pela versão lançada. Consulte Quando as edições do Content Block são aplicadas.
Pode ocorrer desalinhamento no editor de arrastar e soltar quando vários Content Blocks são adicionados a um único bloco de linha. Tente usar blocos de linha separados para manter o alinhamento do seu conteúdo no nível da linha.
Usar Liquid
Para inserir um Content Block usando Liquid:
- Copie a Tag Liquid do Content Block na seção Detalhes do Content Block.
- Insira a tag Liquid do Content Block na mensagem. Você também pode começar a digitar o Liquid e deixar a tag ser preenchida automaticamente.
No editor de arrastar e soltar, você também pode adicionar um Content Block pelo painel Personalização:
- Acesse sua campanha de e-mail e selecione Editar corpo do e-mail.
- Clique em Personalização.
- Selecione Content Blocks no menu suspenso Tipo de personalização.
- Selecione o nome do seu Content Block no campo Atributo.
- Copie e cole o snippet Liquid em um bloco de editor de texto.


Um Content Block adicionado com uma tag Liquid usa a versão lançada mais recente no próximo envio da mensagem. Para saber mais, consulte Quando as edições do Content Block são aplicadas.
Prévia de Content Blocks
Depois de adicionar um Content Block em uma campanha ou Canvas ativo, você pode visualizá-lo pela biblioteca de Content Blocks. Para isso, passe o mouse sobre o Content Block e selecione o ícone Prévia.
Essa prévia traz informações sobre o Content Block, como quem o criou, tags, data de criação, data da última edição, descrição, tipo de editor, contagem de inclusões e uma prévia real do Content Block. Em Inclusões, selecione Ver detalhes para abrir a lista de mensagens, etapas do Canvas, modelos e Content Blocks que incluem esse bloco com uma Liquid tag.

Ao auditar onde um Content Block é usado, revise cada mensagem ou etapa vinculada individualmente para confirmar o status dela.
Aninhar Content Blocks
Os Content Blocks podem ser aninhados, mas apenas uma vez. Você pode aninhar o Content Block A no Content Block B, mas não pode depois aninhar o Content Block B no Content Block C.

Nada impede que você aninhe um terceiro nível de Content Block, mas o conteúdo não será expandido em aninhamentos além do segundo. O conteúdo e o snippet de Liquid são removidos da mensagem.
Os links dentro de um Content Block aninhado contam para o total de links da mensagem principal. Se você usar um único Content Block com muitos links condicionais, como URLs específicas de cada país para localização, a mensagem principal pode acumular um grande número de links. Isso pode deixar o salvamento de um Canvas mais lento ou até impedi-lo. Para localização em larga escala, as mensagens multilíngues são uma opção melhor do que links condicionais em um único Content Block.
Se um Content Block aninhado não estiver sendo renderizado como esperado, confirme se ele está aninhado em apenas um nível. Depois, consulte O que você precisa saber para conhecer outras causas de problemas de renderização. Selecione Prévia da mensagem como usuário para confirmar que os blocos aninhados são resolvidos antes do envio. Para ver as etapas, consulte Prévia da personalização.
Atualizar e copiar Content Blocks
Quando as edições do Content Block são aplicadas
Ao lançar um Content Block, a edição é publicada em todas as mensagens, etapas do Canvas, modelos e Content Blocks da lista de Inclusões dele. Um item entra nessa lista quando inclui o Content Block com uma Liquid tag. Esses itens usam a versão lançada no próximo envio, inclusive Campaigns agendadas e etapas de mensagem do Canvas que ainda não foram enviadas. Uma mensagem que já foi enviada mantém o conteúdo daquele envio. Uma edição salva como rascunho não entra nos envios.
Para ver a lista de Inclusões de um Content Block:
- Acesse Conteúdo > Content Block.
- Na coluna Contagem de inclusões, selecione o número do Content Block. O número só funciona como link quando o Content Block tem pelo menos uma inclusão.
Você também pode selecionar o nome do Content Block, rolar até a seção Inclusão e selecionar Ver detalhes.
Para publicar uma edição, selecione Lançar Content Block.
| Como o Content Block foi adicionado | Efeito de lançar uma edição |
|---|---|
| Liquid tag do Content Block | A mensagem aparece na lista de Inclusões e usa a versão lançada no próximo envio. Para impedir que uma mensagem receba edições futuras, substitua a Liquid tag do Content Block por uma cópia do conteúdo do bloco. |
| Guia Linhas no editor de arrastar e soltar | A mensagem mantém a versão que foi arrastada e não aparece na lista de Inclusões. Arraste o Content Block novamente para substituí-lo pela versão lançada. |
Para salvar uma cópia separada desse Content Block, selecione Mais > Duplicar. A cópia é salva como rascunho e não aparece na lista de Inclusões desse Content Block. As mensagens que usam o Content Block original continuam usando esse bloco. As Liquid tags dentro da cópia aparecem nas listas de Inclusões dos respectivos Content Blocks.
Ao duplicar uma mensagem, cada Content Block é mantido da forma como foi adicionado. As Liquid tags continuam vinculadas, e um bloco adicionado pela guia Linhas continua sendo uma cópia. Para ver as etapas, consulte Duplicar Campaigns e Canvas.

Acompanhar alterações nos Content Blocks
Cada Content Block registra quando foi criado e editado pela última vez, para que você possa verificar se ele mudou recentemente:
- Dashboard: A prévia do Content Block mostra quem criou o Content Block, a data de criação e a data e hora da última edição.
- API: Os endpoints
/content_blocks/infoe/content_blocks/listretornam os registros de data e horacreated_atelast_editedde cada Content Block.
Esses são os únicos detalhes de edição disponíveis para Content Blocks. Não é possível visualizar ou recuperar versões anteriores, por isso recomendamos salvar uma cópia antes de fazer alterações significativas. Para salvar uma cópia, selecione Mais > Duplicar. A cópia é salva como rascunho e não afeta as mensagens que usam o Content Block original.
Usar rodapés de e-mail em blocos de conteúdo
Os blocos de conteúdo não podem ser usados em um rodapé de e-mail, mas você pode criar um bloco de conteúdo que inclua conteúdo de rodapé para uso em seus e-mails. Para fazer isso:
- Acesse Configurações > Preferências de e-mail > Rodapé personalizado e crie o rodapé.
- Adicione o rodapé a um bloco de conteúdo na Biblioteca de blocos de conteúdo.
- Adicione esse bloco de conteúdo aos seus modelos de e-mail ou mensagens.
Informações importantes
- Usar Content Blocks HTML em e-mails do editor de arrastar e soltar, ou Content Blocks do editor de arrastar e soltar em e-mails HTML, pode causar problemas inesperados de renderização. Isso acontece porque o editor de arrastar e soltar gera HTML e CSS que renderizam o conteúdo de forma dinâmica, enquanto o editor de HTML é mais estático.
- Se você inserir um Content Block do editor de arrastar e soltar usando Liquid, a Braze não inclui os estilos do
<head>HTML do bloco. Estilos responsivos, como CSS específico para dispositivos móveis, podem não renderizar como esperado. Se o bloco depender de CSS responsivo, adicione esse CSS à mensagem ou ao modelo que inclui o Content Block. - As propriedades de entrada do Canvas só são compatíveis com Canvas. Se você fizer referência a um Content Block com propriedades de entrada do Canvas em uma Campaign, elas não serão preenchidas.
- Se uma mensagem com vários Content Blocks não estiver renderizando como esperado (por exemplo, quando Liquid tags ou HTML aparecem como texto visível em vez de serem processados), a causa costuma ser uma tag não fechada ou outro erro em um dos Content Blocks. Para identificar a origem:
- Remova os Content Blocks da mensagem afetada, um de cada vez.
- Verifique se a mensagem renderiza corretamente após cada remoção.
- O último Content Block removido antes de o problema desaparecer é o que está causando o problema.
- Por padrão, as tags HTML
<code>são renderizadas em fonte monoespaçada na maioria dos clientes de e-mail, independentemente de qualquer estilo de fonte definido no Content Block. Evite envolver texto em tags<code>, a menos que você queira essa aparência monoespaçada. - Quando você insere um Content Block com Liquid em um modelo de e-mail HTML personalizado, as regras de CSS do modelo principal podem substituir os estilos definidos dentro do Content Block. Para saber mais, consulte Content Blocks em modelos HTML personalizados.
Arquivar Content Blocks

Quando terminar de usar um Content Block, você pode arquivá-lo na página Modelos. Content Blocks arquivados são somente leitura. Por isso, desarquive o Content Block antes de editá-lo. Não é possível arquivar Content Blocks que estejam sendo usados em alguma mensagem.
Melhores práticas
- Se o seu bloco é usado em poucos e-mails, recomendamos arquivar o bloco desatualizado e atualizar suas mensagens ativas com um bloco mais recente que não tenha sido arquivado.
- Se o seu bloco tem apenas um erro de digitação ou precisa de uma pequena alteração, não recomendamos arquivá-lo. Em vez disso, atualize o bloco e continue enviando!
- Se o seu bloco é usado em mais mensagens do que você consegue gerenciar com a primeira sugestão desta lista, recomendamos remover todo o conteúdo do bloco. Assim, você evita incluir informações desatualizadas em qualquer mensagem.
- Se você arquivar um Content Block por engano, pode desarquivá-lo.
