---
title: "在 Klaviyo 邮件中展示买家的设计 | 帮助中心 | Customix"
description: "通过模板代码在 Klaviyo 邮件中展示买家的个性化设计，并向 Klaviyo 发送 Customix Personalized Order 事件，用于流程和细分。"
url: https://customix.io/zh/help/klaviyo-email-design-images
language: zh-CN
---

# 在 Klaviyo 邮件中展示买家的设计

通过模板代码在 Klaviyo 邮件中展示买家的个性化设计，并向 Klaviyo 发送 Customix Personalized Order 事件，用于流程和细分。

更新于 2026年11月20日

Klaviyo 的弃单、订单确认和发货邮件默认展示商品图片，而不是买家个性化后的内容。Customix 已在每个订单行中保存了设计，Klaviyo 会从 Shopify 同步这些数据。将一小段模板代码粘贴到 Klaviyo 邮件中，每个订单行就会展示：

- 买家的设计图片（订单行没有设计时展示商品图片）；
- 买家选择的选项（技术字段会被隐藏；上传的照片会变成 **View image** 链接）；
- 一个链接，可在任意设备上于商品页面重新打开已保存的设计。

![Klaviyo 订单确认邮件预览，其中两个个性化杯子展示了设计图片](https://cdn.sanity.io/images/30j60knw/production/63b455aa9b744d2f81f46a1e34fcd758f74d5572-1202x920.png?w=1202&fit=max&auto=format)

## 开始之前

- Klaviyo 已连接到您的 Shopify 店铺（**Klaviyo > Integrations > Shopify**）。
- 该邮件所属的流程由以下某个 Shopify 事件触发：**Checkout Started**（弃单）、**Placed Order**（订单确认）或 **Fulfilled Order**（发货）。这些事件包含订单行。
- **Added to Cart** 在 Klaviyo 中不包含订单行，因此该代码不适用于 Added to Cart 流程。

您可以在 Customix 应用的 **设置 > 集成 > Klaviyo** 中找到代码，位于 **邮件模板代码** 卡片，每段代码都有一个 **复制** 按钮。

## 方案 1：添加订单行区块

如果您的邮件尚未列出商品，或者您想替换现有列表，请使用此方案。

1. 在 Klaviyo 中打开流程邮件，然后点击 **Edit**。
2. 将一个 **HTML** 区块拖到需要展示商品的位置。
3. 粘贴 **带设计图片的订单行** 代码：

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

您可以修改 "Qty"、"View image" 和 "View your design" 这些文字，以及颜色和图片宽度（120），使其与您的邮件风格一致。在弃单邮件中，"Finish your design" 通常比 "View your design" 更合适。

![手机端的 Klaviyo 弃单邮件预览，展示设计图片和 Finish your design 链接](https://cdn.sanity.io/images/30j60knw/production/9aa6da2282d5a604f3431db53ca13d43ec6f0914-808x476.png?w=1100&fit=max&auto=format)

## 方案 2：保留商品表格，只更换图片

如果您的邮件已使用带动态行的表格区块列出商品（行别名为 Klaviyo 默认的 `item`），请使用此方案。

1. 选中该行的商品图片。
2. 将其图片 URL（动态图片）设置为 **设计图片 URL** 代码：

```
{% 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. 若要添加返回设计的链接，请将 **设计链接** 代码粘贴到该行的文字中：

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

如果您的行使用的别名不是 `item`，请将 `item.` 替换为您自己的别名。

## 启用流程前先预览

在邮件编辑器中点击 **Preview**，然后选择一个最近的事件（Klaviyo 会列出最近 10 个）。个性化的订单行会展示设计图片，其他订单行则展示商品图片。

## 须知

- **没有设计图片？** 如果买家将商品加入购物车时设计图片未能保存，该订单行会展示商品图片，不会出现任何问题。
- **附加商品和组合：** 附加商品以及组合中的商品会作为各自独立的订单行展示，并各自带有自己的设计。
- **隐藏字段：** 订单行还包含名称以 `_cm-` 开头的技术字段（打印文件、ID）。代码不会展示这些字段。
- **图片存放位置：** 设计图片是存放在 cdn.customix.io 上的公开图片（JPEG，约 1000–1200 px，约 100 KB），因此邮件客户端可以加载。
- **隐私：** 模板代码无需连接：Klaviyo 会从 Shopify 读取订单。只有在您连接 Klaviyo 密钥之后，Customix 才会发送自己的事件，且仅针对此后下的订单。

## 将个性化订单发送到 Klaviyo

连接您的 Klaviyo 账户后，Customix 会为每个带有设计的订单发送一个 **Customix Personalized Order** 事件，其中包含设计图片、设计链接以及买家选择的选项。您可以用它来触发流程（例如展示设计的感谢邮件、复购提醒），并为进行个性化的买家建立细分。

### 1\. 在 Klaviyo 中创建私有 API 密钥

1. 在 Klaviyo 中打开 **Settings > API keys**（Account > Settings > API keys）。
2. 在 **Private API Keys** 下点击 **Create Private API Key**。
3. 为密钥命名，例如 `Customix`。
4. 选择 **Custom Key**，将 **Accounts** 设为 Read Access，将 **Events** 设为 Full Access，其余全部保持 No Access。
5. 点击 **Create**，然后立即复制密钥。它以 `pk_` 开头。

请妥善保管密钥：任何持有密钥的人都可以向您的 Klaviyo 账户写入数据。不要通过邮件或聊天发送，只能粘贴到 Customix 应用中。

### 2\. 在 Customix 中连接

只有店铺所有者可以连接、更换或断开 Klaviyo：密钥决定了由哪个 Klaviyo 账户接收买家的订单。员工看到的是一条提示，而不是表单。

1. 在 Customix 应用中打开 **设置 > 集成 > Klaviyo**。
2. 在 **将订单发送到 Klaviyo** 卡片中，将密钥粘贴到 **私有 API 密钥** 中，然后点击 **连接**。
3. Customix 会先通过 Klaviyo 验证密钥，然后再保存。随后卡片会显示 **已连接到 {Klaviyo 账户}**、密钥的最后四位字符，以及最近一次发送订单的时间。

如果 Klaviyo 拒绝该密钥，卡片会在输入框下方给出提示。请确认这是一个私有密钥（`pk_…`），并且具有 Accounts（读取）和 Events（完全）权限。

此后，每个带有设计的新订单会在几分钟内发送。连接之前下的订单不会发送。

### 事件包含的内容

**Customix Personalized Order** 事件每个订单只发送一次，且仅针对至少有一个设计的订单。其属性如下：

- `OrderNumber`、`OrderId`：Shopify 订单名称（#1001）和 ID。
- `ProductName`、`ImageURL`、`DesignURL`：第一个个性化订单行的商品、设计图片，以及重新打开设计的链接。
- `ItemNames`、`ItemCount`：个性化订单行。
- `Items`：每个个性化订单行，包含 `ProductName`、`VariantName`、`ProductID`、`VariantID`、`SKU`、`Quantity`、`ItemPrice`、`ImageURL`、`DesignURL`、`CustomizationID` 和 `Options`（买家选择的选项，按名称列出）。
- 事件的价值为订单总额，币种与订单一致。

由该事件触发的流程邮件中的示例：

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

买家的 Klaviyo 个人资料也会获得以下属性，便于用于细分和后续邮件：

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

### 创意用法

- **感谢流程：** 由 Customix Personalized Order 触发，展示 `event.ImageURL`。
- **细分：** "What someone has done: Customix Personalized Order at least once"，用于筛选进行个性化的买家。
- **复购或礼物提醒：** 在 `Customix Last Personalized Order At` 的周年纪念日之前发送，展示 `person|lookup:'Customix Last Design Image'`。

### 买家上传的照片

**发送买家上传的照片** 默认关闭，因为照片中可能有人物。开启后，照片链接会随选项一起发送。设计图片始终会发送：它只展示照片在商品上的印刷效果。

### 关于连接

- Customix 只会使用您的密钥发送到您自己的 Klaviyo 账户。您可以随时点击 **断开连接**；已发送的事件会保留在 Klaviyo 中。卸载 Customix 时也会删除密钥。
- Shopify 有时会重复推送同一个订单；Klaviyo 每个订单只保留一个事件。
- 该事件不会更改任何人的邮件或短信订阅许可。与任何流程一样，Klaviyo 只会向可以接收营销信息的人发送邮件。
- 没有买家邮箱的订单不会发送，因为 Klaviyo 需要个人资料。
- 如果 Klaviyo 不再接受该密钥（已删除、权限已更改），卡片会显示 **需要处理** 以及 Klaviyo 给出的原因。点击 **更换密钥** 粘贴新的密钥。

## 仍需要帮助？

我们的支持团队会一步步为您解答。请给我们发邮件，或预约与团队通话。

[发邮件联系支持 →](mailto:support@customix.io?subject=Customix%20support)[预约通话](https://calendly.com/customix-support/30min)
