Como adicionar uma imagem dinâmica a uma mensagem de texto
O que você vai aprender
Saiba como adicionar uma imagem dinâmica a uma mensagem de MMS na Klaviyo.
Incluir uma imagem dinâmica permite personalizar suas mensagens de texto. Por exemplo, você pode mostrar a alguém o produto exato que ela visualizou, com o qual iniciou um checkout ou que comprou.
Antes de começar
Dependendo do seu caso de uso, talvez nem sempre seja possível adicionar uma imagem dinâmica.
- Somente fluxos acionados por métrica podem usar imagens dinâmicas com base em dados de eventos (por exemplo, itens de um checkout ou pedido feito) ou em tags de catálogo para um evento.
- Campanhas e fluxos acionados por listas e segmentos podem usar URLs de imagens armazenadas como Propriedades do perfil personalizadas. Eles também podem usar tags do catálogo para buscar uma imagem a partir de um ID de item armazenado no perfil do destinatário.
Além disso, observe o seguinte sobre imagens dinâmicas:
- É permitida apenas 1 imagem dinâmica por MMS.
- As imagens devem ter menos de 600 KB. Imagens maiores podem ser compactadas pelas operadoras, o que pode distorcê-las, ou não ser entregues.
- Se você tentar enviar uma imagem dinâmica com um número de envio que não permite MMS, a mensagem será enviada, mas a imagem será removida.
- Se uma imagem dinâmica resultar em um URL vazio ou inválido, uma mensagem com texto e sem nenhum outro anexo será enviada como SMS, sem a imagem. Esse fallback não se aplica a prévias, envios de teste ou mensagens que usam traduções; nesses casos, é necessário um URL de imagem válido.
- Você pode usar instruções condicionais com imagens dinâmicas.
- As operadoras de celular não oferecem suporte a arquivos WebP, e anexar esse tipo de imagem pode fazer com que a mensagem falhe.
Como adicionar uma imagem dinâmica
As etapas abaixo começam em uma mensagem do fluxo. Para uma campanha em rascunho, abra o editor de mensagem de texto dela e pule as 2 primeiras etapas.
- Selecione a mensagem do fluxo em que você quer incluir sua imagem dinâmica.
- Ao lado de Conteúdo, clique em Editar.

- Se o seu editor mostrar opções de RCS, selecione Fallback de SMS. Para editar a imagem separadamente, abra Conteúdo e desative Usar o mesmo conteúdo da mensagem de RCS.
- Clique em Visualizar no canto superior direito.

- Escolha um evento ou perfil de visualização que contenha o URL da imagem e, em seguida, expanda Todas as propriedades.
- Clique na propriedade do URL da imagem para copiar a variável. Em uma lista de produtos ou imagens,
0identifica o primeiro item e pode aparecer no meio da variável.

- Clique em Concluído.
- No painel Conteúdo, ative Anexo e selecione Imagem (ou Mídia, se aparecer).
- Clique em Selecionar imagem (ou Selecionar mídia). Se uma imagem já estiver anexada, clique em Substituir.

- Vá para a aba Imagem dinâmica.
- Cole a variável dinâmica ou o URL dinâmico da imagem.

- Clique em Save.
- Clique em Visualizar e verifique se a imagem esperada aparece para o evento ou perfil selecionado em uma região que ofereça suporte a MMS.
- Clique em Concluído e, em seguida, em Próximo para salvar a mensagem e sair do editor.
Use tags do catálogo
Você também pode usar tags de catálogo para adicionar imagens dinâmicas no MMS. Para isso:
- Na Prévia, expanda Todas as propriedades e encontre o ID do item do primeiro produto nos dados do evento. Use o identificador que corresponde ao item no seu catálogo da Klaviyo (um ID do produto ou SKU, dependendo da integração). Para uma imagem baseada em perfil, encontre a Propriedade do perfil personalizada que contém o ID do item.
- Copie esta variável.

- Clique em Concluído para retornar ao editor de SMS.
- No painel Conteúdo, ative Anexo e selecione Imagem (ou Mídia, se aparecer).
- Clique em Selecionar imagem (ou Selecionar mídia). Se uma imagem já estiver anexada, clique em Substituir.

- Vá para a aba Imagem dinâmica.
- Cole a seguinte tag de catálogo:
{% catalog event.id %} {{catalog_item.featured_image.thumbnail.src}} {% endcatalog %} - Substitua event.id em {% catalog event.id %} pela variável da tag que você copiou anteriormente. Remova os colchetes externos e o filtro padrão, mas mantenha todos os filtros de consulta necessários para acessar a propriedade (assim, {{ event.extra.line_items.0.product_id|default:'' }} vira event.extra.line_items.0.product_id).
Exemplo: {% catalog event.extra.line_items.0.product_id %} {{catalog_item.featured_image.thumbnail.src}} {% endcatalog %} - Clique em Save.
- Clique em Prévia e confira a imagem usando um evento ou um perfil com o ID do item de catálogo correspondente em uma região compatível com MMS. Clique em Concluir e depois em Avançar para salvar a mensagem e sair do editor.
Exemplo de uso de declarações condicionais
Imagens dinâmicas podem usar instruções condicionais.
Veja abaixo um exemplo de uma instrução if/else para dizer que, se houver uma imagem da variante, mostre-a aos destinatários; caso contrário, use a imagem padrão:
{% if event.extra.line_items.0.product.variant.images.0.src %}{{ event.extra.line_items.0.product.variant.images.0.src }}{% else %}{{ event.extra.line_items.0.product.images.0.src }}{% endif %}
Observe que o formato exato dessas declarações depende das suas integrações e que você não deve copiá-las de modelos de e-mail.
Recursos adicionais
- Understanding MMS image and GIF best practices
Learn best practices for sending images and GIFs in text messages so that they display nicely to recipients.
- How to use event data to personalize email and SMS flows
Learn what dynamic event data is, when to use it, where to find it, and how to include it in your flow messages. Learn about the different actions your customers take, and how you can use that data for creating personalized messaging flows in Klaviyo. For instance, you could use event data in an abandoned cart flow message to show individuals what product they left behind, an image of the item, and more. This allows for a more personalized experience for the customer, as well as a higher chance of conversion.