Klaviyo のカート放棄、注文確認、発送のメールには、購入者がパーソナライズした内容ではなく商品画像が表示されます。Customix はすべての注文明細にデザインをすでに保存しており、Klaviyo は Shopify からそれを同期します。短いテンプレートコードを Klaviyo のメールに貼り付けると、各明細に次の内容が表示されます。
- 購入者のデザイン画像(デザインがない明細では商品画像)
- 購入者が選択したオプション(技術的なフィールドは非表示で、アップロードされた写真は View image リンクになります)
- 保存したデザインを、どのデバイスでも商品ページで開き直せるリンク

始める前に
- Klaviyo が Shopify ストアと連携されていること(Klaviyo > Integrations > Shopify)。
- メールが、次のいずれかの Shopify イベントで開始されるフローに属していること:Checkout Started(カート放棄)、Placed Order(注文確認)、Fulfilled Order(発送)。これらのイベントには注文明細が含まれます。
- Added to Cart には Klaviyo で注文明細が含まれないため、このコードは Added to Cart のフローでは動作しません。
コードは Customix アプリの 設定 > 連携 > Klaviyo にある メールテンプレートコード カードで確認できます。各コードに コピー ボタンがあります。
オプション 1:注文明細ブロックを追加する
メールにまだ商品が一覧表示されていない場合や、一覧を置き換えたい場合にご利用ください。
- Klaviyo でフローのメールを開き、Edit をクリックします。
- 商品を表示したい場所に HTML ブロックをドラッグします。
- デザイン画像付き注文明細 のコードを貼り付けます。
{% 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" のほうが適している場合が多くあります。

オプション 2:商品テーブルはそのままで画像を変更する
メールがすでに動的行を持つテーブルブロックで商品を一覧表示している場合(行のエイリアスは Klaviyo の既定値の item)にご利用ください。
- その行の商品画像を選択します。
- 画像 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 %}- デザインへのリンクを追加するには、行のテキスト内に デザインリンク のコードを貼り付けます。
{% 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 キーを作成する
- Klaviyo で Settings > API keys を開きます(Account > Settings > API keys)。
- Private API Keys の下で、Create Private API Key をクリックします。
- キーに名前を付けます(例:
Customix)。 - Custom Key を選択し、Accounts を Read Access、Events を Full Access に設定して、それ以外はすべて No Access のままにします。
- Create をクリックし、すぐにキーをコピーします。キーは
pk_で始まります。
キーは公開しないでください。キーを持つ人は誰でも Klaviyo アカウントにデータを書き込めます。メールやチャットで送らず、Customix アプリにのみ貼り付けてください。
2. Customix で接続する
Klaviyo の接続、キーの置き換え、接続の解除ができるのはストアオーナーのみです。キーによって、購入者の注文を受け取る Klaviyo アカウントが決まるためです。スタッフにはフォームの代わりに案内が表示されます。
- Customix アプリで 設定 > 連携 > Klaviyo を開きます。
- 注文をKlaviyoに送信 カードで、プライベートAPIキー にキーを貼り付け、接続 をクリックします。
- 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 ProductCustomix Last Design ImageCustomix Last Design URLCustomix 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 からの理由が表示されます。キーを置き換え をクリックして新しいキーを貼り付けてください。