Magento 2 データ リファレンス

2 つのプラットフォームを外部連携する際に、Klaviyo が Magento 2 ストアからどのようなデータをインポートするかをご確認ください。Klaviyo の Magento 2 との外部連携では、初回の履歴同期で Magento 2 ストア内のすべての履歴データを取得します。外部連携を有効にすると、注文データと顧客データが 30 分ごとに同期されるようになります。このデータの例として、過去に行われた注文、フルフィルメント済みの注文などに関連する情報があります。

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

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

注文メトリック

Magento 2 の注文メトリックは、Magento 2 ストア内の注文の Status フィールドによって決まります。

注文が作成されるたび、またはステータスが更新されるたびに、以下のマトリックスに照らして評価され、どのイベントをトリガーするかが決定されます。

上記の表と一致しない、または Placed Order メトリックをトリガーしないカスタム注文ステータスがある場合は、お知らせください。外部連携で注文ステータスのマッピングを適宜調整します。

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

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

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

チェックアウト開始 イベントは、「見積もり」が作成され、かつそれにメールアドレスが関連付けられていることに依存します。これは、チェックアウトの「配送情報」段階で顧客がメールアドレスを入力した後に発生します。顧客がチェックアウトを完了しない場合、この見積もりは チェックアウト開始 イベントとして Klaviyo に同期されます。

顧客が注文を完了すると、この見積もりは Magento のデータベースで「請求書」に変換されます。その結果、「チェックアウトの開始」イベントは Klaviyo に送信されません。代わりに、「注文の確定」イベントが送信されます。「チェックアウトの開始」イベントが Klaviyo に同期されるまでに最大 1 時間かかる場合があることにご注意ください。

「出荷完了」メトリック

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

Magento 2 のメトリック データ

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

注文キャンセル

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

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

注文発送済み

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

• ProductCategories
  注文内の商品のカテゴリ。
• 値
  注文金額。
• 割引あり
  注文が割引されているかどうか。
• OrderedProducts
  注文に含まれる商品の名前。
• OrderedProductCount
  注文内の商品数。
• OrderCurrencyCode
  注文で使用される通貨コード。
• external_catalog_id
  Klaviyo のカタログ整理に使用されます。

出荷完了

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

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

購入商品

このイベントは、ユーザーが注文の確定した際に、注文した各商品について 1 回ずつ追跡されます。

• SKU
  商品の SKU。
• OrderCurrencyCode
  商品の通貨コード。
• 価格
  商品の値です。
• カテゴリ
  商品のカテゴリ。
• 割引適用
  商品に適用されているすべての割引。
• 数量
  商品の数。
• 値
  商品の値。
• 商品 ID
  商品の ID。
• RootProductID
  親商品の ID。
• external_catalog_id
  Klaviyo のカタログ整理に使用されます。

注文の確定

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

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

返金済の注文

このイベントは、顧客が注文の払い戻しを行ったときにトリガーされます。

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

チェックアウトの開始

このイベントは、既知のメールアドレスを持つ顧客がチェックアウトを開始したときにトリガーされます。標準のチェックアウトページでは、Magento のチェックアウトプロセスの最初のページに顧客が連絡先と配送先情報を入力して [続行] をクリックすると、このイベントがトリガーされます。ユーザーがチェックアウトを完了した場合、Started Checkout イベントは Klaviyo に送信されません。代わりに、Placed Order イベントがログに記録されます。

• 値
  チェックアウト中の注文金額。
• 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）。

Klaviyo はカート再現キーを生成します。このキーを使用すると、顧客が別のデバイス上で、このイベントによってトリガーされたメールからカートに戻った場合にも、顧客のカートを再現するリンクを作成できます。このキーは「extra」プロパティの配列の中にあります。このリンクは以下の URL で作成できます。

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

商品の閲覧

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

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

サイトの訪問

このメトリックは、顧客がサイト上でアクティブなときに追跡されます。以下の条件に基づいて、「サイトでアクティブ」メトリックをフィルタリングし、ターゲットを絞り込むことができます。

• utm_medium
  UTM トラッキング パラメータの medium（例：campaign）。
• kx_present
  (True or False) kx パラメーター が存在するかどうか。
• os
  ユーザーのデバイスのオペレーティングシステム。
• initial_page_path
  ユーザーが最初にアクセスしたページの URL パスです。
• ブラウザ
  ユーザーのブラウザの種類。
• ページ
  ユーザーがアクティブだったページの URL です。
• utm_campaign
  キャンペーンの UTM トラッキング パラメーター。
• utm_source
  UTM ソース（例：Klaviyo）。

同期された顧客データ

Klaviyo は、既存の注文の作成、既存の顧客レコードの作成、またはチェックアウトが開始されたときに連絡先を作成します。Klaviyo は同期された連絡先ごとに新しい Klaviyo プロファイルを作成し、このプロファイルに次の情報を入力します。

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

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

売上の値

Klaviyo のダッシュボードの 売上 の値が Magento で表示される売上の値と必ずしも一致しない場合があります。これは、Klaviyo では売上の計算からキャンセルおよび返金された注文を差し引かないためです。

その他のリソース