---
title: "Afișează designul cumpărătorului în e-mailurile Klaviyo | Centru de ajutor | Customix"
description: "Afișează designul personalizat al cumpărătorului în e-mailurile Klaviyo cu ajutorul unui cod de șablon și trimite către Klaviyo un eveniment Customix Personalized Order pentru flow-uri și segmente."
url: https://customix.io/ro/help/klaviyo-email-design-images
language: ro
---

# Afișează designul cumpărătorului în e-mailurile Klaviyo

Afișează designul personalizat al cumpărătorului în e-mailurile Klaviyo cu ajutorul unui cod de șablon și trimite către Klaviyo un eveniment Customix Personalized Order pentru flow-uri și segmente.

Actualizat la 20 nov. 2026

E-mailurile Klaviyo pentru coș abandonat, confirmarea comenzii și expediere afișează imaginea produsului, nu ce a personalizat cumpărătorul. Customix salvează deja designul pe fiecare rând al comenzii, iar Klaviyo îl sincronizează din Shopify. Lipește un scurt cod de șablon în e-mailurile tale Klaviyo și fiecare rând va afișa:

- imaginea designului cumpărătorului (sau imaginea produsului, dacă rândul nu are design);
- opțiunile alese de cumpărător (câmpurile tehnice sunt ascunse; fotografiile încărcate devin un link **View image**);
- un link care redeschide designul salvat pe pagina produsului, pe orice dispozitiv.

![Previzualizare a unei confirmări de comandă Klaviyo cu două căni personalizate care afișează imaginea designului](https://cdn.sanity.io/images/30j60knw/production/63b455aa9b744d2f81f46a1e34fcd758f74d5572-1202x920.png?w=1202&fit=max&auto=format)

## Înainte să începi

- Klaviyo este conectat la magazinul tău Shopify (**Klaviyo > Integrations > Shopify**).
- E-mailul face parte dintr-un flow declanșat de unul dintre aceste evenimente Shopify: **Checkout Started** (coș abandonat), **Placed Order** (confirmarea comenzii) sau **Fulfilled Order** (expediere). Aceste evenimente conțin rândurile comenzii.
- **Added to Cart** nu conține rândurile comenzii în Klaviyo, deci codul nu funcționează în flow-urile Added to Cart.

Găsești codul în aplicația Customix: **Setări > Integrări > Klaviyo**, cardul **Codul șablonului de e-mail**, cu un buton **Copiază** pentru fiecare fragment.

## Opțiunea 1: adaugă blocul cu rândurile comenzii

Folosește această opțiune când e-mailul tău nu listează încă produsele sau vrei să înlocuiești lista.

1. În Klaviyo, deschide e-mailul din flow și fă clic pe **Edit**.
2. Trage un bloc **HTML** în locul în care trebuie să apară produsele.
3. Lipește codul **Rânduri de comandă cu imagini de 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 %}
```

Poți schimba cuvintele "Qty", "View image" și "View your design", culorile și lățimea imaginii (120) ca să se potrivească cu e-mailul tău. Într-un e-mail pentru coș abandonat, "Finish your design" sună adesea mai bine decât "View your design".

![Previzualizare a unui e-mail Klaviyo pentru coș abandonat pe mobil, cu imaginea designului și un link Finish your design](https://cdn.sanity.io/images/30j60knw/production/9aa6da2282d5a604f3431db53ca13d43ec6f0914-808x476.png?w=1100&fit=max&auto=format)

## Opțiunea 2: păstrează tabelul de produse, schimbă-i imaginea

Folosește această opțiune când e-mailul tău listează deja produsele într-un bloc de tabel cu rânduri dinamice (aliasul rândului `item`, valoarea implicită Klaviyo).

1. Selectează imaginea produsului din rând.
2. Setează URL-ul imaginii (imagine dinamică) la codul **URL-ul imaginii de 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. Ca să adaugi linkul înapoi la design, lipește codul **Link-ul designului** în textul rândului:

```
{% if item.product.properties|lookup:'_cm-customization-url' %}<a href="{{ item.product.properties|lookup:'_cm-customization-url' }}">View your design</a>{% endif %}
```

Dacă rândurile tale folosesc alt alias decât `item`, înlocuiește `item.` cu al tău.

## Previzualizează înainte să activezi flow-ul

În editorul de e-mail, fă clic pe **Preview** și alege un eveniment recent (Klaviyo listează ultimele 10). Rândurile personalizate afișează imaginea designului; celelalte rânduri afișează imaginea produsului.

## Bine de știut

- **Nicio imagine de design?** Dacă imaginea designului nu a putut fi salvată când cumpărătorul a adăugat produsul în coș, rândul afișează imaginea produsului. Nu se strică nimic.
- **Suplimente și pachete:** articolele suplimentare și articolele unui pachet apar ca rânduri separate, fiecare cu propriul design.
- **Câmpuri ascunse:** rândurile comenzii conțin și câmpuri tehnice ale căror nume încep cu `_cm-` (fișiere de imprimare, ID-uri). Codul nu le afișează niciodată.
- **Unde se află imaginile:** imaginile designului sunt imagini publice pe cdn.customix.io (JPEG, aproximativ 1000–1200 px, în jur de 100 KB), astfel încât clienții de e-mail să le poată încărca.
- **Confidențialitate:** codul șablonului nu necesită nicio conexiune: Klaviyo citește comanda din Shopify. Customix trimite propriul eveniment doar după ce conectezi o cheie Klaviyo, pentru comenzile plasate din acel moment.

## Trimite comenzile personalizate către Klaviyo

Conectează-ți contul Klaviyo și Customix trimite un eveniment **Customix Personalized Order** pentru fiecare comandă cu design: imaginea designului, linkul către design și opțiunile alese de cumpărător. Folosește-l pentru a porni flow-uri (un e-mail de mulțumire care afișează designul, un memento de recomandare) și pentru a crea segmente de cumpărători care personalizează.

### 1\. Creează o cheie API privată în Klaviyo

1. În Klaviyo, deschide **Settings > API keys** (Account > Settings > API keys).
2. La **Private API Keys**, fă clic pe **Create Private API Key**.
3. Dă-i un nume, de exemplu `Customix`.
4. Alege **Custom Key**, setează **Accounts** la Read Access și **Events** la Full Access, iar restul lasă-le pe No Access.
5. Fă clic pe **Create**, apoi copiază imediat cheia. Începe cu `pk_`.

Păstrează cheia privată: oricine o are poate scrie în contul tău Klaviyo. Nu o trimite prin e-mail sau chat; lipește-o doar în aplicația Customix.

### 2\. Conectează-o în Customix

Doar proprietarul magazinului poate conecta, înlocui sau deconecta Klaviyo: cheia stabilește care cont Klaviyo primește comenzile cumpărătorilor tăi. Personalul vede o notă în loc de formular.

1. În aplicația Customix, deschide **Setări > Integrări > Klaviyo**.
2. În cardul **Trimiteți comenzile către Klaviyo**, lipește cheia în **Cheie API privată** și fă clic pe **Conectați**.
3. Customix verifică cheia la Klaviyo înainte de a o salva. Cardul afișează apoi **Conectat la {contul tău Klaviyo}**, ultimele patru caractere ale cheii și momentul în care a fost trimisă ultima comandă.

Dacă Klaviyo refuză cheia, cardul o spune sub câmp. Verifică dacă este o cheie privată (`pk_…`) cu acces Accounts (citire) și Events (complet).

De acum, fiecare comandă nouă cu design este trimisă în câteva minute. Comenzile plasate înainte de conectare nu sunt trimise.

### Ce conține evenimentul

Evenimentul **Customix Personalized Order** este trimis o dată pentru fiecare comandă, doar pentru comenzile cu cel puțin un design. Proprietățile lui:

- `OrderNumber`, `OrderId`: numele comenzii din Shopify (#1001) și ID-ul ei.
- `ProductName`, `ImageURL`, `DesignURL`: primul rând personalizat: produsul, imaginea designului și linkul care redeschide designul.
- `ItemNames`, `ItemCount`: rândurile personalizate.
- `Items`: fiecare rând personalizat, cu `ProductName`, `VariantName`, `ProductID`, `VariantID`, `SKU`, `Quantity`, `ItemPrice`, `ImageURL`, `DesignURL`, `CustomizationID` și `Options` (opțiunile alese de cumpărător, după nume).
- Valoarea evenimentului este totalul comenzii, în moneda comenzii.

Exemplu într-un e-mail de flow declanșat de eveniment:

```
<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 %}
```

Profilul Klaviyo al cumpărătorului primește și aceste proprietăți, utile pentru segmente și e-mailuri ulterioare:

- `Customix Last Personalized Product`
- `Customix Last Design Image`
- `Customix Last Design URL`
- `Customix Last Personalized Order At`

### Idei

- **Flow de mulțumire** declanșat de Customix Personalized Order, care afișează `event.ImageURL`.
- **Segment** "What someone has done: Customix Personalized Order at least once" pentru cumpărătorii care personalizează.
- **Memento de recomandare sau de cadou** înainte de aniversarea `Customix Last Personalized Order At`, care afișează `person|lookup:'Customix Last Design Image'`.

### Fotografii încărcate de cumpărători

**Trimiteți fotografiile încărcate de cumpărători** este dezactivat implicit, pentru că o fotografie poate înfățișa o persoană. Când este activat, linkurile către fotografii sunt trimise împreună cu opțiunile. Imaginea designului este trimisă întotdeauna: ea arată fotografia doar așa cum este tipărită pe produs.

### Despre conexiune

- Customix trimite doar către propriul tău cont Klaviyo, cu cheia ta. Fă clic pe **Deconectați** oricând; evenimentele deja trimise rămân în Klaviyo. Dezinstalarea Customix șterge și cheia.
- Shopify livrează uneori o comandă de două ori; Klaviyo păstrează un singur eveniment pentru fiecare comandă.
- Evenimentul nu modifică consimțământul nimănui pentru e-mail sau SMS. Klaviyo trimite e-mailuri doar persoanelor care pot primi marketing, ca în orice flow.
- O comandă fără e-mailul cumpărătorului nu este trimisă, pentru că Klaviyo are nevoie de un profil.
- Dacă Klaviyo nu mai acceptă cheia (ștearsă, permisiuni modificate), cardul afișează **Necesită atenție** cu motivul dat de Klaviyo. Fă clic pe **Înlocuiți cheia** ca să lipești una nouă.

## Mai ai nevoie de ajutor?

Echipa noastră de suport te ghidează pas cu pas. Scrie-ne sau programează un apel cu echipa.

[Scrie-ne la suport →](mailto:support@customix.io?subject=Customix%20support)[Programează un apel](https://calendly.com/customix-support/30min)
