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

  • 买家的设计图片(订单行没有设计时展示商品图片);
  • 买家选择的选项(技术字段会被隐藏;上传的照片会变成 View image 链接);
  • 一个链接,可在任意设备上于商品页面重新打开已保存的设计。
Klaviyo 订单确认邮件预览,其中两个个性化杯子展示了设计图片

开始之前

  • 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 链接

方案 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 给出的原因。点击 更换密钥 粘贴新的密钥。