ドキュメント
共通設定

Klaviyo 連携(ベータ版)

Klaviyo と連携すると、返品・交換の申請や承認、返金、商品のお届けなどがあったときに、Klaviyo のお客様のプロフィールにイベントとして記録されます。記録したイベントは、Klaviyo のフロー(自動で送るメール)の起点や、セグメントの条件に使えます。

ベータ版です

Klaviyo 連携はベータ版です。

  • ご利用いただけるのは、Recustomer からご案内したストアだけです
  • イベントの名前と項目は、今後変わることがあります。変えるときは、名前の末尾の版(_v0)を上げた別のイベントとして送り、事前にご案内します
  • 不具合やご要望は、Recustomer の担当者までお知らせください

1. 記録されるイベント

返品・交換

イベント名記録するとき
BETA_requested_return_v0返品・交換の申請が作られたとき(返品ポータル・管理画面・CSV のどれから作っても記録します)
BETA_approved_return_v0申請の商品を承認したとき(申請時の自動承認を含みます)
BETA_rejected_return_v0申請の商品の承認を拒否したとき(申請時の自動拒否を含みます)
BETA_received_return_v0返送された商品を受入済みにしたとき
BETA_refunded_return_v0元の支払い方法への返金を返金済みにしたとき(ストアクレジットでの返金と、返金の拒否では記録しません)
BETA_shipped_exchange_v0交換品を発送済みにしたとき

承認・拒否・受入・交換品の発送のイベントは、商品ごとではなく、操作 1 回につき 1 件送ります。複数の商品をまとめて承認した場合などは、それらの商品が 1 件のイベントの items にまとめて入ります。

配送

配送追跡をご利用のストアで、発送の配送状況が変わったときに記録します。配送状況の意味は、配送会社のステータスとの対応表をご覧ください。

イベント名変わった先の配送状況
BETA_info_received_fulfillment_v0荷物受付け
BETA_in_transit_fulfillment_v0配送中
BETA_available_for_pickup_fulfillment_v0受取可能
BETA_delivered_fulfillment_v0お届け完了
BETA_attempt_fail_fulfillment_v0ご不在のため持ち戻り
BETA_exception_fulfillment_v0配送トラブル
BETA_expired_fulfillment_v0保管期限の超過

配送のイベントは、発送ごとに、それぞれの配送状況に初めて変わったときの 1 回だけ記録します。持ち戻りの後にもう一度配送中になったときや、2 回目の持ち戻りでは記録しません。

記録する相手

イベントは、注文または申請のお客様のメールアドレスのプロフィールに記録します。メールアドレスが無い注文・申請では記録しません。

2. イベントの項目

Klaviyo のメールの本文では、{{ event.order_number }} のように項目の名前で値を差し込めます。値が無い項目は null になります。

商品の一覧(items)は、1 つずつ取り出して並べます。{% for item in event.items %} と {% endfor %} で囲んだ部分が商品の数だけ繰り返され、その中では {{ item.product_name }} のように item. に続けて商品の項目の名前を書きます。

{% for item in event.items %}
{{ item.product_name }}({{ item.sku }})
{% endfor %}

返品・交換のイベント

項目内容例
return_idRecustomer の返品の番号5424
rma_number返品申請 ID#1001_01
order_number注文番号#1001
items商品の一覧(下の表)
request_channel申請した経路。申請のイベントだけreturn_portal(返品ポータル)、merchant_dashboard(管理画面)、csv_import(CSV)
refund_amount確定した返金額。返金のイベントだけ1000.0
refund_currency返金額の通貨。返金のイベントだけ。通貨を確定できない場合は nullJPY

items の商品ごとに、次の項目が入ります。

項目内容例
product_name商品名Tシャツ ホワイト / M
skuSKUTS-WH-M
price商品の価格3300.0
currency価格の通貨JPY
image_url商品の画像の URL。交換品の発送のイベントには入りません
reject_reason承認しなかった理由。拒否のイベントだけ
arrival_date返送された商品が届いた日(YYYY-MM-DD)。受入のイベントだけ2026-01-01

配送のイベント

項目内容例
order_number注文番号#1001
tracking_number追跡番号123456789012
carrier配送会社yamato、sagawa、jp、seino_unyu、eco_hai、dhl、ninjavan、askullogist、global、others
items発送した商品の一覧。要素の項目は product_name・sku・quantity(数量)・price・currency・image_url
delivered_dateお届けの日(日本時間の YYYY-MM-DD)。お届け完了のイベントだけ2026-01-01
delivered_atお届けの日時(日本時間)。お届け完了のイベントだけ。配送会社が時刻を示していない場合は null2026-01-01T12:00:00+09:00

3. 連携の手順

連携できる Klaviyo アカウントは、1 つのストアにつき 1 つです。1 つの Klaviyo アカウントを、複数のストアと連携することもできません。

  1. Recustomer の 設定 > 外部サービス連携 > 連携サービス > Klaviyo へ移動します

  2. 「Klaviyo と連携する」を押します

  3. Klaviyo の画面に移るので、連携する Klaviyo アカウントにログインし、連携を許可します

    Recustomer が求める権限は、アカウント情報の読み取りと、イベントの書き込みだけです。お客様のプロフィールやリストを読み取ることはありません。

    ※「App has not been reviewed」と表示された場合は、「Continue」を押して進んでください

  4. Recustomer の画面に戻り、「Klaviyo と連携しました」と表示されたら完了です

    連携した Klaviyo のアカウント名・アカウント ID・連携した日時が表示されます。

連携を解除するときは、同じ画面の「連携を解除する」を押します。

連携できなかったとき

表示対処
この Klaviyo アカウントは、別のストアと連携しています別の Klaviyo アカウントで連携してください
このストアは、別の Klaviyo アカウントと連携しています連携するアカウントを変える場合は、先に連携を解除してください
Klaviyo 側で連携が外されたか、期限が切れました「もう一度連携する」から連携し直してください
追加の許可が必要です「もう一度連携する」から、すべての権限を許可してください

4. 連携した直後に届くサンプルのイベント

Klaviyo でフローやセグメントを作るときは、一度も届いたことのないイベントを一覧から選べません。そこで、連携が完了した時点で、「1. 記録されるイベント」の 13 種類のイベントのサンプルを 1 件ずつ送ります。これにより、実際の返品・交換や配送がまだ無くても、連携した直後からフローを作り始められます。

  • サンプルのイベントは、「Recustomer 見本」という名前のプロフィールに付きます
  • 注文番号は #1001、商品名は「見本の商品」です。項目には is_sample: true が付きます
  • このプロフィールはメールアドレスも電話番号も持たないため、フローを公開していてもメール・SMS は送られません
  • 連携し直しても、サンプルのイベントは増えません

セグメントの人数に入ります

サンプルのイベントが付いたプロフィールは、Recustomer のイベントを条件にしたセグメントの人数に入ります。除きたい場合は、セグメントの条件に「Properties about someone」で「First Name」が「Recustomer 見本」と等しくない(doesn't equal)を足してください。

メールアドレスの無いプロフィールは、Klaviyo の「Profiles and Email」プランで課金される人数に数えられません(Klaviyo のヘルプ)。

5. 補足

  • 連携していない間(連携する前・連携を解除している間・連携が切れている間)のイベントは、Klaviyo に届きません。後から送り直すこともありません
  • 同じイベントが Klaviyo に二重に記録されることはありません
  • 返品・交換のイベントは、操作してから通常数分以内に記録されます。配送のイベントは、配送追跡で配送状況を取得したときに記録されます
© Recustomer, Inc.