Email giỏ hàng bị bỏ quên, xác nhận đơn hàng và giao hàng của Klaviyo hiển thị ảnh sản phẩm, không phải nội dung người mua đã cá nhân hóa. Customix đã lưu thiết kế trên mỗi dòng đơn hàng, và Klaviyo đồng bộ dữ liệu này từ Shopify. Hãy dán một đoạn mã mẫu ngắn vào email Klaviyo, mỗi dòng sẽ hiển thị:
- ảnh thiết kế của người mua (hoặc ảnh sản phẩm khi dòng đó không có thiết kế);
- các tùy chọn người mua đã chọn (các trường kỹ thuật được ẩn; ảnh tải lên trở thành liên kết View image);
- một liên kết mở lại thiết kế đã lưu trên trang sản phẩm, trên mọi thiết bị.

Trước khi bắt đầu
- Klaviyo đã được kết nối với cửa hàng Shopify của bạn (Klaviyo > Integrations > Shopify).
- Email thuộc một flow được kích hoạt bởi một trong các sự kiện Shopify sau: Checkout Started (giỏ hàng bị bỏ quên), Placed Order (xác nhận đơn hàng) hoặc Fulfilled Order (giao hàng). Các sự kiện này có chứa các dòng đơn hàng.
- Added to Cart không chứa dòng đơn hàng trong Klaviyo, nên mã này không hoạt động trong các flow Added to Cart.
Bạn có thể tìm mã trong ứng dụng Customix: Cài đặt > Tích hợp > Klaviyo, thẻ Mã mẫu email, với nút Sao chép cho từng đoạn mã.
Cách 1: thêm khối dòng đơn hàng
Dùng cách này khi email của bạn chưa liệt kê sản phẩm, hoặc khi bạn muốn thay thế danh sách hiện có.
- Trong Klaviyo, mở email của flow và nhấp Edit.
- Kéo một khối HTML đến vị trí cần hiển thị sản phẩm.
- Dán mã Dòng đơn hàng kèm ảnh thiết kế:
{% 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 %}Bạn có thể thay đổi các từ "Qty", "View image" và "View your design", màu sắc và chiều rộng ảnh (120) cho phù hợp với email của bạn. Trong email giỏ hàng bị bỏ quên, "Finish your design" thường phù hợp hơn "View your design".

Cách 2: giữ bảng sản phẩm, thay ảnh của bảng
Dùng cách này khi email của bạn đã liệt kê sản phẩm trong khối bảng có các dòng động (bí danh dòng là item, mặc định của Klaviyo).
- Chọn ảnh sản phẩm của dòng.
- Đặt URL ảnh (ảnh động) của dòng thành mã URL ảnh thiết kế:
{% 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 %}- Để thêm liên kết quay lại thiết kế, hãy dán mã Liên kết thiết kế vào phần văn bản của dòng:
{% if item.product.properties|lookup:'_cm-customization-url' %}<a href="{{ item.product.properties|lookup:'_cm-customization-url' }}">View your design</a>{% endif %}Nếu các dòng của bạn dùng bí danh khác item, hãy thay item. bằng bí danh của bạn.
Xem trước trước khi bật flow
Trong trình soạn thảo email, nhấp Preview và chọn một sự kiện gần đây (Klaviyo liệt kê 10 sự kiện gần nhất). Các dòng được cá nhân hóa hiển thị ảnh thiết kế; các dòng khác hiển thị ảnh sản phẩm.
Cần biết
- Không có ảnh thiết kế? Nếu không thể lưu ảnh thiết kế khi người mua thêm sản phẩm vào giỏ hàng, dòng đó sẽ hiển thị ảnh sản phẩm. Không có gì bị lỗi.
- Add-on và bundle: các sản phẩm add-on và các sản phẩm trong một bundle hiển thị thành các dòng riêng, mỗi dòng có thiết kế riêng.
- Trường ẩn: các dòng đơn hàng còn chứa các trường kỹ thuật có tên bắt đầu bằng
_cm-(tệp in, ID). Mã sẽ không bao giờ hiển thị chúng. - Vị trí lưu ảnh: ảnh thiết kế là ảnh công khai trên cdn.customix.io (JPEG, khoảng 1000–1200 px, khoảng 100 KB), nên các ứng dụng email có thể tải được.
- Quyền riêng tư: Mã mẫu không cần kết nối: Klaviyo đọc đơn hàng từ Shopify. Customix chỉ gửi sự kiện riêng của mình sau khi bạn kết nối key Klaviyo, và chỉ cho các đơn hàng được đặt từ thời điểm đó.
Gửi các đơn hàng cá nhân hóa tới Klaviyo
Kết nối tài khoản Klaviyo của bạn và Customix sẽ gửi sự kiện Customix Personalized Order cho mọi đơn hàng có thiết kế: ảnh thiết kế, liên kết đến thiết kế và các tùy chọn người mua đã chọn. Hãy dùng sự kiện này để kích hoạt flow (email cảm ơn hiển thị thiết kế, nhắc đặt lại) và tạo segment gồm những người mua có cá nhân hóa.
1. Tạo private API key trong Klaviyo
- Trong Klaviyo, mở Settings > API keys (Account > Settings > API keys).
- Trong Private API Keys, nhấp Create Private API Key.
- Đặt tên cho key, ví dụ
Customix. - Chọn Custom Key, đặt Accounts là Read Access và Events là Full Access, các mục còn lại để No Access.
- Nhấp Create, rồi sao chép key ngay. Key bắt đầu bằng
pk_.
Hãy giữ key ở chế độ riêng tư: bất kỳ ai có key đều có thể ghi dữ liệu vào tài khoản Klaviyo của bạn. Đừng gửi key qua email hoặc chat; chỉ dán key vào ứng dụng Customix.
2. Kết nối trong Customix
Chỉ chủ cửa hàng mới có thể kết nối, thay hoặc ngắt kết nối Klaviyo: key quyết định tài khoản Klaviyo nào nhận đơn hàng của người mua. Nhân viên sẽ thấy một thông báo thay cho biểu mẫu.
- Trong ứng dụng Customix, mở Cài đặt > Tích hợp > Klaviyo.
- Trong thẻ Gửi đơn hàng tới Klaviyo, dán key vào API key riêng tư và nhấp Kết nối.
- Customix kiểm tra key với Klaviyo trước khi lưu. Sau đó thẻ hiển thị Đã kết nối với {tài khoản Klaviyo của bạn}, bốn ký tự cuối của key và thời điểm đơn hàng gần nhất được gửi.
Nếu Klaviyo từ chối key, thẻ sẽ thông báo ngay bên dưới ô nhập. Hãy kiểm tra đó là private key (pk_…) có quyền Accounts (đọc) và Events (đầy đủ).
Từ đó trở đi, mọi đơn hàng mới có thiết kế sẽ được gửi trong vòng vài phút. Các đơn hàng được đặt trước khi bạn kết nối sẽ không được gửi.
Nội dung của sự kiện
Sự kiện Customix Personalized Order được gửi một lần cho mỗi đơn hàng, chỉ với các đơn hàng có ít nhất một thiết kế. Các thuộc tính của sự kiện:
OrderNumber,OrderId: tên đơn hàng Shopify (#1001) và ID.ProductName,ImageURL,DesignURL: dòng cá nhân hóa đầu tiên: sản phẩm, ảnh thiết kế và liên kết mở lại thiết kế.ItemNames,ItemCount: các dòng được cá nhân hóa.Items: mọi dòng được cá nhân hóa, gồmProductName,VariantName,ProductID,VariantID,SKU,Quantity,ItemPrice,ImageURL,DesignURL,CustomizationIDvàOptions(các tùy chọn người mua đã chọn, theo tên).- Giá trị của sự kiện là tổng đơn hàng, theo đơn vị tiền tệ của đơn hàng.
Ví dụ trong email của flow được kích hoạt bởi sự kiện:
<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 %}Hồ sơ Klaviyo của người mua cũng nhận các thuộc tính sau, hữu ích cho segment và các email sau này:
Customix Last Personalized ProductCustomix Last Design ImageCustomix Last Design URLCustomix Last Personalized Order At
Ý tưởng sử dụng
- Flow cảm ơn được kích hoạt bởi Customix Personalized Order, hiển thị
event.ImageURL. - Segment "What someone has done: Customix Personalized Order at least once" cho những người mua có cá nhân hóa.
- Nhắc đặt lại hoặc nhắc tặng quà trước ngày kỷ niệm của
Customix Last Personalized Order At, hiển thịperson|lookup:'Customix Last Design Image'.
Ảnh người mua đã tải lên
Gửi ảnh người mua đã tải lên được tắt theo mặc định, vì ảnh có thể chứa hình người. Khi bật, các liên kết đến ảnh được gửi cùng với các tùy chọn. Ảnh thiết kế luôn được gửi: ảnh này chỉ hiển thị bức ảnh như khi được in trên sản phẩm.
Về kết nối
- Customix chỉ gửi đến tài khoản Klaviyo của chính bạn, bằng key của bạn. Bạn có thể nhấp Ngắt kết nối bất cứ lúc nào; các sự kiện đã gửi vẫn nằm trong Klaviyo. Gỡ cài đặt Customix cũng sẽ xóa key.
- Đôi khi Shopify gửi một đơn hàng hai lần; Klaviyo chỉ giữ một sự kiện cho mỗi đơn hàng.
- Sự kiện này không thay đổi sự đồng ý nhận email hoặc SMS của bất kỳ ai. Klaviyo chỉ gửi email cho những người có thể nhận tiếp thị, như với mọi flow.
- Đơn hàng không có email của người mua sẽ không được gửi, vì Klaviyo cần có hồ sơ.
- Nếu Klaviyo không còn chấp nhận key (đã xóa, phạm vi quyền thay đổi), thẻ hiển thị Cần chú ý kèm lý do từ Klaviyo. Nhấp Thay key để dán key mới.