Copy Pastd

A Copy Pastd oferece o Building Blocks, um criador de e-mail de arrastar e soltar que envia Content Blocks com tecnologia Liquid e modelos completos diretamente para o seu espaço de trabalho da Braze. Crie o design uma vez, sincronize com a Braze e reutilize os mesmos componentes em Campaigns, Canvas e fluxos disparados sem precisar reconstruir o HTML a cada vez.

Essa integração é mantida pela Copy Pastd.

Sobre a integração

A integração entre a Braze e a Copy Pastd permite criar e-mails no Building Blocks — um criador de e-mail hospedado que produz saídas nativas da Braze com Liquid limpo, referências a Content Blocks e modelos que podem ser inseridos em qualquer Campaign ou Canvas sem necessidade de conversão.

Você pode montar um e-mail a partir de blocos reutilizáveis, enviá-lo para a Braze com um clique e ter a confiança de que os mesmos estilos de marca, componentes e conteúdo dinâmico serão renderizados de forma consistente em todos os envios. O resultado são menos modelos codificados manualmente, menos tempo gasto criando e enviando e-mails e uma biblioteca centralizada que se atualiza em todos os lugares quando é modificada.

Pré-requisitos

Os itens a seguir são necessários para usar esta integração:

Casos de uso

• Criação consistente com a marca em escala. Aplique uma folha de estilos do Building Blocks a cada modelo, e cores, fontes, estilos de botão e espaçamentos são renderizados de forma idêntica em centenas de e-mails. Quando a marca mudar, atualize a folha de estilos uma vez e sincronize para distribuir a atualização em todos os seus e-mails de uma só vez.
• Modelos de produto vinculados a Connected Content e Catalogs. Vincule campos de blocos de e-mail diretamente aos seus endpoints de Connected Content e Braze Catalogs de dentro do criador. Reutilize o mesmo modelo para lançamentos de novos produtos, coleções sazonais ou atualizações de conteúdo sem precisar mexer em Liquid.
• Produção de e-mails self-service para profissionais de marketing não técnicos. Componha um e-mail completo a partir de blocos aprovados, incluindo personalização e lógica em Liquid, e envie para a Braze para revisão sem precisar de suporte de desenvolvedores para escrever HTML ou Liquid ou revisar qualquer um dos dois.
• Cabeçalhos e rodapés centralizados, atualizados com um clique. Crie um cabeçalho ou rodapé uma vez no criador do Building Blocks e envie para a Braze. Cada modelo que faz referência a ele permanece sincronizado, então uma troca de logo, uma alteração de texto legal ou um novo link de rede social exige apenas uma atualização dentro do Building Blocks para ser aplicada em todos os e-mails já na Braze.
• Conteúdo centralizado em todos os e-mails. Crie um hero, rodapé ou cartão promocional uma vez como um bloco inteligente do Building Blocks. Atualize, sincronize, e cada e-mail já na Braze que faz referência a ele recebe a alteração no próximo envio. Fluxos de boas-vindas, newsletters semanais e jornadas disparadas permanecem atualizados sem precisar editar cada Campaign.
• Modelos bloqueados para contribuidores self-service. Crie modelos, bloqueie campos selecionados e convide outras equipes a criar seus próprios e-mails a partir de uma interface de contribuidor, sem conceder acesso a ferramentas voltadas ao usuário.

Integração

Etapa 1: Conectar o Building Blocks à Braze

Nota

Conectar o Building Blocks à Braze é uma configuração única. Depois que suas credenciais forem validadas, o Building Blocks salva as credenciais para todas as sincronizações e envios de modelos futuros.

1. Faça login no Building Blocks em blocks.copypastd.com, ou selecione Login em copypastd.com.
2. No dashboard, selecione Set up your Braze connection. (Essa pílula aparece para administradores no primeiro login e até ser concluída. Você também pode acessar a página em Team Settings > Connect > Braze API Keys.)
3. Selecione seu cluster da Braze no menu suspenso. O endpoint REST correspondente é preenchido automaticamente.
4. Cole sua chave de API de Templates, sua chave de API de Content Blocks e (opcionalmente) sua chave de API de Catalogs nos campos relevantes.
5. Selecione Validate and save. O Building Blocks faz uma chamada à Braze para confirmar que as chaves funcionam e que os escopos de permissão estão corretos. Se algo estiver faltando, um erro inline mostra qual escopo está incorreto.

Etapa 2: Sincronizar sua biblioteca com a Braze

1. Depois que as chaves forem validadas, selecione Sync now no modal de configuração. (Você também pode ressincronizar a qualquer momento em Settings > Connect > Braze > Sync library.)
   O Building Blocks envia sua folha de estilos e blocos para o seu espaço de trabalho da Braze como Content Blocks. Eles aparecem na Braze com nomes prefixados com CP_ (por exemplo, CP_Hero_1) ou cp_ para folhas de estilos (por exemplo, cp_default_style).
2. Após a conclusão da sincronização, você pode enviar modelos individuais do criador usando Push to Braze.

Personalizar Building Blocks

Etapa 1: Configurar sua folha de estilos

1. No Building Blocks, navegue até Settings > Build > Stylesheets.
2. Edite a folha de estilos padrão ou crie uma nova. Defina sua paleta de cores (24 cores nomeadas), fontes (compatível com Google Fonts), estilos de botão, estilos de link, raio e escala de espaçamento.
3. Selecione Save. O Building Blocks regenera o Liquid para cada bloco que usa essa folha de estilos.
4. Selecione Sync now para enviar os estilos atualizados ao seu espaço de trabalho da Braze.

Etapa 2: Ativar endpoints de Connected Content (opcional)

1. No Building Blocks, navegue até Settings > Connect > Connected Content endpoints.
2. Adicione a URL do endpoint, dê um nome e salve. O Building Blocks é compatível com o formato de resposta do Google Sheets, além do formato JSON padrão.
3. No criador, vincule qualquer campo de texto, imagem ou link a uma variável de Connected Content no painel Personalize. O Liquid {% connected_content %} correto é gerado na exportação.

Etapa 3: Vincular a catálogos da Braze (opcional)

1. No Building Blocks, navegue até Settings > Connect > Catalogs. O Building Blocks lê sua lista de catálogos usando a chave de API de catálogos.
2. Abra um bloco compatível (por exemplo, uma grade de produtos).
3. Selecione um catálogo e uma seleção, depois mapeie os campos do bloco para os atributos dos itens do catálogo.
4. Envie o modelo. O Building Blocks gera o Liquid {% catalog_items %} e {% catalog_selection_items %} correto para a Braze resolver no momento do envio.

Etapa 4: Adicionar seus atributos personalizados da Braze (opcional)

O Building Blocks já vem com os atributos de usuário padrão da Braze (first_name, email, country e assim por diante). Para vincular blocos aos seus próprios atributos personalizados, importe-os para o Building Blocks uma vez e eles ficarão disponíveis em todos os menus suspensos de Personalize.

1. No Building Blocks, navegue até Team Settings > Connect > Custom Attributes.
2. Importe seus atributos personalizados usando um dos seguintes métodos:
   • Importação em massa (recomendado). Na Braze, navegue até Data Settings > Custom Attributes e selecione Export. Faça o upload do CSV no Building Blocks.
   • Adicionar atributos um por vez. Digite o nome do atributo (por exemplo, loyalty_tier) e selecione Add. Esse método é útil se você está adicionando apenas alguns atributos ou se deseja adicionar um novo atributo entre exportações da Braze.

Depois de salvar, seus atributos personalizados aparecem no menu suspenso Personalize do criador, junto com os padrões. Ao inserir um atributo, o Liquid {{custom_attribute.${name}}} correto é gerado na exportação, para que a Braze resolva o valor por destinatário no momento do envio.

Usar a integração

Etapa 1: Enviar um modelo para a Braze

1. Abra qualquer e-mail no criador do Building Blocks.
2. Selecione Push to Braze na barra de ações.
3. Selecione o espaço de trabalho e confirme. O Building Blocks cria um modelo de e-mail na Braze com o Liquid renderizado.

O modelo aparece na Braze em Templates & Media > Email Templates, nomeado com base no e-mail e na data selecionada nas configurações do e-mail.

Etapa 2: Usar o modelo em uma Campaign ou Canvas

1. Na Braze, crie uma nova Campaign de e-mail ou etapa do Canvas.
2. Selecione Templates e escolha o modelo enviado pelo Building Blocks.

O modelo carrega todas as referências do Building Blocks (folha de estilos, Content Blocks) como Liquid ativo {{content_blocks.${...}}}, então as atualizações no Building Blocks são propagadas sem precisar reimportar o modelo.

Etapa 3: Atualizar conteúdo de forma centralizada

1. No Building Blocks, edite o bloco ou a folha de estilos relevante.
2. Selecione Sync para enviar o Content Block atualizado de volta para a Braze.

Todos os e-mails na Braze que fazem referência a ele (fluxos permanentes, disparados ou de boas-vindas) recebem a nova versão no próximo envio. Não é necessário editar cada Campaign individualmente.

Etapa 4: Criar pools de conteúdo

Pools de conteúdo são tabelas de linhas de conteúdo que os e-mails referenciam em vez de conter texto estático. Atualize o pool no Building Blocks, e todos os e-mails na Braze que o utilizam exibem o novo conteúdo no próximo envio. Use pools de conteúdo sempre que o mesmo conteúdo precisar se manter atualizado em vários e-mails, como newsletters semanais, fluxos de boas-vindas, sequências de recuperação, campanhas sazonais ou jornadas pós-compra.

1. No Building Blocks, selecione Content na navegação principal.
2. Selecione New Pool. Forneça um nome que descreva o que ele contém (por exemplo, Ofertas Semanais, Catálogo de Produtos, Artigos de Notícias).
3. Escolha o tipo de bloco que o pool alimenta (por exemplo, Hero, Grid, Card). Isso define quais campos estarão disponíveis em cada linha.
4. Adicione linhas. Cada linha é um conteúdo. Preencha os campos (título, imagem, texto do CTA, link do CTA e assim por diante).
5. Defina a ordem de prioridade arrastando as linhas para cima ou para baixo. Alterne cada linha entre ativa e inativa e defina datas de início e término opcionais. No momento do envio, a linha ativa de maior prioridade cujas datas sejam válidas é a escolhida.
6. Clique em Save. Os blocos inteligentes agora podem referenciar esse pool.

Etapa 5: Usar blocos inteligentes para renderizar conteúdo do pool nos seus e-mails

Um bloco inteligente é um bloco no canvas do criador que referencia um ou mais pools de conteúdo em vez de conter conteúdo estático. No momento do envio, a Braze renderiza a linha do pool que tem a maior prioridade, está ativa e tem datas válidas. O Liquid exportado faz todo o trabalho. Nenhuma configuração adicional na Braze é necessária.

1. No Building Blocks, arraste um bloco inteligente para o canvas (qualquer tipo de bloco que tenha um pool correspondente).
2. No painel de propriedades, abra o editor de cascata.
3. Adicione um ou mais pools de conteúdo em ordem de prioridade. Essa é a cascata (Waterfall): o primeiro pool com uma linha ativa e com datas válidas é renderizado. Se não houver nenhuma linha ativa, o bloco inteligente passa para o próximo pool, e depois para o seguinte. Um padrão comum é Promoção Relâmpago > Ofertas Semanais > Favoritos Permanentes, para que sempre haja algo disponível.
4. Envie o modelo para a Braze. O Liquid exportado carrega a cascata completa, então a Braze avalia a prioridade do pool e as datas a cada envio.

A partir de agora, você atualiza o pool, não o e-mail. Fluxos disparados, newsletters permanentes e campanhas sazonais permanecem atualizados enquanto o pool estiver atualizado.

Encontre seus modelos do Building Blocks enviados na Braze em Templates & Media > Email Templates. Folhas de estilo e blocos sincronizados aparecem em Templates & Media > Content Blocks.

Considerações

• Uma instância da Braze por espaço de equipe do Building Blocks. Cada equipe do Building Blocks se conecta a uma única instância da Braze. Clientes que utilizam múltiplos espaços de trabalho (marcas, regiões ou ambientes separados) podem adicioná-los à mesma equipe, o que permite o compartilhamento de blocos.
• As permissões de chave de API são definidas separadamente. As chaves de modelos e as chaves de Content Blocks são mantidas separadas. A validação falha rapidamente se uma chave não tiver um escopo necessário, para que você saiba exatamente qual permissão adicionar na Braze.
• Os nomes dos Content Blocks são organizados por namespace. O Building Blocks envia Content Blocks com os prefixos CP_ (blocos) e cp_ (folhas de estilo) para evitar conflitos com Content Blocks criados diretamente na Braze.
• Edições em folhas de estilo atualizam todos os e-mails. As folhas de estilo são renderizadas como um único Content Block da Braze referenciado por todos os modelos. Uma alteração no Building Blocks atualiza todos os e-mails na Braze que a utilizam, incluindo aqueles já agendados. Teste as alterações de folha de estilo em um modelo de rascunho antes de sincronizar.
• A vinculação de catálogo é somente leitura. O Building Blocks lê catálogos para preencher a interface de vinculação. Ele não grava nos Catálogos da Braze. Todo o gerenciamento de catálogos ainda acontece no dashboard da Braze.
• Limites de frequência e novas tentativas. Todas as requisições de saída respeitam os limites de frequência da Braze, com backoff exponencial, jitter e tratamento de Retry-After. Um cabeçalho User-Agent: partner-CopyPastd é enviado em cada chamada para atribuição de parceiro.
• Nenhum dado de usuário é transmitido. O Building Blocks é uma ferramenta de criação de conteúdo. Ele não envia atributos de usuário, eventos, compras ou dados de Segment para a Braze, e não consome pontos de dados da Braze.

Solução de problemas

• A validação da chave de API falha. Verifique se cada chave possui exatamente as permissões listadas nos Pré-requisitos. Os escopos de modelos e Content Blocks são verificados separadamente. Se você regenerar uma chave na Braze, cole o novo valor no Building Blocks e revalide.
• Incompatibilidade do endpoint REST. As chaves de modelos e Content Blocks devem pertencer ao mesmo espaço de trabalho da Braze, e o endpoint REST deve corresponder ao cluster. O menu suspenso do Building Blocks define isso automaticamente, então verifique a seleção do cluster se a validação falhar.
• O envio para a Braze retorna um erro. Abra Settings > Build > Activity log para ver a última tentativa de sincronização e a resposta retornada pela Braze. A maioria das falhas está relacionada a permissões (escopo ausente) ou a cotas (limite de frequência, com nova tentativa automática).
• O Content Block não está sendo atualizado na Braze. Acione uma ressincronização manual em Settings > Connect > Braze > Sync library. O Building Blocks realiza uma comparação antes da substituição, então blocos sem alterações são ignorados.
• O modelo faz referência a um Content Block que ainda não existe na Braze. Envie as dependências primeiro (folha de estilos, smart blocks) usando Sync library e, em seguida, envie o modelo.
• Para qualquer outro problema. Entre em contato com a Copy Pastd em [email protected]. Inclua o nome da sua equipe e o horário da ação que falhou para que a Copy Pastd possa localizar o registro de atividade correspondente.