Hospedar as imagens dos e-mails exportados

Você pode hospedar por conta própria as imagens exportadas ou deixar que o Emailify faça o upload delas automaticamente para a nossa CDN.

Usar a CDN de hospedagem de imagens do Emailify (padrão) ​

Nas exportações HTML, por padrão, o Emailify exporta seus e-mails HTML com as imagens salvas ao lado dos arquivos .html, para que você faça o upload delas onde quiser.

Mas, se quiser usar a CDN (rede de distribuição de conteúdo) do Emailify para hospedar suas imagens, ative a opção Upload Hosted Image URLs. Isso faz o upload das imagens e troca automaticamente as URLs no seu e-mail HTML para apontar para os arquivos enviados.

Se você usa alguma das integrações com plataformas de e-mail marketing incluídas no plugin, suas imagens são enviadas automaticamente para a CDN do Emailify.

Por que uma imagem hospedada pode ser maior que o arquivo original ​

O Emailify renderiza os bytes da imagem usados pelo e-mail exportado e otimiza o PNG ou JPG gerado antes de adicionar esse mesmo arquivo à exportação e, quando ativado, fazer o upload dele. A hospedagem muda a URL; ela não aplica uma etapa de compressão separada.

Como o Figma fornece os bytes renderizados da exportação, e não o arquivo original enviado, o arquivo hospedado não é uma cópia byte a byte do JPG ou PNG original. O tamanho pode ser diferente, inclusive maior. Para reduzir o resultado, use uma camada de origem com o tamanho adequado e um formato de imagem apropriado antes de exportar; o Emailify não consegue preservar os bytes exatos de compressão do arquivo original nesse fluxo de trabalho.

Fazer upload das imagens para o seu próprio bucket de armazenamento em nuvem ​

Por padrão, o Emailify usa a CDN (rede de distribuição de conteúdo) do Emailify para hospedar suas imagens, mas, se quiser, você pode trocá-la pelo bucket do seu próprio serviço de armazenamento em nuvem (por exemplo, AWS S3 ou Backblaze B2).

Depois de selecionar o serviço de hospedagem de imagens que quer usar, informe as credenciais e os dados do bucket abaixo. Durante a exportação, as imagens são enviadas automaticamente para o seu bucket (e o caminho das imagens no bucket é usado nos atributos src das tags HTML <img>):

  • Region (por exemplo, us-east-1)
  • Access Key (por exemplo, 003g8...)
  • Secret Access Key (por exemplo, K454q...)
  • Bucket Name (por exemplo, my-emailify-bucket)
  • Bucket URL (por exemplo, https://my-emailify-bucket.s3.us-east-1.amazonaws.com/)

Verifique se os buckets que você criar estão configurados com permissão de visualização Public; caso contrário, as URLs das imagens enviadas não ficarão acessíveis quando o e-mail HTML for enviado

Endereços do Cloudflare R2 ​

O R2 usa dois endereços separados. Informe os dois nas configurações de hospedagem de imagens:

  • S3 API endpoint: copie o endpoint da sua conta da Cloudflare, como https://accountid.r2.cloudflarestorage.com. Mantenha qualquer segmento de jurisdição mostrado pela Cloudflare, como .eu. Informe o nome do bucket em R2 Bucket Name.
  • Public image URL: use um domínio personalizado conectado ao bucket, como https://images.example.com/, ou a URL pública r2.dev ativada para ele. O S3 API endpoint exige autenticação e não pode ser usado como URL pública das imagens em um e-mail.

Se você já tinha salvo o S3 API endpoint no campo de URL, o Emailify o move para S3 API endpoint. Adicione a URL pública das imagens antes de exportar de novo. Se você já tinha salvo um domínio público, ele é mantido; adicione o API endpoint separado se estiver faltando. Suas chaves de acesso e o nome do bucket são mantidos.

Veja o guia do S3 API endpoint e o guia de acesso público a buckets da Cloudflare.

Erros de hospedagem de imagens no Mailchimp ​

Ao exportar direto para o Mailchimp, o Emailify verifica a pasta de imagens, os arquivos existentes e as URLs das imagens enviadas. Se o Mailchimp rejeitar uma solicitação de imagem, a exportação informa o erro e não cria o template com URLs de imagem não confirmadas. Verifique a conexão com o Mailchimp e a chave de API e exporte de novo.

Serviços de armazenamento em nuvem próprios compatíveis com o Emailify ​

Você pode hospedar as imagens exportadas do Emailify em qualquer um dos serviços de armazenamento de objetos compatíveis com S3 abaixo:

Definir uma URL base personalizada para hospedar as imagens no seu próprio servidor ou CDN ​

Por padrão, o src de todas as imagens do HTML exportado pelo Emailify é um caminho relativo img/ (por exemplo, img/ceb3f891b78815897e04299f93eef255.jpg). Isso permite revisar o e-mail e fazer o upload de um zip em algumas plataformas, como o MailChimp, que fazem o upload das imagens e atualizam as URLs do src automaticamente.

Mas, se você usa uma plataforma que não oferece esse recurso ou simplesmente hospeda as imagens no seu próprio servidor, talvez prefira definir a sua própria URL base personalizada.

URL base personalizada por e-mail ​

Você pode definir uma URL base personalizada para e-mails específicos: selecione o frame principal do e-mail no Figma, clique no botão Settings no cabeçalho do plugin, ative a opção Override "img/" Base Path e cole o caminho da URL base em que as imagens vão ficar hospedadas. Com a URL base personalizada ativada, ela é adicionada automaticamente como prefixo em todos os atributos src das imagens (por exemplo, substituindo img/ por https://your-custom-server.com/image/path/here/ no arquivo HTML exportado).

Essa configuração por e-mail é ideal quando você precisa de URLs base diferentes para campanhas específicas ou quer substituir a configuração global de CDN em e-mails específicos.

URL base global de CDN personalizada ​

Se você sempre hospeda as imagens na mesma CDN ou no mesmo servidor personalizado em todos os seus e-mails, pode definir uma URL base personalizada global em vez de configurá-la em cada e-mail:

  1. No painel de configurações de exportação, encontre o menu suspenso de CDN
  2. Selecione Custom Base Image Path URL na lista de opções de CDN
  3. Informe a sua URL base personalizada no campo que aparece (por exemplo, https://cdn.example.com/images/)
  4. A partir daí, todos os e-mails exportados usam essa URL base nos caminhos das imagens por padrão

A configuração global de CDN personalizada é uma forma prática de padronizar a hospedagem de imagens nas suas campanhas de e-mail. Se houver URLs base personalizadas configuradas tanto na configuração global quanto na de um e-mail, a configuração do e-mail tem prioridade, o que dá flexibilidade para substituir a CDN global em campanhas específicas.

Seja na configuração global ou na configuração por e-mail, verifique se a sua URL base personalizada está acessível publicamente e configurada corretamente com CORS, se necessário. A URL pode ter ou não uma barra no final; o Emailify trata os dois formatos corretamente.

Por que as imagens não aparecem no meu e-mail HTML exportado? ​

Normalmente, as imagens do e-mail não aparecem depois do envio quando os arquivos não estão hospedados em URLs públicas na internet, quando o e-mail foi enviado por uma ferramenta que reescreveu o HTML ou quando o cliente de e-mail do destinatário bloqueou as imagens remotas.

Se você exportar o HTML com caminhos locais img/, as imagens são salvas ao lado do arquivo .html e precisam ser enviadas junto com o template de e-mail ou hospedadas separadamente. Se você ativar Upload Hosted Image URLs, o Emailify faz o upload das imagens e troca automaticamente as URLs de imagem do HTML por links hospedados.

Por que as imagens funcionam no meu computador, mas não depois do envio? ​

Uma pré-visualização HTML local consegue carregar as imagens da pasta img/ exportada no seu computador. Depois que o e-mail é enviado, os destinatários não têm acesso aos arquivos do seu computador, então as imagens precisam estar hospedadas na internet ou ser enviadas pelo seu ESP.

O Gmail e o Outlook não são formas confiáveis de enviar HTML personalizado exportado, porque podem alterar a marcação e não cuidam da hospedagem de imagens em um fluxo de trabalho de envio de e-mails HTML em massa. Use um ESP ou uma das integrações incluídas no Emailify.

O que devo verificar primeiro se as imagens exportadas estiverem quebradas? ​

  • Verifique se as imagens estão hospedadas em URLs públicas https:// ou faça o upload da pasta img/ exportada pelo seu ESP.
  • Ative Upload Hosted Image URLs se quiser que o Emailify faça o upload das imagens para você.
  • Se usar um bucket ou CDN próprio, verifique se o bucket permite acesso público de leitura às URLs das imagens enviadas.
  • Se um upload falhar, verifique se uma VPN, um firewall, um proxy ou a rede da empresa está bloqueando a solicitação de upload.
  • Espere as imagens do Figma terminarem de carregar no arquivo antes de exportar.
  • Lembre-se de que alguns clientes de e-mail bloqueiam imagens remotas até que o destinatário escolha exibi-las.

Erros de conexão com a hospedagem personalizada ​

No Amazon S3, o Emailify monta o endpoint de upload a partir da Region e do Bucket Name selecionados. A Bucket URL é a URL base pública usada para as imagens no e-mail exportado; alterá-la não muda o endpoint de upload.

Informe o nome completo do bucket, incluindo o ID da conta e o sufixo da região, se houver. Por exemplo, um bucket regional de conta chamado my-email-images-123456789012-ap-southeast-2-an usa a região ap-southeast-2 e a Bucket URL https://my-email-images-123456789012-ap-southeast-2-an.s3.ap-southeast-2.amazonaws.com/. A AWS aceita nomes de bucket globais e regionais de conta.

A identidade do IAM vinculada à sua chave de acesso precisa da permissão s3:PutObject em arn:aws:s3:::YOUR-BUCKET-NAME/* para fazer o upload das imagens. O Emailify não precisa de acesso público de gravação nem de permissão para criar ou excluir buckets. Outras restrições nas suas políticas da AWS ou nas configurações de criptografia ainda podem impedir os uploads; veja as orientações de permissões da AWS.

As URLs das imagens exportadas também precisam poder ser lidas sem login. Use um bucket de imagens público ou uma CDN pública com o seu bucket por trás, e confira a URL de uma imagem enviada em uma janela anônima do navegador. Mantenha arquivos privados não relacionados em um armazenamento separado; não os torne públicos para que as imagens do e-mail funcionem.

Se uma exportação mostrar Image hosting failed, tente exportar de novo depois de corrigir a conexão ou as permissões. Um upload bem-sucedido do template de e-mail não significa que as imagens também foram enviadas com sucesso. Se o erro continuar, envie a mensagem de erro ou uma captura de tela para o suporte, sem incluir sua chave de acesso nem sua chave secreta.