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

  • 購入者のデザイン画像(デザインがない明細では商品画像)
  • 購入者が選択したオプション(技術的なフィールドは非表示で、アップロードされた写真は View image リンクになります)
  • 保存したデザインを、どのデバイスでも商品ページで開き直せるリンク
デザイン画像が表示された、パーソナライズ済みのカップ 2 点を含む 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)は、メールに合わせて変更できます。カート放棄メールでは、"View your design" より "Finish 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 から注文を読み取ります。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 からの理由が表示されます。キーを置き換え をクリックして新しいキーを貼り付けてください。