---
title: "Pokazywanie projektu kupującego w e-mailach Klaviyo | Centrum pomocy | Customix"
description: "Pokaż spersonalizowany projekt kupującego w e-mailach Klaviyo za pomocą kodu szablonu i wysyłaj do Klaviyo zdarzenie Customix Personalized Order dla flow i segmentów."
url: https://customix.io/pl/help/klaviyo-email-design-images
language: pl
---

# Pokazywanie projektu kupującego w e-mailach Klaviyo

Pokaż spersonalizowany projekt kupującego w e-mailach Klaviyo za pomocą kodu szablonu i wysyłaj do Klaviyo zdarzenie Customix Personalized Order dla flow i segmentów.

Zaktualizowano 20 lis 2026

E-maile Klaviyo o porzuconym koszyku, potwierdzeniu zamówienia i wysyłce pokazują zdjęcie produktu, a nie to, co kupujący spersonalizował. Customix już zapisuje projekt przy każdej pozycji zamówienia, a Klaviyo synchronizuje go ze Shopify. Wklej krótki fragment kodu szablonu do e-maili Klaviyo, a każda pozycja pokaże:

- obraz projektu kupującego (lub zdjęcie produktu, gdy pozycja nie ma projektu);
- opcje wybrane przez kupującego (pola techniczne są ukryte; przesłane zdjęcia stają się linkiem **View image**);
- link, który ponownie otwiera zapisany projekt na stronie produktu, na dowolnym urządzeniu.

![Podgląd potwierdzenia zamówienia w Klaviyo z dwoma spersonalizowanymi kubkami pokazującymi obraz projektu](https://cdn.sanity.io/images/30j60knw/production/63b455aa9b744d2f81f46a1e34fcd758f74d5572-1202x920.png?w=1202&fit=max&auto=format)

## Zanim zaczniesz

- Klaviyo jest połączone z Twoim sklepem Shopify (**Klaviyo > Integrations > Shopify**).
- E-mail należy do flow uruchamianego przez jedno z tych zdarzeń Shopify: **Checkout Started** (porzucony koszyk), **Placed Order** (potwierdzenie zamówienia) lub **Fulfilled Order** (wysyłka). Te zdarzenia zawierają pozycje zamówienia.
- **Added to Cart** nie zawiera w Klaviyo pozycji zamówienia, więc kod nie działa we flow Added to Cart.

Kod znajdziesz w aplikacji Customix w **Ustawienia > Integracje > Klaviyo**, na karcie **Kod szablonu e-maila**, z przyciskiem **Kopiuj** przy każdym fragmencie.

## Opcja 1: dodaj blok z pozycjami zamówienia

Użyj tej opcji, gdy Twój e-mail nie zawiera jeszcze listy produktów lub chcesz ją zastąpić.

1. W Klaviyo otwórz e-mail we flow i kliknij **Edit**.
2. Przeciągnij blok **HTML** w miejsce, w którym mają się pojawić produkty.
3. Wklej kod **Pozycje zamówienia z obrazami projektu**:

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

Możesz zmienić słowa "Qty", "View image" i "View your design", kolory oraz szerokość obrazu (120), aby pasowały do Twojego e-maila. W e-mailu o porzuconym koszyku "Finish your design" często brzmi lepiej niż "View your design".

![Podgląd porzuconego koszyka w Klaviyo na telefonie z obrazem projektu i linkiem Finish your design](https://cdn.sanity.io/images/30j60knw/production/9aa6da2282d5a604f3431db53ca13d43ec6f0914-808x476.png?w=1100&fit=max&auto=format)

## Opcja 2: zachowaj tabelę produktów, zmień jej obraz

Użyj tej opcji, gdy Twój e-mail już wyświetla produkty w bloku tabeli z dynamicznymi wierszami (alias wiersza `item`, domyślny w Klaviyo).

1. Zaznacz obraz produktu w wierszu.
2. Ustaw jego adres URL obrazu (obraz dynamiczny) na kod **URL obrazu projektu**:

```
{% 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. Aby dodać link powrotny do projektu, wklej kod **Link do projektu** w tekście wiersza:

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

Jeśli Twoje wiersze używają innego aliasu niż `item`, zastąp `item.` swoim aliasem.

## Podgląd przed włączeniem flow

W edytorze e-maila kliknij **Preview** i wybierz niedawne zdarzenie (Klaviyo pokazuje ostatnie 10). Spersonalizowane pozycje pokazują obraz projektu, pozostałe pozycje zdjęcie produktu.

## Warto wiedzieć

- **Brak obrazu projektu?** Jeśli nie udało się zapisać obrazu projektu, gdy kupujący dodawał produkt do koszyka, pozycja pokaże zdjęcie produktu. Nic się nie psuje.
- **Dodatki i zestawy:** dodatki oraz elementy zestawu są pokazywane jako osobne pozycje, każda z własnym projektem.
- **Ukryte pola:** pozycje zamówienia zawierają też pola techniczne, których nazwy zaczynają się od `_cm-` (pliki do druku, identyfikatory). Kod nigdy ich nie pokazuje.
- **Gdzie są obrazy:** obrazy projektów to publiczne obrazy na cdn.customix.io (JPEG, około 1000–1200 px, około 100 KB), dzięki czemu klienty poczty mogą je załadować.
- **Prywatność:** kod szablonu nie wymaga połączenia: Klaviyo odczytuje zamówienie ze Shopify. Customix wysyła własne zdarzenie dopiero po połączeniu klucza Klaviyo, dla zamówień złożonych od tego momentu.

## Wysyłaj spersonalizowane zamówienia do Klaviyo

Połącz swoje konto Klaviyo, a Customix będzie wysyłać zdarzenie **Customix Personalized Order** dla każdego zamówienia z projektem: obraz projektu, link do projektu i opcje wybrane przez kupującego. Użyj go do uruchamiania flow (e-mail z podziękowaniem pokazujący projekt, przypomnienie o ponownym zamówieniu) oraz do tworzenia segmentów kupujących, którzy personalizują.

### 1\. Utwórz prywatny klucz API w Klaviyo

1. W Klaviyo otwórz **Settings > API keys** (Account > Settings > API keys).
2. W sekcji **Private API Keys** kliknij **Create Private API Key**.
3. Nadaj mu nazwę, na przykład `Customix`.
4. Wybierz **Custom Key**, ustaw **Accounts** na Read Access i **Events** na Full Access, a wszystko inne zostaw na No Access.
5. Kliknij **Create**, a następnie od razu skopiuj klucz. Zaczyna się od `pk_`.

Zachowaj klucz w tajemnicy: każdy, kto go ma, może zapisywać dane na Twoim koncie Klaviyo. Nie wysyłaj go e-mailem ani na czacie; wklejaj go tylko w aplikacji Customix.

### 2\. Połącz go w Customix

Tylko właściciel sklepu może połączyć, wymienić lub rozłączyć Klaviyo: klucz decyduje, które konto Klaviyo otrzymuje zamówienia Twoich kupujących. Pracownicy widzą informację zamiast formularza.

1. W aplikacji Customix otwórz **Ustawienia > Integracje > Klaviyo**.
2. Na karcie **Wysyłaj zamówienia do Klaviyo** wklej klucz w polu **Prywatny klucz API** i kliknij **Połącz**.
3. Customix sprawdza klucz w Klaviyo przed zapisaniem. Karta pokaże wtedy **Połączono z {Twoje konto Klaviyo}**, ostatnie cztery znaki klucza oraz moment wysłania ostatniego zamówienia.

Jeśli Klaviyo odrzuci klucz, karta poinformuje o tym pod polem. Sprawdź, czy to klucz prywatny (`pk_…`) z dostępem Accounts (odczyt) i Events (pełny).

Od tej chwili każde nowe zamówienie z projektem jest wysyłane w ciągu kilku minut. Zamówienia złożone przed połączeniem nie są wysyłane.

### Co zawiera zdarzenie

Zdarzenie **Customix Personalized Order** jest wysyłane raz na zamówienie, tylko dla zamówień z co najmniej jednym projektem. Jego właściwości:

- `OrderNumber`, `OrderId`: nazwa zamówienia w Shopify (#1001) i jego identyfikator.
- `ProductName`, `ImageURL`, `DesignURL`: pierwsza spersonalizowana pozycja: produkt, obraz projektu i link, który ponownie otwiera projekt.
- `ItemNames`, `ItemCount`: spersonalizowane pozycje.
- `Items`: każda spersonalizowana pozycja, z polami `ProductName`, `VariantName`, `ProductID`, `VariantID`, `SKU`, `Quantity`, `ItemPrice`, `ImageURL`, `DesignURL`, `CustomizationID` i `Options` (opcje wybrane przez kupującego, według nazwy).
- Wartość zdarzenia to suma zamówienia w walucie zamówienia.

Przykład w e-mailu flow uruchamianego przez to zdarzenie:

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

Profil kupującego w Klaviyo otrzymuje też te właściwości, przydatne w segmentach i późniejszych e-mailach:

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

### Pomysły

- **Flow z podziękowaniem** uruchamiany przez Customix Personalized Order, pokazujący `event.ImageURL`.
- **Segment** "What someone has done: Customix Personalized Order at least once" dla kupujących, którzy personalizują.
- **Przypomnienie o ponownym zamówieniu lub prezencie** przed rocznicą `Customix Last Personalized Order At`, pokazujące `person|lookup:'Customix Last Design Image'`.

### Zdjęcia przesłane przez kupujących

Opcja **Wysyłaj zdjęcia przesłane przez kupujących** jest domyślnie wyłączona, ponieważ zdjęcie może przedstawiać osobę. Gdy jest włączona, linki do zdjęć są wysyłane razem z opcjami. Obraz projektu jest zawsze wysyłany: pokazuje zdjęcie tylko w takiej postaci, w jakiej zostanie wydrukowane na produkcie.

### O połączeniu

- Customix wysyła dane wyłącznie na Twoje własne konto Klaviyo, przy użyciu Twojego klucza. Kliknij **Rozłącz** w dowolnym momencie; wysłane już zdarzenia pozostają w Klaviyo. Odinstalowanie Customix usuwa także klucz.
- Shopify czasem dostarcza zamówienie dwa razy; Klaviyo zachowuje jedno zdarzenie na zamówienie.
- Zdarzenie nie zmienia niczyjej zgody na e-mail ani SMS. Klaviyo wysyła e-maile tylko do osób, które mogą otrzymywać komunikację marketingową, tak jak w każdym flow.
- Zamówienie bez adresu e-mail kupującego nie jest wysyłane, ponieważ Klaviyo potrzebuje profilu.
- Jeśli Klaviyo przestanie akceptować klucz (usunięty, zmienione uprawnienia), karta pokaże **Wymaga uwagi** wraz z powodem podanym przez Klaviyo. Kliknij **Wymień klucz**, aby wkleić nowy.

## Nadal potrzebujesz pomocy?

Nasz zespół wsparcia przeprowadzi Cię przez wszystko krok po kroku. Napisz do nas lub umów rozmowę z zespołem.

[Napisz do wsparcia →](mailto:support@customix.io?subject=Customix%20support)[Umów rozmowę](https://calendly.com/customix-support/30min)
