Le email di Klaviyo per il checkout abbandonato, la conferma d'ordine e la spedizione mostrano l'immagine del prodotto, non quella personalizzata dall'acquirente. Customix salva già il design su ogni riga d'ordine e Klaviyo lo sincronizza da Shopify. Incolla un breve codice modello nelle tue email di Klaviyo e ogni riga mostrerà:
- l'immagine del design dell'acquirente (o l'immagine del prodotto se la riga non ha un design);
- le opzioni scelte dall'acquirente (i campi tecnici sono nascosti; le foto caricate diventano un link View image);
- un link che riapre il design salvato nella pagina del prodotto, su qualsiasi dispositivo.

Prima di iniziare
- Klaviyo è collegato al tuo negozio Shopify (Klaviyo > Integrations > Shopify).
- L'email appartiene a un flow attivato da uno di questi eventi Shopify: Checkout Started (checkout abbandonato), Placed Order (conferma d'ordine) o Fulfilled Order (spedizione). Questi eventi contengono le righe d'ordine.
- Added to Cart non contiene righe d'ordine in Klaviyo, quindi il codice non funziona nei flow Added to Cart.
Trovi il codice nell'app Customix: Impostazioni > Integrazioni > Klaviyo, scheda Codice del modello email, con un pulsante Copia per ogni frammento.
Opzione 1: aggiungere il blocco delle righe d'ordine
Usala quando la tua email non elenca ancora i prodotti o se vuoi sostituire l'elenco.
- In Klaviyo, apri l'email del flow e fai clic su Edit.
- Trascina un blocco HTML dove devono comparire i prodotti.
- Incolla il codice Righe d'ordine con immagini del 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 %}Puoi modificare le parole "Qty", "View image" e "View your design", i colori e la larghezza dell'immagine (120) per adattarli alla tua email. In un'email di checkout abbandonato, "Finish your design" spesso funziona meglio di "View your design".

Opzione 2: mantenere la tabella dei prodotti, cambiarne l'immagine
Usala quando la tua email elenca già i prodotti in un blocco tabella con righe dinamiche (alias di riga item, l'impostazione predefinita di Klaviyo).
- Seleziona l'immagine del prodotto della riga.
- Imposta il suo URL immagine (immagine dinamica) con il codice URL dell'immagine del 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 %}- Per aggiungere il link al design, incolla il codice Link del design nel testo della riga:
{% if item.product.properties|lookup:'_cm-customization-url' %}<a href="{{ item.product.properties|lookup:'_cm-customization-url' }}">View your design</a>{% endif %}Se le tue righe usano un alias diverso da item, sostituisci item. con il tuo.
Anteprima prima di attivare il flow
Nell'editor dell'email, fai clic su Preview e scegli un evento recente (Klaviyo elenca gli ultimi 10). Le righe personalizzate mostrano l'immagine del design; le altre righe mostrano l'immagine del prodotto.
Da sapere
- Nessuna immagine del design? Se non è stato possibile salvare l'immagine del design quando l'acquirente ha aggiunto il prodotto al carrello, la riga mostra l'immagine del prodotto. Non si rompe nulla.
- Componenti aggiuntivi e bundle: i componenti aggiuntivi e gli articoli di un bundle compaiono come righe separate, ciascuna con il proprio design.
- Campi nascosti: le righe d'ordine contengono anche campi tecnici i cui nomi iniziano con
_cm-(file di stampa, ID). Il codice non li mostra mai. - Dove si trovano le immagini: le immagini del design sono immagini pubbliche su cdn.customix.io (JPEG, circa 1000–1200 px, intorno a 100 KB), così i client di posta possono caricarle.
- Privacy: il codice modello non richiede alcuna connessione: Klaviyo legge l'ordine da Shopify. Customix invia il proprio evento solo dopo che hai collegato una chiave Klaviyo, per gli ordini effettuati da quel momento in poi.
Inviare a Klaviyo gli ordini personalizzati
Collega il tuo account Klaviyo e Customix invierà un evento Customix Personalized Order per ogni ordine con un design: l'immagine del design, il link al design e le opzioni scelte dall'acquirente. Usalo per avviare flow (un'email di ringraziamento che mostra il design, un promemoria di riordino) e per creare segmenti di acquirenti che personalizzano.
1. Crea una chiave API privata in Klaviyo
- In Klaviyo, apri Settings > API keys (Account > Settings > API keys).
- In Private API Keys, fai clic su Create Private API Key.
- Assegnale un nome, ad esempio
Customix. - Scegli Custom Key, imposta Accounts su Read Access ed Events su Full Access e lascia tutto il resto su No Access.
- Fai clic su Create, quindi copia subito la chiave. Inizia con
pk_.
Tieni la chiave riservata: chiunque la possieda può scrivere nel tuo account Klaviyo. Non inviarla per email o chat; incollala solo nell'app Customix.
2. Collegala in Customix
Solo il proprietario del negozio può collegare, sostituire o scollegare Klaviyo: la chiave decide quale account Klaviyo riceve gli ordini dei tuoi acquirenti. Lo staff vede una nota al posto del modulo.
- Nell'app Customix, apri Impostazioni > Integrazioni > Klaviyo.
- Nella scheda Invia gli ordini a Klaviyo, incolla la chiave in Chiave API privata e fai clic su Collega.
- Customix verifica la chiave con Klaviyo prima di salvarla. La scheda mostra poi Collegato a {il tuo account Klaviyo}, gli ultimi quattro caratteri della chiave e quando è stato inviato l'ultimo ordine.
Se Klaviyo rifiuta la chiave, la scheda lo indica sotto il campo. Verifica che sia una chiave privata (pk_…) con accesso Accounts (lettura) ed Events (completo).
Da quel momento, ogni nuovo ordine con un design viene inviato entro pochi minuti. Gli ordini effettuati prima del collegamento non vengono inviati.
Cosa contiene l'evento
L'evento Customix Personalized Order viene inviato una volta per ordine, solo per gli ordini con almeno un design. Le sue proprietà:
OrderNumber,OrderId: il nome dell'ordine Shopify (#1001) e il suo ID.ProductName,ImageURL,DesignURL: la prima riga personalizzata: prodotto, immagine del design e link che riapre il design.ItemNames,ItemCount: le righe personalizzate.Items: ogni riga personalizzata, conProductName,VariantName,ProductID,VariantID,SKU,Quantity,ItemPrice,ImageURL,DesignURL,CustomizationIDeOptions(le opzioni scelte dall'acquirente, per nome).- Il valore dell'evento è il totale dell'ordine, nella valuta dell'ordine.
Esempio in un'email di un flow avviato dall'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 %}Anche il profilo Klaviyo dell'acquirente riceve queste proprietà, utili per segmenti ed email successive:
Customix Last Personalized ProductCustomix Last Design ImageCustomix Last Design URLCustomix Last Personalized Order At
Idee
- Flow di ringraziamento avviato da Customix Personalized Order, che mostra
event.ImageURL. - Segmento "What someone has done: Customix Personalized Order at least once" per gli acquirenti che personalizzano.
- Promemoria di riordino o di regalo prima dell'anniversario di
Customix Last Personalized Order At, che mostraperson|lookup:'Customix Last Design Image'.
Foto caricate dagli acquirenti
Invia le foto caricate dagli acquirenti è disattivato per impostazione predefinita, perché una foto può ritrarre una persona. Quando è attivo, i link alle foto vengono inviati insieme alle opzioni. L'immagine del design viene sempre inviata: mostra la foto solo come viene stampata sul prodotto.
Informazioni sul collegamento
- Customix invia solo al tuo account Klaviyo, con la tua chiave. Fai clic su Scollega in qualsiasi momento; gli eventi già inviati restano in Klaviyo. Anche la disinstallazione di Customix elimina la chiave.
- A volte Shopify consegna un ordine due volte; Klaviyo conserva un solo evento per ordine.
- L'evento non modifica il consenso email o SMS di nessuno. Klaviyo invia email solo a chi può ricevere comunicazioni di marketing, come in qualsiasi flow.
- Un ordine senza l'email dell'acquirente non viene inviato, perché Klaviyo ha bisogno di un profilo.
- Se Klaviyo smette di accettare la chiave (eliminata, autorizzazioni modificate), la scheda mostra Richiede attenzione con il motivo indicato da Klaviyo. Fai clic su Sostituisci chiave per incollarne una nuova.