---
title: "Klaviyo メールに購入者のデザインを表示する | ヘルプセンター | Customix"
description: "テンプレートコードで Klaviyo のメールに購入者のパーソナライズしたデザインを表示し、フローやセグメント用に Customix Personalized Order イベントを Klaviyo に送信できます。"
url: https://customix.io/ja/help/klaviyo-email-design-images
language: ja
---

# Klaviyo メールに購入者のデザインを表示する

テンプレートコードで Klaviyo のメールに購入者のパーソナライズしたデザインを表示し、フローやセグメント用に Customix Personalized Order イベントを Klaviyo に送信できます。

更新日：2026年11月20日

Klaviyo のカート放棄、注文確認、発送のメールには、購入者がパーソナライズした内容ではなく商品画像が表示されます。Customix はすべての注文明細にデザインをすでに保存しており、Klaviyo は Shopify からそれを同期します。短いテンプレートコードを Klaviyo のメールに貼り付けると、各明細に次の内容が表示されます。

- 購入者のデザイン画像（デザインがない明細では商品画像）
- 購入者が選択したオプション（技術的なフィールドは非表示で、アップロードされた写真は **View image** リンクになります）
- 保存したデザインを、どのデバイスでも商品ページで開き直せるリンク

![デザイン画像が表示された、パーソナライズ済みのカップ 2 点を含む 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）は、メールに合わせて変更できます。カート放棄メールでは、"View your design" より "Finish 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 から注文を読み取ります。Customix が独自のイベントを送信するのは、Klaviyo のキーを接続した後で、接続以降に行われた注文に限られます。

## パーソナライズされた注文を 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 アカウント}に接続済み**、キーの末尾 4 文字、最後に注文を送信した日時が表示されます。

Klaviyo がキーを受け付けない場合は、フィールドの下にその旨が表示されます。プライベートキー（`pk_…`）であり、Accounts（読み取り）と Events（フル）のアクセス権があることを確認してください。

以降、デザインのある新しい注文は数分以内に送信されます。接続前に行われた注文は送信されません。

### イベントの内容

**Customix Personalized Order** イベントは、注文ごとに 1 回、デザインが 1 つ以上ある注文に対してのみ送信されます。プロパティは次のとおりです。

- `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 が注文を 2 回配信することがありますが、Klaviyo は 1 注文につき 1 件のイベントのみ保持します。
- このイベントは、誰のメールや SMS の同意設定も変更しません。他のフローと同様に、Klaviyo はマーケティングを受信できる人にのみメールを送信します。
- 購入者のメールアドレスがない注文は、Klaviyo にプロフィールが必要なため送信されません。
- Klaviyo がキーを受け付けなくなった場合（削除、権限の変更など）、カードに **要確認** と Klaviyo からの理由が表示されます。**キーを置き換え** をクリックして新しいキーを貼り付けてください。

## まだ解決しませんか？

サポートチームがご案内します。メールでご連絡いただくか、チームとの通話を予約してください。

[メールで問い合わせる →](mailto:support@customix.io?subject=Customix%20support)[通話を予約](https://calendly.com/customix-support/30min)
