Square データ参照

このページで学べること

SquareからKlaviyoに同期されるデータ、その閲覧方法、そしてSquareイベントに含まれるプロパティをご確認ください。

始める前に

まだの場合は、この記事を読み進める前に、まず Square のスタートガイドをお読みいただき、手順に沿ってストアを外部連携してください。

データの表示方法

Squareの外部連携が有効になっていることを確認してください。SquareからKlaviyoへのデータ同期を確認するには：

1. Klaviyoアカウントで、左側のナビゲーションから[外部連携]を選択します。
2. リストからSquareを選択してください。
3. 上部の データ タブを選択します。

ここでは、SquareからKlaviyoに同期された最新データと、履歴データの同期中に表示される進捗バーが確認できます。

同期に問題がある場合は、履歴データセクションでインポートを再開を選択して未完了の履歴同期を再開するか、完了後に再度実行するには再インポートを選択してください。これらのコントロールを使用するには、外部連携を管理する権限が必要です。

Square から同期されたデータ

Square Online のイベントはリアルタイムで Klaviyo に同期され、Square POS のイベントは 30 分ごとに同期されます。

Square から Klaviyo に同期されるデータには、次が含まれます。

• （オンサイトの JavaScript 設定をオンのままにしていた場合）既知のサイト訪問者 が Active on Site イベントとして追跡されます
• メールの購読解除
• 注文イベントに関連付けられた顧客情報
• Square カタログ（POS のみのアイテムを含む）
• 次のイベント：
  • チェックアウト落ち
  • 注文の確定
  • 購入商品
  • 返金済の注文
  • 注文キャンセル
  • 部分配送完了
  • 注文発送済み

Square POS の注文イベントは、注文に関連付けられたメールアドレスや電話番号があり、その顧客がお客様の会社に直接共有した場合に Klaviyo に同期されます（そして Klaviyo プロファイルが作成されます）。

注文の確定や返金済みの注文などの注文レベルのイベントには、SquareオンラインやPOSなどのソースを識別するソース名プロパティが含まれています。これにより、Klaviyoでこれらのイベントをセグメント化できます。このプロパティは、Ordered ProductまたはAbandoned Checkoutイベントには含まれません。

顧客情報の詳細

顧客が貴社に直接共有したメールアドレスおよび/または電話番号が顧客に関連付けられている場合、顧客のプロファイルはSquareからKlaviyoに同期されます。SquareからKlaviyoに同期されたプロファイルには、Squareで利用可能なデータに応じて、以下のプロパティが含まれる場合があります：

• メール
  顧客のメールアドレス
• 名
  名と姓の両方が利用可能な場合の顧客の名
• 姓
  名と姓の両方が利用可能な場合の顧客の姓
• 市区町村
  顧客の市区町村
• 都道府県／地域
  顧客の都道府県
• 郵便番号
  お客様の郵便番号
• 国
  顧客の国
• 電話番号
  顧客の電話番号。Klaviyo が電話番号のみのプロファイルを作成するのは、Klaviyo SMS を設定している場合のみです。
• 誕生日
  提供されている場合は、お客様の生年月日
• Square グループ
  顧客に関連付けられた Square グループ。これには現在 Square セグメントは含まれません

メール配信の同意

Squareの外部連携では、メールの購読解除ステータスは同期されますが、メールのオプトイン同意は同期されません。Squareでemail_unsubscribedがtrueの場合、Klaviyoは顧客を購読解除としてマークします。falseの場合、この同期によって既存のプロファイルのメール購読ステータスは変更されません。メール同意のない新しいプロファイルは購読なしとしてマークされます。

SMS 同意

Square Onlineで収集されたSMSの同意は、現在Klaviyoに同期できません。Squareサイト上のKlaviyoフォームを通じてSMSの同意を収集できます。

カタログ アイテムの詳細

カタログアイテムは次のプロパティで Square から Klaviyo に同期されます：

• 項目名
• アイテムID
• アイテムの説明
• 商品の価格
• SKU
• URL
• 画像 URL
• 在庫数量
• 在庫ポリシー
• カテゴリー
• 公開済み
• バリエーション

同期されたイベントとそのプロパティ

チェックアウト落ち

このイベントは、Square Onlineストアでカートがカゴ落ちしてから1時間後にトリガーされ、カゴ落ちフローで使用できます。イベントを同期するには、Squareが有効なメールアドレスまたは電話番号を含む顧客レコードを提供する必要があります。

このイベントを Klaviyo に同期するには、まず Square のカゴ落ちメールをオフにする必要があります。これを行うには以下の手順に従ってください。

1. Square にログインし、概要ページ に移動します。
2. [コミュニケーション] > [カゴ落ち] を選択します。
3. [無効にする] を選択します。

Klaviyo のイベントの最上位プロパティは次のとおりです：

• $value
  カート内の合計金額
• 商品
  カートに含まれる商品
• コレクション
  カートに含まれるアイテムにリンクされているコレクション

Abandoned Checkoutイベントには、最上位のItem Countプロパティが含まれません。

注文の確定

このイベントは、Square OnlineストアまたはPOS端末で注文が確定したときにトリガーされます。

Klaviyo のイベントの最上位プロパティは次のとおりです：

• $value
  注文の合計金額
• Items
  注文に含まれる商品
• コレクション
  注文に含まれるアイテムにリンクされたコレクション
• Item Count
  注文に含まれる商品の合計数
• 割引コード
  注文に適用された割引の名前
• 割引合計
  割引の合計金額
• ソース名
  注文のソース（Square Online、POS）
• ロケーション名
  Square のロケーション名

購入商品

このイベントは、SquareのオンラインストアまたはPOS端末で注文が確定したときにトリガーされます。カタログ商品が個数単位で販売される場合、購入された各個数ごとに購入商品イベントがトリガーされ、1注文ラインあたり最大100件のイベントが発生します。重量またはその他の分数単位で販売される商品の場合、1件のイベントは購入された総数量を表します。

Klaviyo のイベントの最上位プロパティは次のとおりです：

• $value
  このイベントで表される商品数量の金額（モディファイアを含み、税は除く）
• 名前
  注文した商品の名前
• バリエーション
  商品のバリエーション名
• SKU
  商品 SKU
• ProductID
  商品の識別子
• バリエーションID
  バリエーション識別子
• 数量
  整数単位のイベントごとに1、または端数単位で販売される商品の場合は購入数量の合計
• コレクション
  商品にリンクされたコレクション
• バリエーションオプション：[option name]
  注文された商品の、指定したバリエーションオプションの値
• 修飾子オプション：[modifier list name]
  注文された商品の、指定した修飾子リストから選択された修飾子オプション

返金済の注文

このイベントは、Square オンラインストアまたは POS 端末で注文が返金されるとトリガーされます。

Klaviyo のイベントの最上位プロパティは次のとおりです：

• $value
  返金額
• 領収書URL
  注文の領収書のURL
• ソース名
  注文のソース（Square Online、POS）
• ロケーション名
  Square のロケーション名

注文キャンセル

このイベントは、顧客がストアで注文を作成したものの、その後注文全体をキャンセルしたときにトリガーされます。Klaviyo が追跡するイベントには、購入された各アイテムの商品名や画像など、購入商品に関するすべての商品情報が含まれます。一部キャンセルはサポートされていません。

Klaviyo のイベントの最上位プロパティは次のとおりです：

• $value
  注文の合計金額
• 商品
  注文に含まれる商品
• コレクション
  注文に含まれるアイテムにリンクされたコレクション
• Item Count
  注文に含まれる商品の合計数
• 割引コード
  注文に適用された割引の名前
• 割引合計
  割引の合計金額
• ソース名
  注文のソース（Square Online、POS）
• ロケーション名
  Square のロケーション名

部分配送完了

他のフルフィルメントが未完了のままの状態で、出荷、配達、または店頭受け取りが完了するたびに、一部発送済みの注文イベントが記録されます。すべてのフルフィルメントが完了すると、最後のフルフィルメントが発送済みの注文として記録されます。Squareが部分的なフルフィルメントのアイテム詳細を提供しない場合、イベントには注文全体の詳細が含まれます。

Klaviyo のイベントの最上位プロパティは次のとおりです：

• $value
  フルフィルメントの合計金額
• Items
  フルフィルメントに含まれる商品
• コレクション
  フルフィルメントに含まれるアイテムにリンクされたコレクション
• Item Count
  フルフィルメントに含まれる商品の合計数
• 割引コード
  注文に適用された割引の名前
• 割引合計
  割引の合計金額
• ソース名
  注文のソース（Square Online、POS）
• ロケーション名
  Square のロケーション名

注文発送済み

このイベントは、Square Online ストアまたは POS 端末で注文がフルフィルメントされたときにトリガーされます。注文に紐づくフルフィルメントが複数ある場合、Fulfilled Order イベントは最後のフルフィルメントでログに記録されます。

Klaviyo のイベントの最上位プロパティは次のとおりです：

• $value
  注文の合計金額
• Items
  注文に含まれる商品
• コレクション
  注文に含まれるアイテムにリンクされたコレクション
• Item Count
  注文に含まれる商品の合計数
• 割引コード
  注文に適用された割引の名前
• 割引合計
  割引の合計金額
• Fulfillment Status
  Squareから報告された注文ステータス
• ソース名
  注文のソース（Square Online、POS）
• ロケーション名
  Square のロケーション名

その他のリソース