Magento 1 データ リファレンス

このページで学べること

既存のMagento 1外部連携で、過去の注文、顧客レコード、商品など、どのようなデータがKlaviyoに同期されるかをご確認ください。最初の過去データの同期後、注文、顧客、商品は30分ごとに同期されます。

Klaviyoで、左側のサイドバーから［分析］>［メトリック］に移動して、アカウントのメトリックを確認します。Magentoアイコンが付いたメトリックは、Magento外部連携から同期されます。

Magento メトリック

注文キャンセル

このイベントは、顧客が Magento ストアで注文を作成したものの、発送完了前に注文をキャンセルしたときに追跡されます。Klaviyo は、誰かが購入した商品のすべての製品情報など、関連データを追跡します。商品情報には、商品名、画像、購入後フォローアップ メールで使用できるバリエーション情報が含まれます。

これらのイベントには、次の注文データが含まれます。トップレベルのプロパティを使用してイベントをフィルタリングしてターゲティングできます。extra配下の属性の詳細はメッセージコンテンツに利用できます。

• 値：税金と送料を含む、割引適用後のMagentoの注文の総合計金額です。
• Items：各注文の注文品目行の商品名（例：Tシャツ、パンツ）。名前は、別々の明細行に表示されている場合、複数回表示されることがあります。
• Item Categories：注文に含まれる商品のカテゴリ（例：Tシャツ、メンズ、パンツ、セール）。
• Item Count：注文内の明細項目数（例：2）。これは、注文数量の合計ではありません。
• Currency Code：注文の通貨コード（例：USDまたはEUR）。
• 割引適用：注文に割引が適用されたかどうか（trueまたはfalse）。
• クーポン：適用されたクーポンコード。
• 重複のない商品：注文内の商品の名前から重複を削除したもの（例：シャツやショーツ）。
• 重複のない商品カテゴリ：重複を削除した、注文内の商品カテゴリ（例：メンズ、セール）。
• Attributes（任意）：extra配下のアイテム詳細にある商品の属性。購入商品のイベントを使用して、個々の商品属性でフィルタリングしてください。

チェックアウト完了

このイベントは、顧客がMagentoストアでチェックアウトを完了したときに追跡されます。Checkout Completedイベントは過去分の同期が行われないため、合計が過去のすべてのチェックアウトを反映しない場合があります。収益のレポート作成とセグメンテーションには、Placed Orderイベントを使用してください。

以下の条件に基づいて、チェックアウト完了イベントをフィルタリングし、ターゲットを絞ることができます。

• Value：注文の合計金額。
• 割引コード：適用されたクーポンまたは割引コード。
• アイテム：カート内の商品名（例：T シャツ または パンツ）。
• Items Count：誰かのカート内にあるアイテムの合計数です。
• 合計割引（任意）：クーポンまたは割引の合計金額。

チェックアウト開始

このイベントは、顧客が Magento のチェックアウトプロセスの最初のページで連絡先情報と配送先情報を入力し、その後 [続行] をクリックすると追跡されます。Klaviyo は、カゴ落ちメールで活用できるように、カート内の商品名、画像、バリエーション情報など、カート内アイテムに関する関連商品データを追跡します。このイベントにはチェックアウト URL プロパティがあり、各顧客の正確なカートにリンクしており、顧客が新しいデバイスからメールを開いた場合にカートを再構築するために使用できます。

以下の基準に基づいて、「チェックアウト開始」イベントをフィルタリングし、ターゲットを絞ることができます。

• Value：チェックアウト時点のカートの値（小計+送料-割引）。
• アイテム：カート内の商品名（例：T シャツ または パンツ）。
• Items Count：誰かのカート内にあるアイテムの合計数です。
• 割引コード（任意）：適用されたクーポンまたは割引コード。
• 合計割引（任意）：クーポンまたは割引の合計金額。

注文発送済み

標準のMagento注文ステータスでは、注文が完了ステータスに到達した時点でこのイベントが追跡されます。Klaviyoは、購入フォローアップメールで使用できるように、購入されたアイテムに関する商品名、画像、バリエーション情報などの関連商品情報を追跡します。

これらのイベントには、次の注文データが含まれます。トップレベルのプロパティを使用してイベントをフィルタリングしてターゲティングできます。extra配下の属性の詳細はメッセージコンテンツに利用できます。

• 値：税金と送料を含む、割引適用後のMagentoの注文の総合計金額です。
• Items：各注文の注文品目行の商品名（例：Tシャツ、パンツ）。名前は、別々の明細行に表示されている場合、複数回表示されることがあります。
• Item Categories：注文に含まれる商品のカテゴリ（例：Tシャツ、メンズ、パンツ、セール）。
• Item Count：注文内の明細項目数（例：2）。これは、注文数量の合計ではありません。
• Currency Code：注文の通貨コード（例：USDまたはEUR）。
• 割引適用：注文に割引が適用されたかどうか（trueまたはfalse）。
• クーポン：適用されたクーポンコード。
• 重複のない商品：注文内の商品の名前から重複を削除したもの（例：シャツやショーツ）。
• 重複のない商品カテゴリ：重複を削除した、注文内の商品カテゴリ（例：メンズ、セール）。
• Attributes（任意）：extra配下のアイテム詳細にある商品の属性。購入商品のイベントを使用して、個々の商品属性でフィルタリングしてください。

購入商品

このイベントは、顧客が注文を行ったときに追跡されます。整数の数量の場合、購入された各ユニットごとに「購入商品」イベントが1件追跡され、注文のラインアイテムあたり最大100件まで追跡されます。たとえば、Tシャツとパンツを購入した場合、1件の注文の確定イベントと2件の購入商品イベントが記録されます（Tシャツ分として1件、パンツ分として1件）。小数点以下の数量で販売される商品の場合、Klaviyoは明細項目に対して1件のイベントを記録し、購入数量を含めます。

Ordered Product イベントには、誰かが購入した各商品の詳細情報が含まれます。これは、「注文の確定」イベントでは取得できない商品バリエーションのオプションやその他の詳細情報に基づいて行動セグメントを作成する際に役立ちます。以下の条件に基づいて、「購入商品」イベントをフィルタリングし、ターゲットを絞ることができます。

• 値：割引前の、このイベントで表される値（配送を除く）。数量が整数の場合、注文ラインの合計をその数量で割った値です。数量が小数の場合、ライン合計の全額です。
• 名前：この特定の項目に付けられた名前。
• SKU：アイテムに割り当てられたSKU（例：REDMEDIUMTSHIRT）。
• Categories：この商品のカテゴリ（例：Tシャツ、メンズ、パンツ、セール）。
• 価格：注文通貨での商品の単価（例：シャツは25.50、靴は50.25）。
• Cost（optional）：利用可能な場合にMagentoに記録されている商品原価（例：シャツ13.85、靴20.00）。
• Currency Code：注文の通貨コード（例：USDまたはEUR）。
• 割引適用済み：この特定の商品に割引が適用されているかどうか（true または false）。
• ProductID：ストア内の特定の商品 ID。
• 数量：このイベントで表される数量。整数数量の場合は1、小数数量で販売される商品の場合は購入数量。
• 属性（任意）：カスタム商品属性。

注文の確定

このイベントは、顧客が Magento ストアでチェックアウトプロセスを完了し、注文を作成したときに追跡されます。Klaviyo は、購入フォローアップメールで使用できるように、購入されたアイテムに関する商品名、画像、バリエーション情報などの関連データを追跡します。これらの注文の確定イベントには、次の注文データが含まれます。トップレベルのプロパティを使用してイベントをフィルタリングおよびターゲティングできます；extra配下の属性の詳細はメッセージコンテンツで使用できます。

• 値：税金と送料を含む、割引適用後のMagentoの注文の総合計金額です。
• Items：各注文の注文品目行の商品名（例：Tシャツ、パンツ）。名前は、別々の明細行に表示されている場合、複数回表示されることがあります。
• Item Categories：注文に含まれる商品のカテゴリ（例：Tシャツ、メンズ、パンツ、セール）。
• Item Count：注文内の明細項目数（例：2）。これは、注文数量の合計ではありません。
• Currency Code：注文の通貨コード（例：USDまたはEUR）。
• 割引適用：注文に割引が適用されたかどうか（trueまたはfalse）。
• クーポン：適用されたクーポンコード。
• 重複のない商品：注文内の商品の名前から重複を削除したもの（例：シャツやショーツ）。
• 重複のない商品カテゴリ：重複を削除した、注文内の商品カテゴリ（例：メンズ、セール）。
• Attributes（任意）：extra配下のアイテム詳細にある商品の属性。「購入商品」イベントを使用して、個々の商品の属性で絞り込みます。カスタム商品属性を確認する方法を学ぶ。

返金済の注文

標準のMagentoの注文ステータスでは、注文がclosedステータスに達した時点でこのイベントがトラッキングされます。Valueは、個々の返金額ではなく、元の注文の合計金額です。

• 値：割引後の税金と配送を含む、Magentoの元の注文の総合計。
• クーポン：適用されたクーポンコード。
• Currency Code：注文の通貨コード（例：USDまたはEUR）。
• 割引適用：注文に割引が適用されたかどうか（trueまたはfalse）。
• Item Categories：注文に含まれる商品のカテゴリ（例：Tシャツ、メンズ、パンツ、セール）。
• Item Count：注文内の明細項目数（例：2）。これは、注文数量の合計ではありません。
• Items：各注文の注文品目行の商品名（例：Tシャツ、パンツ）。名前は、別々の明細行に表示されている場合、複数回表示されることがあります。
• 重複のない商品カテゴリ：重複を削除した、注文内の商品カテゴリ（例：メンズ、セール）。
• 重複のない商品：注文内の商品の名前から重複を削除したもの（例：シャツやショーツ）。

「注文の確定」の売上は、割引後の税金と送料を含むMagentoの注文総額を使用します。$valueに基づいてセグメントをフィルタリングするには、売上を使用してください。

Paymentは、extraフィールド配下の第2階層プロパティとして利用できます。セグメンテーションでは第2階層プロパティに基づいて絞り込むことはできませんが、メトリックトリガーのフローメールテンプレートで、このデータをイベント変数として使用できます。

同期された顧客データ

Klaviyoは、同期された注文、顧客レコード、開始されたチェックアウトからプロファイルを作成または更新します。プロファイルで利用できる情報は、Magentoから提供されるデータによって異なります。以下を含めることができます：

• メール
• 名と姓
• 市区町村、都道府県/州・地域、郵便番号、国
• 電話番号
• Magento アカウントが作成された日時（例：2015-05-01 00:00:00）
• Magento 顧客グループ（例：卸売）
• Magento ストア（例：米国ストア）
• 生年月日（例：1990-01-01）
• 性別
• MagentoウェブサイトID（顧客レコードにストアIDが含まれている場合）

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

カスタム商品属性を確認する

カスタム商品属性は、既存の外部連携設定によって異なります。設定済みの属性は、購入商品イベント上で、属性コードの前にAttribute:が付いたプロパティ名として表示されます。属性の詳細は、注文イベントのextra配下にある各アイテムにも保存されます。Klaviyoサポートでは、Magento 1の属性同期の有効化または変更のリクエストを現在受け付けていません。既存のイベントデータを確認して、どの属性が存在するかを把握してください。一般的なサポート情報はサポートへのお問い合わせ方法で確認できます。

既存の設定でカスタム属性を特定するには、Magentoの管理パネルで［カタログ］>［属性］>［属性を管理］に移動し、その属性をクリックしてください。

以下に示すように、URL内で属性IDを確認してください。

同期済みの注文データを確認する

同期された注文を確認するには、完了した1日分の「注文の確定」イベント数を、同じ日付およびストアのMagento内の注文数と比較してください。数を比較する前に、過去データの同期が完了し、最新の30分同期が完了するまで待ってください。

1. [アナリティクス] > [メトリック] に移動し、Magentoの注文の確定メトリックを選択します。
2. 比較したい日を含めるように日付範囲を設定してください。表示単位を日別に、測定を合計に設定してください。比較から注文が除外されないように、該当するフィルターをすべて削除してください。
3. その日のデータポイントにカーソルを合わせるか、グラフの下にある表で値を確認してください。同じ日とストアのMagentoの注文と件数を比較してください。

件数が異なる場合は、両方のレポートが同じタイムゾーンとストアのスコープを使用していること、および同期が完了していることを確認してください。また、一致しないMagento注文が支払い待ちになっているか、有効な顧客メールアドレスがないかどうかも確認してください。Klaviyoのタイムゾーンを確認するには：

1. 左下隅にあるアカウント名をクリックします。
2. [設定] をクリックします。
3. 「> 」の「一般」アカウントを選択し、タイムゾーンの設定を確認してください。
4. タイムゾーンを変更した場合は、保存をクリックしてください。この値を変更するには、アカウント設定を編集する権限が必要です。

Klaviyoの注文の確定の収益には、キャンセル済みまたは返金済みの注文は差し引かれません。そのため、これらの注文を差し引くMagentoのレポートとは異なる場合があります。

同期されたMagento注文のプロパティ

以下は、Magento SOAP API を通じて同期される注文について、当社が保存するプロパティに一致する Placed Order、Ordered Product、Fulfilled Order メトリックの JSON ペイロード例です。

これらの例を使用して、同期されたイベントのプロパティ名とネスト構造を理解してください。これらはレガシーのイベントペイロード形式を示すものであり、Klaviyoの現在のAPIにリクエストを送信するための手順ではありません。例の値は参考例です；extraには注文レベルのイベントの注文詳細がすべて含まれます。

注文の確定

{
  "token": "PUBLIC_API_KEY",
  "service": "magento",
  "event": "Placed Order",
  "customer_properties": {
    "$email": "john.smith@test.com",
    "$first_name": "John",
    "$last_name": "Smith"
  },
  "properties": {
    "$event_id": "1234",
    "$value": 29.98,
    "$extra": {},
    "Currency Code": "USD",
    "Item Count": 2,
    "Items": [
      "Winnie the Pooh",
      "A Tale of Two Cities"
    ],
    "Discounted": true,
    "Coupon": "COUPON123",
    "Unique Items": [
      "Winnie the Pooh",
      "A Tale of Two Cities"
    ],
    "Item Categories": [
      "Fiction",
      "Classics",
      "Children"
    ],
    "Unique Item Categories": [
      "Fiction",
      "Classics",
      "Children"
    ]
  },
  "time": 1387302423
}

購入商品

{
  "token": "PUBLIC_API_KEY",
  "service": "magento",
  "event": "Ordered Product",
  "customer_properties": {
    "$email": "john.smith@test.com",
    "$first_name": "John",
    "$last_name": "Smith"
  },
  "properties": {
    "$event_id": "123456789",
    "$value": 9.99,
    "Currency Code": "USD",
    "Name": "Winnie the Pooh",
    "SKU": "WINNIEPOOH",
    "ProductID": "567",
    "Categories": [
      "Fiction",
      "Classics"
    ],
    "Price": 9.99,
    "Discounted": true,
    "Cost": 5.0,
    "Attribute: Color": "Red",
    "$extra": {
      "Product URL Key": "winnie-pooh",
      "Product URL": "https://www.store.com/winnie-pooh",
      "Image URL": "https://cnd.store.com/images/winnie-pooh.png"
    },
    "Quantity": 1
  },
  "time": 1387302423
}

注文発送済み

{
  "token": "PUBLIC_API_KEY",
  "service": "magento",
  "event": "Fulfilled Order",
  "customer_properties": {
    "$email": "john.smith@test.com",
    "$first_name": "John",
    "$last_name": "Smith"
  },
  "properties": {
    "$event_id": "1234",
    "$value": 29.98,
    "$extra": {},
    "Currency Code": "USD",
    "Item Count": 2,
    "Items": [
      "Winnie the Pooh",
      "A Tale of Two Cities"
    ],
    "Discounted": true,
    "Coupon": "COUPON123",
    "Unique Items": [
      "Winnie the Pooh",
      "A Tale of Two Cities"
    ],
    "Item Categories": [
      "Fiction",
      "Classics",
      "Children"
    ],
    "Unique Item Categories": [
      "Fiction",
      "Classics",
      "Children"
    ]
  },
  "time": 1387302423
}

その他のリソース