Os e-mails do Klaviyo de checkout abandonado, confirmação de encomenda e envio mostram a imagem do produto, não o que o comprador personalizou. O Customix já guarda o design em cada linha da encomenda e o Klaviyo sincroniza-o a partir do Shopify. Cole um pequeno excerto de código de modelo nos seus e-mails do Klaviyo e cada linha mostra:

  • a imagem do design do comprador (ou a imagem do produto quando a linha não tem design);
  • as opções escolhidas pelo comprador (os campos técnicos ficam ocultos; as fotos carregadas passam a uma ligação View image);
  • uma ligação que volta a abrir o design guardado na página do produto, em qualquer dispositivo.
Pré-visualização de uma confirmação de encomenda do Klaviyo com duas canecas personalizadas que mostram a imagem do design

Antes de começar

  • O Klaviyo está ligado à sua loja Shopify (Klaviyo > Integrations > Shopify).
  • O e-mail pertence a um fluxo acionado por um destes eventos do Shopify: Checkout Started (checkout abandonado), Placed Order (confirmação de encomenda) ou Fulfilled Order (envio). Estes eventos incluem as linhas da encomenda.
  • Added to Cart não inclui linhas da encomenda no Klaviyo, pelo que o código não funciona em fluxos de Added to Cart.

Encontra o código na app do Customix: Definições > Integrações > Klaviyo, cartão Código do modelo de e-mail, com um botão Copiar para cada excerto.

Opção 1: adicionar o bloco de linhas da encomenda

Utilize-a quando o seu e-mail ainda não lista os produtos ou quando quer substituir a lista.

  1. No Klaviyo, abra o e-mail do fluxo e clique em Edit.
  2. Arraste um bloco HTML para o local onde os produtos devem aparecer.
  3. Cole o código Linhas da encomenda com imagens do design:
{% for item in event.extra.line_items %}
<table width="100%" cellpadding="0" cellspacing="0" border="0" role="presentation"><tr>
<td width="120" valign="top" style="padding:12px 0;"><img src="{% if item.product.properties|lookup:'_cm-thumb-url' %}{{ item.product.properties|lookup:'_cm-thumb-url' }}{% else %}{% if item.product.variant.images.0.src %}{{ item.product.variant.images.0.src }}{% else %}{{ item.product.images.0.src|missing_product_image }}{% endif %}{% endif %}" width="120" alt="{{ item.title }}" style="display:block;width:120px;max-width:120px;height:auto;border:0;border-radius:8px;"></td>
<td valign="top" style="padding:12px 0 12px 16px;font-family:Arial,Helvetica,sans-serif;font-size:14px;line-height:20px;color:#202223;">
<strong>{{ item.title }}</strong><br>
{% if item.variant_title %}{{ item.variant_title }}<br>{% endif %}
{% for prop in item.properties %}{% if prop.value and prop.name|slice:":1" != "_" %}{{ prop.name }}: {% if prop.value|slice:":8" == "https://" %}<a href="{{ prop.value }}" style="color:#2c6ecb;">View image</a>{% else %}{{ prop.value }}{% endif %}<br>{% endif %}{% endfor %}
Qty: {{ item.quantity|floatformat:0 }}
{% if item.product.properties|lookup:'_cm-customization-url' %}<br><a href="{{ item.product.properties|lookup:'_cm-customization-url' }}" style="color:#2c6ecb;text-decoration:underline;">View your design</a>{% endif %}
</td>
</tr></table>
{% endfor %}

Pode alterar as palavras "Qty", "View image" e "View your design", as cores e a largura da imagem (120) para combinar com o seu e-mail. Num e-mail de checkout abandonado, "Finish your design" costuma resultar melhor do que "View your design".

Pré-visualização no telemóvel de um checkout abandonado do Klaviyo com a imagem do design e uma ligação Finish your design

Opção 2: manter a sua tabela de produtos e alterar a imagem

Utilize-a quando o seu e-mail já lista os produtos num bloco de tabela com linhas dinâmicas (alias da linha item, o predefinido do Klaviyo).

  1. Selecione a imagem do produto da linha.
  2. Defina o URL da imagem (imagem dinâmica) com o código URL da imagem do design:
{% if item.product.properties|lookup:'_cm-thumb-url' %}{{ item.product.properties|lookup:'_cm-thumb-url' }}{% else %}{% if item.product.variant.images.0.src %}{{ item.product.variant.images.0.src }}{% else %}{{ item.product.images.0.src|missing_product_image }}{% endif %}{% endif %}
  1. Para adicionar a ligação de volta ao design, cole o código Link do design no texto da linha:
{% if item.product.properties|lookup:'_cm-customization-url' %}<a href="{{ item.product.properties|lookup:'_cm-customization-url' }}">View your design</a>{% endif %}

Se as suas linhas usarem um alias diferente de item, substitua item. pelo seu.

Pré-visualizar antes de ativar o fluxo

No editor de e-mail, clique em Preview e escolha um evento recente (o Klaviyo lista os últimos 10). As linhas personalizadas mostram a imagem do design; as restantes mostram a imagem do produto.

Bom saber

  • Sem imagem do design? Se não foi possível guardar a imagem do design quando o comprador adicionou o produto ao carrinho, a linha mostra a imagem do produto. Nada deixa de funcionar.
  • Complementos e packs: os complementos e os artigos de um pack aparecem como linhas próprias, cada uma com o seu design.
  • Campos ocultos: as linhas da encomenda também incluem campos técnicos cujos nomes começam por _cm- (ficheiros de impressão, ids). O código nunca os mostra.
  • Onde estão as imagens: as imagens do design são imagens públicas em cdn.customix.io (JPEG, cerca de 1000–1200 px, à volta de 100 KB), para que os clientes de e-mail as possam carregar.
  • Privacidade: o código do modelo não precisa de ligação: o Klaviyo lê a encomenda a partir do Shopify. O Customix só envia o seu próprio evento depois de ligar uma chave do Klaviyo, para as encomendas feitas a partir desse momento.

Enviar encomendas personalizadas para o Klaviyo

Ligue a sua conta do Klaviyo e o Customix envia um evento Customix Personalized Order por cada encomenda com design: a imagem do design, a ligação para o design e as opções escolhidas pelo comprador. Utilize-o para iniciar fluxos (um e-mail de agradecimento que mostra o design, um lembrete de reencomenda) e para criar segmentos de compradores que personalizam.

1. Crie uma chave de API privada no Klaviyo

  1. No Klaviyo, abra Settings > API keys (Account > Settings > API keys).
  2. Em Private API Keys, clique em Create Private API Key.
  3. Dê-lhe um nome, por exemplo Customix.
  4. Escolha Custom Key, defina Accounts como Read Access e Events como Full Access, e deixe tudo o resto em No Access.
  5. Clique em Create e copie a chave de imediato. Começa por pk_.

Mantenha a chave privada: quem a tiver pode escrever na sua conta do Klaviyo. Não a envie por e-mail nem por chat; cole-a apenas na app do Customix.

2. Ligue-a no Customix

Só o proprietário da loja pode ligar, substituir ou desligar o Klaviyo: a chave determina que conta do Klaviyo recebe as encomendas dos seus compradores. O pessoal da loja vê uma nota em vez do formulário.

  1. Na app do Customix, abra Definições > Integrações > Klaviyo.
  2. No cartão Enviar encomendas para o Klaviyo, cole a chave em Chave de API privada e clique em Ligar.
  3. O Customix verifica a chave junto do Klaviyo antes de a guardar. O cartão passa então a mostrar Ligado a {a sua conta do Klaviyo}, os últimos quatro carateres da chave e quando foi enviada a última encomenda.

Se o Klaviyo recusar a chave, o cartão indica-o por baixo do campo. Verifique se é uma chave privada (pk_…) com acesso Accounts (leitura) e Events (total).

A partir daí, cada nova encomenda com design é enviada em poucos minutos. As encomendas feitas antes de ligar não são enviadas.

O que o evento contém

O evento Customix Personalized Order é enviado uma vez por encomenda, apenas para encomendas com pelo menos um design. As suas propriedades:

  • OrderNumber, OrderId: o nome da encomenda no Shopify (#1001) e o respetivo id.
  • ProductName, ImageURL, DesignURL: a primeira linha personalizada: produto, imagem do design e a ligação que volta a abrir o design.
  • ItemNames, ItemCount: as linhas personalizadas.
  • Items: todas as linhas personalizadas, com ProductName, VariantName, ProductID, VariantID, SKU, Quantity, ItemPrice, ImageURL, DesignURL, CustomizationID e Options (as opções escolhidas pelo comprador, por nome).
  • O valor do evento é o total da encomenda, na moeda da encomenda.

Exemplo num e-mail de fluxo acionado pelo evento:

<img src="{{ event.ImageURL }}" width="300" alt="{{ event.ProductName }}">
<a href="{{ event.DesignURL }}">View your design</a>

{% for item in event.Items %}
  <img src="{{ item.ImageURL }}" width="120"> {{ item.ProductName }} × {{ item.Quantity }}
{% endfor %}

O perfil do comprador no Klaviyo também recebe estas propriedades, úteis para segmentos e e-mails posteriores:

  • Customix Last Personalized Product
  • Customix Last Design Image
  • Customix Last Design URL
  • Customix Last Personalized Order At

Ideias

  • Fluxo de agradecimento acionado por Customix Personalized Order, a mostrar event.ImageURL.
  • Segmento "What someone has done: Customix Personalized Order at least once" para os compradores que personalizam.
  • Lembrete de reencomenda ou de oferta antes do aniversário de Customix Last Personalized Order At, a mostrar person|lookup:'Customix Last Design Image'.

Fotos carregadas pelos compradores

Enviar as fotos carregadas pelos compradores está desativado por predefinição, porque uma foto pode mostrar uma pessoa. Quando está ativado, as ligações para as fotos são enviadas juntamente com as opções. A imagem do design é sempre enviada: mostra a foto apenas tal como é impressa no produto.

Sobre a ligação

  • O Customix envia apenas para a sua própria conta do Klaviyo, com a sua chave. Clique em Desligar em qualquer altura; os eventos já enviados ficam no Klaviyo. Desinstalar o Customix também elimina a chave.
  • O Shopify por vezes entrega uma encomenda duas vezes; o Klaviyo mantém um só evento por encomenda.
  • O evento não altera o consentimento de ninguém para e-mail ou SMS. O Klaviyo só envia e-mails a pessoas que podem receber marketing, como em qualquer fluxo.
  • Uma encomenda sem o e-mail do comprador não é enviada, porque o Klaviyo precisa de um perfil.
  • Se o Klaviyo deixar de aceitar a chave (eliminada, permissões alteradas), o cartão mostra Requer atenção com o motivo indicado pelo Klaviyo. Clique em Substituir chave para colar uma nova.