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
Existem 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 de acordo com 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), traços (-) 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 em 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 respeitadas.


Os Content Blocks adicionados ao arrastar e soltar não estão vinculados ao Content Block original. Para ver as alterações feitas no original, arraste-o novamente para o editor de e-mail.
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 Liquid tag do Content Block na seção Detalhes do Content Block.
- Insira a Liquid tag do Content Block na mensagem. Você também pode começar a digitar o Liquid e deixar que a tag seja 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 de Liquid em um bloco de editor de texto.


Os Content Blocks inseridos via Liquid estão vinculados ao Content Block original e refletirão quaisquer alterações no modelo.
Prévia de Content Blocks
Depois de adicionar um Content Block em uma Campaign ou Canvas ativo, você pode ver uma prévia dele na Biblioteca de Content Blocks. Basta passar o mouse sobre o Content Block e selecionar o ícone Prévia.
Essa prévia mostra 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 e contagem de inclusões com detalhes (uma lista clicável das mensagens ou Content Blocks que usam o Content Block). Ela também exibe uma prévia real do Content Block.

Ao auditar onde um Content Block é usado, revise cada mensagem ou etapa vinculada individualmente para confirmar o status.
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 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ê usa 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 grande escala, as mensagens multilíngues são mais adequadas do que links condicionais em um único Content Block.
Atualizar e copiar Content Blocks
Se você optar por atualizar um Content Block, ele será atualizado em todas as mensagens em que o Content Block estiver inserido via Liquid. Se o Content Block for importado usando o menu suspenso Content Blocks em Linhas no editor de arrastar e soltar, ele não será atualizado em todas as mensagens.
Para atualizar um Content Block em uma única mensagem ou fazer uma cópia para usar em outras mensagens, você tem duas opções. Você pode copiar o HTML da mensagem original para a nova. Ou pode editar o Content Block original (ele precisa já ter sido usado em uma mensagem) e salvá-lo. Então, você verá uma solicitação que permite salvá-lo como um novo Content Block.
Depois de editar um Content Block, você pode salvar e lançar o Content Block atualizado selecionando Lançar Content Block. Ou pode selecionar Mais > Duplicar para criar uma duplicata do seu Content Block.

Rastrear alterações nos Content Blocks
Cada Content Block registra quando foi criado e editado pela última vez. Assim, você pode 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 carimbos de data/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. Portanto, recomendamos salvar uma cópia antes de fazer alterações significativas. Para salvar uma cópia, selecione Mais > Duplicar. A duplicata é 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, então 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
- Quando o bloco for usado em apenas alguns e-mails, recomendamos arquivar o bloco desatualizado e atualizar suas mensagens ativas com um bloco mais recente que não tenha sido arquivado.
- Quando o bloco tiver apenas um erro de digitação ou precisar de uma pequena alteração, não recomendamos arquivá-lo. Em vez disso, atualize o bloco e continue enviando!
- Quando o bloco for usado em mais mensagens do que você consegue gerenciar com a primeira sugestão desta lista, recomendamos remover todo o conteúdo do bloco. Isso evita que informações desatualizadas sejam incluídas em qualquer mensagem.
- Se você arquivar um Content Block por engano, é possível desarquivá-lo.
