Klaviyo

設定にお手伝いが必要ですか？ 私たちのチームがShopify Flow + Klaviyo統合全体を設定できます。ご連絡ください。対応します。

必要なもの

Shopify Flow（すべてのShopifyプランで利用可能）
Klaviyo ShopifyアプリがインストールされたKlaviyoアカウント
Shopify Flowトリガーが有効になったRevizeのインストール

仕組み

Revizeはお客様が注文を編集するたびにShopify Flowトリガーを発火させます。そのトリガーをKlaviyoの「Track an Event」アクションに接続すると、注文データがKlaviyoに送信されます。そこから、Klaviyo Flowを構築してメールを送信します。 Revizeトリガー → Shopify Flow → Klaviyoイベント → Klaviyoメール

利用可能なトリガー

これらのRevizeトリガーのいずれかでKlaviyoメールを送信できます。

注文が編集された

商品の変更やディスカウントコード編集を含む、任意の注文編集で発火します。

配送先住所が更新された

お客様が配送先を変更したときに発火します。

メールアドレスが更新された

お客様がメールアドレスを更新したときに発火します。

電話番号が更新された

お客様が電話番号を更新したときに発火します。

配送日が更新された

お客様が配送日を選択または変更したときに発火します。

注文がキャンセルされた

お客様が注文をキャンセルしたときに発火します。

サポートチケットが作成された

お客様がポータルからサポートリクエストを送信したときに発火します。

税務インボイスが生成された

お客様が注文の税務インボイスを生成したときに発火します。

各トリガーは同じ設定プロセスに従います。変わるのは、Shopify Flowで選択するトリガー、Klaviyoに送信するイベント名、イベントプロパティだけです。

パート1：Shopify Flowのセットアップ

ステップ1：Klaviyoのパブリックアプリキーを見つける

Klaviyoにログイン

Klaviyoダッシュボードに移動します。

Settingsを開く

左下隅のアカウント名をクリックし、Settingsに移動します。

API Keysに移動

API Keysセクションに移動します。

パブリックAPIキーをコピー

Public API Key（短い英数字コード）をコピーします。これはステップ3で必要になります。

必ずPublic APIキーをコピーしてください。Private APIキーではありません。パブリックキーは短い方です。

ステップ2：Shopify Flowワークフローを作成

Shopify Flowを開く

Shopify管理画面で、Apps → Shopify Flowに移動し、Create workflowをクリックします。

Revizeトリガーを選択

Select a triggerをクリックし、Revizeを検索して、必要なトリガー（例：Order edited、Shipping address updatedなど）を選びます。

Waitアクションを追加

トリガーの下の**+をクリックし、Waitアクションを追加します。期間を10秒**に設定します。

Get Order Dataアクションを追加

Waitステップの下の**+**をクリックし、Get Order Dataアクション（Shopifyアクション）を追加します。次のように設定します。

Select a queryをAdvancedに設定
Edit queryフィールドに次を入力：id:{{order.legacyResourceId}}
Maximum number of ordersを1に設定
Sort data byをUpdated at, Descendingに設定

なぜ10秒待つのか？ ShopifyのAPIが新鮮なデータを取得する前に、最新の注文変更を反映する時間を与えます。Get Order Dataステップが、現在の正しい品目とバリアントを取得します。

ステップ3：Klaviyo「Track an Event」アクションを追加

Klaviyoを検索

アクションリストでKlaviyoを検索し、Track an Eventを選択します。

フィールドに記入

以下の表を使って各フィールドに記入します。

フィールド	値
Klaviyo Public API Key	ステップ1のパブリックAPIキー
Event Name	以下のイベント名表を参照
Customer Email Address	`{{order.customer.email}}`
Customer First Name	`{{order.customer.firstName}}`
Customer Last Name	`{{order.customer.lastName}}`

トリガー別のイベント名

各トリガーをKlaviyoで識別できるよう、説明的なイベント名を使用します。

Revizeトリガー	推奨イベント名
注文が編集された	`Revize_Order_Edited`
配送先住所が更新された	`Revize_Address_Updated`
メールアドレスが更新された	`Revize_Email_Updated`
電話番号が更新された	`Revize_Phone_Updated`
配送日が更新された	`Revize_Delivery_Date_Updated`
注文がキャンセルされた	`Revize_Order_Cancelled`
サポートチケットが作成された	`Revize_Support_Ticket`
税務インボイスが生成された	`Revize_Tax_Invoice`

これらのイベントには好きな名前を付けられます。これらは整理のための推奨名にすぎません。

ステップ4：顧客プロパティを設定

Customer Propertiesフィールドに、次のJSONを貼り付けます：

{
  "$email": "{{order.customer.email}}",
  "$first_name": "{{order.customer.firstName}}",
  "$last_name": "{{order.customer.lastName}}"
}

これにより、イベントを関連付ける顧客プロフィールがKlaviyoに伝わります。

ステップ5：イベントプロパティを設定

Event Propertiesフィールドに、トリガーに合うJSONを貼り付けます。これはGet Order Dataステップから取得した新鮮な注文データを使用するため、Klaviyoは常に正しい現在のデータを取得します。

注文が編集された
住所／メール／電話／配送日
キャンセル

更新された注文の完全な詳細（品目を含む）を送信したい場合に使用します：

{% for single_order in getOrderData %}
{
  "order_id": "{{single_order.id}}",
  "order_name": "{{single_order.name}}",
  "order_number": "{{single_order.legacyResourceId}}",
  "total_price": "{{single_order.totalPriceSet.shopMoney.amount}}",
  "subtotal_price": "{{single_order.subtotalPriceSet.shopMoney.amount}}",
  "total_tax": "{{single_order.totalTaxSet.shopMoney.amount}}",
  "total_shipping": "{{single_order.totalShippingPriceSet.shopMoney.amount}}",
  "currency": "{{single_order.currencyCode}}",
  "edited_at": "{{single_order.updatedAt}}",
  "customer_email": "{{single_order.customer.email}}",
  "customer_name": "{{single_order.customer.firstName}} {{single_order.customer.lastName}}",
  "line_items": [{% assign comma = "" %}{% for item in single_order.lineItems %}
    {% if item.currentQuantity != 0 %}{{comma}}
    {"title": {{item.title | json}}, "quantity": {{item.currentQuantity}},
     "price": "{{item.originalUnitPriceSet.shopMoney.amount}}",
     "variant_title": {{item.variantTitle | json}}, "sku": {{item.sku | json}}}
    {% assign comma = "," %}{% endif %}
  {% endfor %}]
}
{% endfor %}

line_items配列の括弧[ ]を引用符で囲まないでください。Klaviyoが適切な配列を受け取るには、括弧がすべての引用符の外にある必要があります。

配送先住所、連絡先情報、または配送日の更新に使用します。品目なしで注文の概要を送信します：

{% for single_order in getOrderData %}
{
  "order_id": "{{single_order.id}}",
  "order_name": "{{single_order.name}}",
  "order_number": "{{single_order.legacyResourceId}}",
  "total_price": "{{single_order.totalPriceSet.shopMoney.amount}}",
  "currency": "{{single_order.currencyCode}}",
  "updated_at": "{{single_order.updatedAt}}",
  "customer_email": "{{single_order.customer.email}}",
  "customer_name": "{{single_order.customer.firstName}} {{single_order.customer.lastName}}",
  "shipping_address": "{{single_order.shippingAddress.address1}}, {{single_order.shippingAddress.city}}, {{single_order.shippingAddress.province}} {{single_order.shippingAddress.zip}}, {{single_order.shippingAddress.country}}"
}
{% endfor %}

注文キャンセルイベントに使用します：

{% for single_order in getOrderData %}
{
  "order_id": "{{single_order.id}}",
  "order_name": "{{single_order.name}}",
  "order_number": "{{single_order.legacyResourceId}}",
  "total_price": "{{single_order.totalPriceSet.shopMoney.amount}}",
  "currency": "{{single_order.currencyCode}}",
  "cancelled_at": "{{single_order.updatedAt}}",
  "customer_email": "{{single_order.customer.email}}",
  "customer_name": "{{single_order.customer.firstName}} {{single_order.customer.lastName}}"
}
{% endfor %}

{% for single_order in getOrderData %}ループは、元のトリガーではなく新鮮に取得された注文データから読み取ります。これにより毎回正しいデータが保証されます。

ステップ6：ワークフローをオンにする

すべてのフィールドを確認

すべてが正しく入力されていることを確認します。

ワークフローをオンにする

右上隅のTurn on workflowをクリックします。

完了

ワークフローがアクティブになりました。お客様がRevizeを通じてそのアクションをトリガーするたびに、最新の注文データとともにイベントがKlaviyoに送信されます。

パート2：Klaviyoメールのセットアップ

ステップ7：Klaviyo Flowを作成

新しいFlowを作成

Klaviyoで、Flows → Create Flowに移動し、Build your ownを選択します。

トリガーを設定

トリガーには、Metricを選択し、使用したイベント名（例：Revize_Order_Edited）を検索します。

メールアクションを追加

フローにEmailアクションをドラッグします。

テンプレートをデザイン

以下の変数を使って注文データを動的に取り込みます。

ステップ8：メールテンプレート変数

Klaviyoメールテンプレートでこれらの変数を使用します：

データ	Klaviyo変数
顧客名	`{{ event.customer_name }}`
注文番号	`{{ event.order_name }}`
小計	`{{ event.subtotal_price }}`
合計税金	`{{ event.total_tax }}`
配送	`{{ event.total_shipping }}`
合計価格	`{{ event.total_price }}`
通貨	`{{ event.currency }}`
編集日	`{{ event.edited_at }}`
顧客メール	`{{ event.customer_email }}`
配送先住所	`{{ event.shipping_address }}`

品目の表示

編集された注文の各商品を表示するには、Klaviyoメールテンプレートでこのループを使用します：

{% for item in event.line_items %}
  {{ item.title }}
  Variant: {{ item.variant_title }}
  Qty: {{ item.quantity }}
  Price: {{ item.price }}
{% endfor %}

KlaviyoメールテンプレートでHTML/CSSを使用してこのループをスタイリングし、ブランドに合わせることができます。例えば、テーブル内に配置してきれいなインボイス風にできます。

メールの例

メールの件名と本文の見え方の例：

Subject: Your order {{ event.order_name }} has been updated

Hi {{ event.customer_name }},

Your order has been updated. Here is your revised summary:

{% for item in event.line_items %}
  {{ item.title }} ({{ item.variant_title }})
  Qty: {{ item.quantity }}  |  Price: {{ item.price }} {{ event.currency }}
{% endfor %}

Total: {{ event.currency }} {{ event.total_price }}

重複メールを防ぐ

お客様が1つのセッションで複数の素早い編集を行うと、Klaviyoは複数のメールを送る場合があります。これを防ぐには：

Klaviyo Flowを開く
Flow Filterを追加
過去5分以内に顧客がこのメールを受け取った場合は抑制するように設定

トラブルシューティング

フローが「Succeeded」と表示されるが、Klaviyoにイベントがない

Shopify FlowのPublic API KeyがKlaviyoアカウントのものと一致するか再確認してください。これが最もよくある問題です。

イベントは届くがデータが空

Event Properties JSONが無効な可能性があります。文字列値内に改行がなく、line_itemsが引用符で囲まれていない[ ]括弧を使用していることを確認してください。

品目に間違ったバリアントが表示される

10秒の待機を伴うGet Order Dataステップを使用していること、Event Propertiesがorder.lineItemsを直接ではなくgetOrderDataループを使用していることを確認してください。

複数のメールが送信される

KlaviyoにFlow Filterを追加し、過去5分以内に顧客がこのメールを受け取った場合は抑制するように設定します。

Klaviyoでメトリックを見つける場所

Analytics → Metricsに移動し、イベント名（例：Revize_Order_Edited）を検索します。イベントが初めて受信されたときに自動的に作成されます。

動作したか確認する方法

KlaviyoのAudience → Profilesに移動し、顧客のメールを見つけ、Activityタブでイベントを確認します。

複数のトリガーが必要ですか？

各トリガーに別々のShopify Flowワークフローを設定できます。例えば：

ワークフロー1： 注文が編集された → Revize_Order_Edited → 「ご注文が更新されました」メール
ワークフロー2： 住所が更新された → Revize_Address_Updated → 「配送先住所が変更されました」メール
ワークフロー3： 注文がキャンセルされた → Revize_Order_Cancelled → 「ご注文がキャンセルされました」メール

各ワークフローは上記と同じ手順に従います。トリガー、イベント名、イベントプロパティを変更するだけです。

お手伝いが必要ですか？ご連絡いただければ、Shopify Flow + Klaviyo統合全体を設定します。

はじめに

基本設定

機能

テックスタック

必要なもの

仕組み

利用可能なトリガー

注文が編集された

配送先住所が更新された

メールアドレスが更新された

電話番号が更新された

配送日が更新された

注文がキャンセルされた

サポートチケットが作成された

税務インボイスが生成された

パート1：Shopify Flowのセットアップ

ステップ1：Klaviyoのパブリックアプリキーを見つける

ステップ2：Shopify Flowワークフローを作成

ステップ3：Klaviyo「Track an Event」アクションを追加

トリガー別のイベント名

ステップ4：顧客プロパティを設定

ステップ5：イベントプロパティを設定

ステップ6：ワークフローをオンにする

パート2：Klaviyoメールのセットアップ

ステップ7：Klaviyo Flowを作成

ステップ8：メールテンプレート変数

品目の表示

メールの例

重複メールを防ぐ

トラブルシューティング

複数のトリガーが必要ですか？

​必要なもの

​仕組み

​利用可能なトリガー

注文が編集された

配送先住所が更新された

メールアドレスが更新された

電話番号が更新された

配送日が更新された

注文がキャンセルされた

サポートチケットが作成された

税務インボイスが生成された

​パート1：Shopify Flowのセットアップ

​ステップ1：Klaviyoのパブリックアプリキーを見つける

​ステップ2：Shopify Flowワークフローを作成

​ステップ3：Klaviyo「Track an Event」アクションを追加

​トリガー別のイベント名

​ステップ4：顧客プロパティを設定

​ステップ5：イベントプロパティを設定

​ステップ6：ワークフローをオンにする

​パート2：Klaviyoメールのセットアップ

​ステップ7：Klaviyo Flowを作成

​ステップ8：メールテンプレート変数

​品目の表示

​メールの例

​重複メールを防ぐ

​トラブルシューティング

​複数のトリガーが必要ですか？

必要なもの

仕組み

利用可能なトリガー

パート1：Shopify Flowのセットアップ

ステップ1：Klaviyoのパブリックアプリキーを見つける

ステップ2：Shopify Flowワークフローを作成

ステップ3：Klaviyo「Track an Event」アクションを追加

トリガー別のイベント名

ステップ4：顧客プロパティを設定

ステップ5：イベントプロパティを設定

ステップ6：ワークフローをオンにする

パート2：Klaviyoメールのセットアップ

ステップ7：Klaviyo Flowを作成

ステップ8：メールテンプレート変数

品目の表示

メールの例

重複メールを防ぐ

トラブルシューティング

複数のトリガーが必要ですか？