Magento 2 データ リファレンス

2つのプラットフォームを外部連携した場合に、KlaviyoがMagento 2ストアからどのようなデータをインポートするかをご確認ください。初回の過去データの同期では、注文と顧客のデータを最大5年分インポートします。これには、過去に確定した注文や発送済みの注文に関連する情報も含まれます。有効化すると、この外部連携では注文と顧客のデータも30分ごとに同期されます。

Klaviyoで、左側のサイドバーから分析>メトリックに移動してアカウント内のすべてのメトリックを確認します。Magento 2のアイコンが付いたメトリックは、Magento 2外部連携から同期されたイベントです。また、歯車アイコンが付いたKlaviyoのオンサイトトラッキングイベントも表示されます。これらも外部連携を通じてトラッキングされます。

Klaviyo が Magento 2 のメトリックを判定する方法

注文メトリック

Klaviyoは、同期する各注文に対して注文の確定イベントを記録します。また、Magento 2内の注文の現在のステータスとステータス履歴を使用して、追加の注文メトリックを記録します。

注文が作成または更新されると、Klaviyoは現在のステータスとステータス履歴を確認します。以下の表に、標準のマッピングを示します。pending_payment、または無視するように設定されたカスタムステータスの注文は除外されます。

注文の確定メトリックをトリガーすべきではないカスタム注文ステータスがある場合、または上の表と一致しない場合は、カスタムステータスを無視する、または追加の注文イベントにマッピングできるように設定しますので、 お知らせください 。

ステータスが “pending_payment” の注文は無視されます。

「チェックアウト開始」メトリック

標準の Magento チェックアウトでは、顧客が Magento のチェックアウトプロセスの最初のページに連絡先と配送先情報を入力し、[続行] をクリックすると、このイベントがトリガーされます。

チェックアウトの開始イベントは、メールアドレスが関連付けられたカート（Magentoでは見積もりと呼ばれます）に依存します。同期の実行時にカートがまだアクティブで、かつ商品が含まれている場合にのみ、Klaviyoはそれを同期します。

顧客がカートの同期前に注文を完了すると、カートはアクティブではなくなり、Klaviyoはそれをスキップします。注文の確定イベントは、ステータスが無視されない限り、注文が同期されると記録されます。すでに同期されているチェックアウトの開始イベントはKlaviyoに残ります。「チェックアウトの開始」イベントが Klaviyo に同期されるまでに最大 1 時間かかる場合があることにご注意ください。

「出荷完了」メトリック

このメトリックは、Magento 2 ストアで新しい出荷が作成されたときにトリガーされます。

Magento 2 のメトリック データ

このセクションでは、Magento 2のメトリックと、セグメントとフローの作成時にフィルタリングに使用できるデータについて説明します。

注文キャンセル

このイベントは、Magento 2 ストアで注文ステータスが キャンセル または キャンセル に変更されたときにトリガーされます。

• ProductCategories
  キャンセルされた注文に含まれる商品のカテゴリ。
• 値
  キャンセルされた注文の値。
• 割引あり
  （True または False）キャンセルされた注文の割引ステータスです。
• ProductNames
  キャンセルされた注文に含まれる商品の名前
• ItemCount
  注文内の明細項目の数です（ユニットの合計数量ではありません）。
• OrderCurrencyCode
  キャンセルされた注文で使用される通貨コード。
• CartPriceRuleIDs
  自動的に適用されるルールと、適用済みクーポンのルールを含むカート価格ルール ID（数値 ID 文字列）の配列。
• external_catalog_id
  Klaviyo のカタログ整理に使用されます。

注文発送済み

このイベントは、Magento 2 ストアで注文ステータスを 完了 に設定したときに追跡されます。

• ProductCategories
  注文内の商品のカテゴリ。
• 値
  注文金額。
• 割引あり
  注文が割引されているかどうか。
• ProductNames
  注文内の商品名。
• ItemCount
  注文内の明細項目の数です（ユニットの合計数量ではありません）。
• OrderCurrencyCode
  注文で使用される通貨コード。
• external_catalog_id
  Klaviyo のカタログ整理に使用されます。

出荷完了

このイベントは、Magento 2 ストアで新しい出荷が作成されたときに追跡されます。

• StoreName
  注文が行われたストアの名前です。
• ストア ID
  注文が行われたストアの ID。
• BillingAddress
  注文の請求先住所。
• トラック
  出荷追跡に関する情報。
• external_catalog_id
  Klaviyo のカタログ整理に使用されます。

購入商品

Klaviyoでは、注文単位ごとに「購入商品」イベントを1件記録し、明細行ごとに最大100件まで記録します。たとえば、同じTシャツを3点注文すると「購入商品」イベントが3件生成され、それぞれの数量（Quantity）は1になります。小数点を含む数量で販売される商品については、Klaviyoは注文数量を含むイベントを1件記録します。

• SKU
  商品の SKU。
• OrderCurrencyCode
  商品の通貨コード。
• 価格
  商品の値です。
• カテゴリ
  商品のカテゴリ。
• 割引済み
  （TrueまたはFalse）商品の割引が適用されたかどうか。
• 数量
  このイベントで表される数量：単位購入の場合は1、小数単位で販売される商品の場合は注文数量です。
• 値
  商品の値。
• 商品 ID
  商品の ID。
• RootProductID
  親商品の ID。
• external_catalog_id
  Klaviyo のカタログ整理に使用されます。

注文の確定

このイベントは、ユーザーが注文を確定したときに追跡されます。

• ProductCategories
  注文内の商品のカテゴリ。
• 値
  注文金額。
• 割引あり
  注文が割引されているかどうか。
• ProductNames
  注文内の商品名。
• ItemCount
  注文内の明細項目の数です（ユニットの合計数量ではありません）。
• OrderCurrencyCode
  注文で使用される通貨コード。
• CartPriceRuleIDs
  自動的に適用されるルールと、適用済みクーポンのルールを含むカート価格ルール ID（数値 ID 文字列）の配列。
• external_catalog_id
  Klaviyo のカタログ整理に使用されます。

返金済の注文

このイベントは、Magento 2で注文のステータスがclosedになったときにトリガーされます。注文が別のステータスのままとなる一部返金では、標準のステータスマッピングを通じて「返金済みの注文」はトリガーされません。

• 値
  注文金額。
• 割引あり
  注文が割引されているかどうか。
• ProductNames
  注文に含まれるすべての商品の名前。
• ItemCount
  注文内の明細項目の数です（ユニットの合計数量ではありません）。
• OrderCurrencyCode
  注文で使用される通貨コード。
• ProductCategories
  注文内の商品のカテゴリ。
• CartPriceRuleIDs
  自動的に適用されるルールと、適用済みクーポンのルールを含むカート価格ルール ID（数値 ID 文字列）の配列。
• external_catalog_id
  Klaviyo のカタログ整理に使用されます。

チェックアウトの開始

このイベントは、メールアドレスが既知の顧客がチェックアウトを開始し、Klaviyoが同期した時点でカートに商品が入ったままアクティブである場合にトリガーされます。標準のチェックアウトページでは、顧客が連絡先情報と配送情報を入力し、続行をクリックします。カートが同期される前にチェックアウトを完了した場合、Klaviyoは「チェックアウトの開始」をスキップし、注文が同期された時点で、ステータスが無視されていない限り「注文の確定」を記録します。注文を確定しても、すでに同期されているチェックアウトの開始イベントは削除されません。

• 値
  チェックアウト中の注文金額。
• ItemCount
  カート内の明細行アイテム数です（ユニットの合計数量ではありません）。
• アイテム
  注文内のアイテム。
• ProductCategories
  注文内の商品のカテゴリ。
• ProductNames
  注文内の商品名。
• StoreName
  注文が開始されたストアの名前。
• StoreID
  注文が開始されたストアの ID。
• external_catalog_id
  Klaviyo のカタログ整理に使用されます。

カートに追加

このメトリックは、Klaviyo 拡張機能バージョン 4.0.0 以降を使用している場合にのみ追跡される点にご注意ください。このメトリックは、Klaviyo によって Cookie が付与された顧客が商品をカートに追加したときに追跡されます。

これには、追加された商品の詳細情報が含まれています。これは、ユーザーがカートに追加した商品に基づいてセグメントを作成する場合や、カゴ落ちフローを構築する場合に役立ちます。以下の条件に基づいて、「カートに追加」メトリックをフィルタリングし、ターゲットを絞り込むことができます。

• MaskedQuoteId
  MaskedQuoteId、またはログインしている顧客の一意の識別子。
• AddedItemCategories
  商品が属するカテゴリー。
• AddedItemProductName
  ストア内の商品の名前（例：赤い T シャツ）。
• AddedItemDescription
  商品の説明。
• AddedItemImageURLKey
  アイテムの画像の URL
• AddedItemPrice
  商品の価格。
• AddedItemProductID
  Magento 2 ストアでの商品のカスタム ID（例：1234）。
• AddedItemSKU
  ストア内の商品の SKU（例：REDMEDIUMTSHIRT）。
• AddedItemURL
  商品の URL。
• external_catalog_id
  Klaviyo のカタログ整理に使用されます。
• integration_key
  E コマースプラットフォーム（Magento 2）。

「商品をカートに追加」イベントのMaskedQuoteId値を使用して、顧客が別のデバイスでメールから戻った際にカートを再構築するリンクを作成します。次のURLを使用します：

{{ organization.url|trim_slash }}/reclaim/checkout/cart?quote_id={{ event.MaskedQuoteId }}

商品の閲覧

このメトリックは、Klaviyoが識別できる顧客がサイト上で商品を閲覧したときに追跡されます。以下の条件に基づいて、商品の閲覧メトリックをフィルタリングし、ターゲットを絞ることができます：

• ProductID
  商品の ID。
• 名前
  商品の名前。
• SKU
  商品の SKU。
• URL
  商品の URL。
• 価格
  商品の価格。
• 最終価格
  割引適用後の最終価格。
• カテゴリ
  商品が属するカテゴリを含む配列です。
• ImageURL
  商品の画像の URL。
• external_catalog_id
  Klaviyo のカタログ整理に使用されます。
• integration_key
  E コマースプラットフォーム（Magento 2）。

サイトの訪問

このメトリックは、Klaviyoが識別できる顧客がサイト上でアクティブになったときに追跡されます。セグメントとフローでサイトの訪問アクティビティを使用できますが、以下のイベントプロパティはセグメントまたはフローフィルターでは利用できません。イベントの生データで確認できます：

• utm_medium
  UTM トラッキング パラメータの medium（例：campaign）。
• kx_present
  URLにkx parameterが含まれている場合はTrueになります。パラメータが存在しない場合、このフィールドは省略されます。
• os
  ユーザーのデバイスのオペレーティングシステム。
• initial_page_path
  ユーザーが最初にアクセスしたページの URL パスです。
• ブラウザ
  ユーザーのブラウザの種類。
• ページ
  ユーザーがアクティブだったページの URL です。
• utm_campaign
  キャンペーンの UTM トラッキング パラメーター。
• utm_source
  UTM ソース（例：Klaviyo）。

同期された顧客データ

Klaviyoは、同期された注文、顧客レコード、開始されたチェックアウトからプロファイルを作成または更新します。以下の情報は、ソースデータで利用可能な場合に追加されます：

• メール
• 名と姓
• 市区町村、都道府県/州・地域、郵便番号、国
• 電話番号
• Magentoのアカウント作成（例：YYYY-mm-dd hh:mm:ss；2015-05-21 13:04:00）
• Magento 顧客グループ（例：卸売）
• Magento ストア（例：米国ストア）
• 生年月日（例：YYYY-MM+-dd；1990-03-25）
• 性別

Magento 2 で顧客グループを更新すると、Klaviyo で元のプロファイルが作成された後であっても、Klaviyo の顧客グループが更新されます。

売上の値

Magento 2の「注文の確定」メトリックを使用して収益を測定する場合、キャンセル済みおよび返金済みの注文は自動的には差し引かれません。このため、Klaviyoに表示される収益がMagentoに表示される収益と異なる場合があります。

その他のリソース