Spree と外部連携する方法

このページで学べること

Spree を Klaviyo と連携する方法をご覧ください。これらの手順を完了すると、各顧客の購入履歴やウェブサイトでのアクティビティに基づいて、メールをパーソナライズし、ターゲットを絞れるようになります。Spree から同期されるデータは次のとおりです。

• 購入された商品、商品画像、バリエーションの詳細、適用された割引などを含む売上および注文データ
• 名、姓、所在地、ストアをどのように見つけたかなどの顧客情報
• 発送済み注文データ

Klaviyo で Spree 外部連携を追加してください。

1. Klaviyo で、[外部連携] タブを選択します。
2. [アプリを探す] をクリックし、Spree を検索して、カードをクリックします。次に、[インストール] をクリックします。
3. 次のページで、ストア URL と Spree の API キー/暗号化パスワードを入力する必要があります。この API キーは、Spree の管理画面で [Users] に移動してアカウントを選択し、[Generate API Key] を選択することで生成できます。
4. Klaviyo に戻り、ボックスにストア URL と API キー/暗号化されたパスワードを貼り付けます。
   

5. バージョン管理された Spree API (v1) を使用している場合は、該当するチェックボックスをオンにしてください。
6. [Spree に接続] をクリックします。
7. Spree ストアからのメール受信にオプトインした顧客を Klaviyo のリストに追加する場合は、次のページで Klaviyo リストに新しい Spree の顧客を追加 ボックスにチェックを入れてください。このボックスにチェックを入れたら、新しいオプトインが追加されるリストを選択してください。
8. 準備ができたら、[セットアップの完了] をクリックします。その後、正常に連携されたことを示す成功メッセージが表示されます。

Klaviyo オンサイトトラッキングをインストールする

Active on Site と Viewed Product の 2 つのイベントで構成されるオンサイト トラッキングをインストールするには、まず公開 API キーを見つけます。Klaviyo アカウントにログインし、[アカウント名] > [設定] > [API キー] に移動します。公開キーの長さは 6 文字です。次のステップで使用するために、このキーを安全にコピーします。

活用できるオンサイト トラッキングには 2 種類あります：

• サイト上でアクティブ
  このメトリックは、識別可能なブラウザがウェブサイトにアクセスするたびにトラッキングされます。
• 「商品閲覧」
  このメトリックは、識別可能なブラウザがウェブサイト上の商品ページを閲覧するたびにトラッキングされます。

[サイト上でアクティブ] トラッキング

このメトリックは、識別可能なブラウザがウェブサイトにアクセスするたびにトラッキングされます。

1. 「アクティブ（サイト上）」アクティビティのトラッキングを開始するには、すべてのページに含まれるように、次のコード スニペットをメインのストア テンプレートに追加してください。このスニペットは、使用している他の分析スクリプトと一緒に配置するか、閉じる </body> タグの直前に配置してください。
2. Public API Key を Klaviyo アカウントの公開 API キーに置き換えてください：

<script type="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=PUBLIC_API_KEY"></script>
<script type="text/javascript"> 
//Initialize the Klaviyo object on page load
!function(){if(!window.klaviyo){window._klOnsite=window._klOnsite||[];try{window.klaviyo=new Proxy({},{get:function(n,i){return"push"===i?function(){var n;(n=window._klOnsite).push.apply(n,arguments)}:function(){for(var n=arguments.length,o=new Array(n),w=0;w<n;w++)o[w]=arguments[w];var t="function"==typeof o[o.length-1]?o.pop():void 0,e=new Promise((function(n){window._klOnsite.push([i].concat(o,[function(i){t&&t(i),n(i)}]))}));return e}}})}catch(n){window.klaviyo=window.klaviyo||[],window.klaviyo.push=function(){var n;(n=window._klOnsite).push.apply(n,arguments)}}}}(); </script>

1. ウェブサイトで使用するテンプレートの種類によって、{% if user.is_logged_in %} 構文と {{ user.email }} 構文は異なる可能性があります。利用可能なテンプレート言語を使用して、現在のページを閲覧しているユーザーがログインしているかどうかを確認します。ログインしている場合は、可能であればメールアドレスと名前を出力してください。名前の情報がない場合は、それら 2 行と、メールアドレス $email 行の後ろにある末尾のカンマを削除してください。
2. この Klaviyo トラッキングコードにより、「サイトでアクティブ」のメトリックをトラッキングできるようになり、サイト訪問や訪問者の行動に関連するデータを確認して活用できます。このメトリックにより、Klaviyo は既知のブラウザーのサイト上のアクティビティをトラッキングします。
3. オンサイト トラッキングが正しく設定されていることをテストするには、ストア内のページに移動し、URL の末尾に ?utm_email=email@example.com を追加して、email@example.com を自分のメールアドレスに置き換えます。ページを再読み込みした後、Klaviyo でご自分のメールアドレスを検索します。プロファイルが作成され、サイト上でのアクティビティがトラッキングされているはずです。

「商品閲覧」のトラッキング

閲覧放棄フロー を設定する、または商品閲覧データに基づいてセグメントを作成するには、「商品閲覧」のメトリックの JavaScript イベント トラッキングを追加する必要があります。

1. 商品ページのテンプレートに、次のスニペットを追加します。

<script type="text/javascript">
 var klaviyo = window.klaviyo || [];
 klaviyo.track("Viewed Product", {
    Title: '{{ product.name }}',
    ItemId: {{ product.id }},
    Categories: {{ category in product.categories|json }}, // The list of categories is an array of strings.
    ImageUrl: '{{ product.image_url }}',
    Url: '{{ product.permalink }}',
    Metadata: {
    Brand: '{{ product.brand }}',
    Price: {{ product.price }},
    OnSale: {{ product.on_sale }},
    RegularPrice: {{ product.regular_price }},
    SalePrice: {{ product.sale_price }}
 }
 });
</script>

1. 上記のスニペットでは、{{ }} プレースホルダー構文を使用しています。これは、お使いの Spree ストアとは異なる場合があります。重要なのは、表示している商品ページに基づいて、商品フィールドが動的にレンダリングされることです。
2. サイトで「商品閲覧」のトラッキングが設定されると、既知の訪問者が商品ページを閲覧するにつれて、Klaviyo アカウントに「商品閲覧」データが入力され始めます。

オンサイトトラッキングの仕組み

Klaviyo のオンサイト トラッキングをサイトに追加すると、「既知のブラウザ」つまり、過去に少なくとも一度訪問してエンゲージメントがあったブラウザの閲覧アクティビティのみを追跡できます。オンサイト トラッキングの目的でサイト訪問者を識別できる主な方法は 2 つあります。

• 過去のいずれかの時点で Klaviyoを使って送信されたメールをクリックして、ウェブサイトにアクセスしたことがある場合
• 過去のいずれかの時点で Klaviyo のフォームから購読／オプトインした場合

Klaviyo は匿名のブラウザは追跡しません。

Klaviyo 同期を監視する

外部連携を確認するには：

1. Klaviyo で [アナリティクス] のドロップダウンをクリックし、[メトリック] を選択します。ここでは、フィルターを使用してすべての Spree メトリックを表示できます。
2. Spree の「注文の確定」メトリックを見つけて、アクティビティフィードのアイコンをクリックします。外部連携がデータの同期を開始している場合、ここに「注文の確定」イベントが表示され始めます。
3. 過去のすべての注文データが自動的に同期されます。これを確認するには、Klaviyo で特定の日のイベント数を Spree インターフェースの数と比較し、一致していることを確認できます。たとえば、「注文の確定」のメトリックを調べる際には、昨日のデータポイントにマウスを合わせるか、グラフの下にあるデータ表を見て、昨日報告された注文数を確認できます。
4. その数値を、昨日の Spree に保存されている数値と比較すると、完全に一致しているはずです。一致しない場合は、問題の原因はほとんどの場合、Klaviyo アカウントのタイムゾーンが設定している Spree のタイムゾーンと一致していないことです。
5. Klaviyo でタイムゾーン設定を確認するには：
   • 左下のアカウント名をクリックしてください。
   • 次に、[設定] > [組織] をクリックします。
   • [タイムゾーン] までスクロールダウンします。
6. この履歴同期が完了すると、外部連携タブで Spree 外部連携の周囲に薄い緑色の枠線が表示されます。

Spree から同期されたデータ

以下は、Spree が Klaviyo に同期するメトリックの一覧です。アカウントに同期されるすべての Spree メトリックは、分析 > メトリック で確認できます。

注文の確定

このメトリックは、誰かが注文を行い、支払いに成功するたびにイベントを記録します。これは、Spree で完了した注文に対応します。つまり、顧客がチェックアウトプロセス全体を完了したことを意味します。このメトリックを使用すると、注文回数や生涯価値に基づいて、ユーザーの動的リストを簡単に作成できます。また、過去の顧客を再エンゲージするためのメールを作成したり、初回購入者向けのお礼メールを送信したりすることもできます。以下の条件に基づいて、「注文の確定」イベントをフィルタリングし、ターゲットを絞ることができます。

• IsDiscounted
  注文に割引が適用されているかどうか（例：true または false）。
• ItemNames
  このイベントで購入された商品の名前。

購入商品

このメトリックは「注文の確定」メトリックに似ていますが、誰かが注文した各商品ごとにイベントが記録されます。たとえば、T シャツとショートパンツを購入した場合、Klaviyo では 1 件の「注文の確定」イベントと、T シャツ分 1 件、ショートパンツ分 1件の合計 2 件の「購入商品」イベントとして表示されます。このメトリックは、特定の商品、または特定のカテゴリの商品を購入した（または未購入の）顧客をターゲットにするリストの構築に役立ちます。また、「購入商品」メトリックをフローのトリガーとして使用し、自然に組み合わせられる関連商品のメールを、まだ購入していない一部の顧客に送信することもできます。

• カテゴリ
  注文された商品が属するカテゴリ。例：Shirts、Mens、または Sale。
• 名前
  購入された商品の名前（例：メンズの赤い T シャツ）。
• ProductId
  ストアで設定されている商品の ID（例：2022, 2023, 2024）。
• 数量
  注文した商品の数量。
• SKU
  ストアで設定されている商品の SKU。
• バリエーションオプション: 色
  利用可能な場合の商品の色（例：赤 または 青）。
• バリエーション オプション：サイズ
  利用可能な場合の商品のサイズ（例：Medium や Large）。

注文発送済み

このメトリックは、お客様の注文が発送されたときにイベントを記録します。Klaviyo のイベントにはあらゆる出荷の追跡番号が含まれるため、このメトリックを発送確認メールのトリガーとして使用できます。「注文発送済み」のメトリックに基づくもう 1 つの一般的なメールとして、商品レビューのメールがあります。ここでは、お客様に最近購入した商品のレビュー投稿を依頼します。Fulfilled Orderメトリックを使用すると、注文が受け取られたタイミングに基づいてこれらのメールの送信タイミングを設定できるため、荷物が届く前にメールを送ってしまうことを心配する必要がありません。以下の条件に基づいて、注文発送済みイベントをフィルタリングし、ターゲットを絞ることができます。

• IsDiscounted
  注文に割引が適用されているかどうか（例：true または false）。
• ItemNames
  このイベントで購入された商品の名前。

チェックアウトの開始

このメトリックは、誰かがチェックアウトを開始し、メールアドレスを入力したときに毎回イベントを記録します。このメトリックの主な用途は、カゴ落ちメールを送信することです。Klaviyo を使用すると、チェックアウトを開始したものの数時間経っても注文を確定していない場合にカートのリマインダーを送信するメールフローを簡単に設定できます。「チェックアウトの開始」イベントにはカートに関するすべての情報が含まれているため、カート内の商品だけでなく、それらの商品の画像も表示できます。より高度な機能を使って、割引コードを提供する新規顧客向けのフローと、割引コードを含まないリピーター向けの2種類のかご落ちフローを設定することも可能です。以下の条件に基づいて、「チェックアウトの開始」イベントをフィルタリングし、ターゲットを絞ることができます。

• IsDiscounted
  注文に割引が適用されているかどうか（例：true または false）。
• ItemNames
  このイベントで購入された商品の名前。

顧客データ

Klaviyo が Spree から同期するメトリックに加えて、各 Klaviyo プロファイルには顧客プロパティも追加されます。これらのプロパティは、セグメントおよびフローで使用できます。Spree から自動的に同期されるプロパティは以下のとおりです：

• メール
• 名
• 姓
• 市区町村
• 州・県/地域
• 郵便番号
• 国
• 電話番号

達成できること

これで、Klaviyo アカウントを Spree と連携し、オンサイト トラッキングをインストールして、同期されたデータを確認できました。

その他のリソース