---
title: "Mostrare il design dell'acquirente nelle email di Klaviyo | Centro assistenza | Customix"
description: "Mostra il design personalizzato dell'acquirente nelle email di Klaviyo con il codice modello e invia a Klaviyo un evento Customix Personalized Order per flow e segmenti."
url: https://customix.io/it/help/klaviyo-email-design-images
language: it
---

# Mostrare il design dell'acquirente nelle email di Klaviyo

Mostra il design personalizzato dell'acquirente nelle email di Klaviyo con il codice modello e invia a Klaviyo un evento Customix Personalized Order per flow e segmenti.

Aggiornato il 20 nov 2026

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.

![Anteprima di una conferma d'ordine di Klaviyo con due tazze personalizzate che mostrano l'immagine del design](https://cdn.sanity.io/images/30j60knw/production/63b455aa9b744d2f81f46a1e34fcd758f74d5572-1202x920.png?w=1202&fit=max&auto=format)

## 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.

1. In Klaviyo, apri l'email del flow e fai clic su **Edit**.
2. Trascina un blocco **HTML** dove devono comparire i prodotti.
3. 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".

![Anteprima di un'email di checkout abbandonato di Klaviyo su mobile con l'immagine del design e un link Finish your design](https://cdn.sanity.io/images/30j60knw/production/9aa6da2282d5a604f3431db53ca13d43ec6f0914-808x476.png?w=1100&fit=max&auto=format)

## 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).

1. Seleziona l'immagine del prodotto della riga.
2. 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 %}
```

1. 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

1. In Klaviyo, apri **Settings > API keys** (Account > Settings > API keys).
2. In **Private API Keys**, fai clic su **Create Private API Key**.
3. Assegnale un nome, ad esempio `Customix`.
4. Scegli **Custom Key**, imposta **Accounts** su Read Access ed **Events** su Full Access e lascia tutto il resto su No Access.
5. 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.

1. Nell'app Customix, apri **Impostazioni > Integrazioni > Klaviyo**.
2. Nella scheda **Invia gli ordini a Klaviyo**, incolla la chiave in **Chiave API privata** e fai clic su **Collega**.
3. 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, con `ProductName`, `VariantName`, `ProductID`, `VariantID`, `SKU`, `Quantity`, `ItemPrice`, `ImageURL`, `DesignURL`, `CustomizationID` e `Options` (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 Product`
- `Customix Last Design Image`
- `Customix Last Design URL`
- `Customix 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 mostra `person|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.

## Hai ancora bisogno di aiuto?

Il nostro team di assistenza ti guiderà passo dopo passo. Scrivici o prenota una chiamata con il team.

[Scrivi all'assistenza →](mailto:support@customix.io?subject=Customix%20support)[Prenota una chiamata](https://calendly.com/customix-support/30min)
