Magento 1 データ リファレンス

このページで学べること

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

Klaviyo では、左側のサイドバーにあるアカウントの Analytics タブに移動して、アカウント内のすべてのメトリックを表示できます。Magento アイコンが付いたメトリックは、Magento 外部連携から同期されたものです。

Magento メトリック

注文キャンセル

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

以下の条件に基づいて、Canceled Order イベントをフィルタリングし、ターゲットを絞ることができます：

• 値：注文の合計金額（小計 + 配送料 - 割引額）。
• アイテム：注文に含まれる商品の名前。
  例：T シャツや パンツ。複数回注文された場合は、同じアイテムが複数表示されます
• Item Categories：注文内のアイテムのカテゴリの完全なセット（例：T シャツ、メンズ、パンツ、およびセール）。
• 商品数：注文内の商品数（例： 2）。
• Currency Code：国（例：USD、EUR）に基づいて、アイテムに対して支払われた特定の通貨。
• 割引適用済み：この特定の商品に割引が適用されているかどうか（true/false）。
• クーポン：適用されたクーポンコード。
• ユニークアイテム：注文に含まれる個別アイテム（例： シャツ、ショートパンツ）。複数の商品が注文された場合、ユニークアイテムは 1 回のみ表示されます。
• 固有の商品カテゴリ：固有の商品がグループ化されるカテゴリです（例：mens、 sale）。
• 属性（任意）：カスタム商品属性。

チェックアウト完了

このイベントは、顧客が Magento ストアでチェックアウトを完了したときに追跡されます。Checkout Completed イベントは過去分が同期されないため、時間の経過に伴うイベント合計を見る際に、常に正確な指標になるとは限りません。収益のトラッキングとセグメンテーションには、Placed Order イベントを使用してください。

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

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

チェックアウト開始

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

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

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

注文発送済み

このイベントは、Magento ストアで注文を出荷済みとしてマークしたときに追跡されます。Klaviyo は、購入フォローアップメールで使用できる商品名、画像、バリエーション情報など、ユーザーが購入した商品の関連商品情報を追跡します。

以下の条件に基づいて、注文発送済みイベントをフィルタリングし、ターゲットを絞ることができます。

• 値：注文の合計金額（小計 + 配送料 - 割引額）。
• Items：注文に含まれる商品の名前（例：T シャツまたは パンツ）。複数回注文された場合、同じアイテムが複数表示されます。
• Item Categories：注文に含まれる商品のカテゴリ一式（例：T シャツ、メンズ、パンツ とセール）。
• Item Count：注文内の商品数。（例：2）。
• 通貨コード：国に基づき商品に対して支払われた特定の通貨（例：USD, EUR）。
• 割引適用済み：この特定の商品に割引が適用されているかどうか（true/false）。
• クーポン：適用されたクーポンコード。
• ユニークアイテム：注文内で作成される個々のアイテム（例：シャツ、ショートパンツ）。複数の商品が注文された場合、ユニークアイテムは 1 回のみ表示されます。
• 固有の商品カテゴリ：固有の商品がグループ化されるカテゴリです（例：mens、 sale）。
• 属性（任意）：カスタム商品属性。

購入商品

このイベントは、顧客が注文を行ったときに追跡されます。購入商品のイベントは、購入された各商品につき 1 件記録されます。たとえば、T シャツとパンツを購入した場合、1 件の「注文の確定」イベントに加え、T シャツ分として 1 件、パンツ分として 1 件の2件の「購入商品」イベントが記録されます。

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

• Value：商品の合計金額（配送料や適用された割引は含まれません）。
• 名前：この特定の項目に付けられた名前。
• SKU：アイテムを追跡するために割り当てられる特定の SKU（例：REDMEDIUMTSHIRT）。
• Categories：誰かの注文に含まれる商品のコレクションの完全なセット（例：T シャツ、メンズ、パンツ およびセール）。
• 価格：特定の商品のドル額（例：シャツ 25.50、靴 50.25）。
• コスト: 商品の製造コスト（例: シャツ 13.85、靴 20.00）。
• 通貨コード：国（例：USD、EUR）に基づいて、アイテムに対して支払われた特定の通貨。
• 割引適用済み：この特定の商品に割引が適用されているかどうか（true または false）。
• ProductID：ストア内の特定の商品 ID。
• 数量：注文した数量。
• 属性（任意）：カスタム商品属性。

注文の確定

このイベントは、顧客が Magento ストアでチェックアウトプロセスを完了し、注文を作成したときに追跡されます。Klaviyo は、購入フォローアップメールで使用できるように、購入されたアイテムに関する商品名、画像、バリエーション情報などの関連データを追跡します。以下の条件に基づいて、注文の確定イベントをフィルタリングし、ターゲットを絞ることができます：

• 値：注文の合計金額（小計+送料-割引）。
• 商品：注文に含まれる商品の名前（例：t-shirt または pants）。複数回注文した場合は、同じ商品が複数表示されます。
• Item Categories：ユーザーの注文内のアイテムのカテゴリの完全なセット（例：T シャツ、メンズ、パンツ、および セール）。
• Item Count：注文内の商品数（例：2）。
• 通貨コード：国に基づき、商品に対して支払われた特定の通貨（例：USD, EUR）。
• 割引適用済み：この特定の商品に割引が適用されているかどうか（true/false）。
• クーポン：適用されたクーポンコード。
• 固有アイテム：注文内で作成された個々のアイテム（例：シャツ、ショーツ）。 複数の商品が注文された場合でも、固有アイテムは 1 回のみ表示されます。
• Unique Item Categories：ユニーク アイテムがグループ化されるカテゴリ（例： mens、sale）。
• 属性（任意）：最大 10 個のカスタム商品属性を注文の確定に同期できます。この同期は、カスタム属性データが Klaviyo アカウントに取り込まれる前に有効にする必要があります。これを設定する方法については、以下のセクションを参照してください。

返金済の注文

このイベントは、Magento で注文が払い戻されたときに追跡されます。

• 値：注文の合計金額（小計+送料-割引）。
• クーポン：適用されたクーポンコード。
• 通貨コード：国に基づき、商品に対して支払われた特定の通貨（例：USD, EUR）。
• 割引済み：この特定のアイテムに割引が適用されていたかどうか（true/false）。
• Item Categories：ユーザーの注文内のアイテムのカテゴリの完全なセット（例：T シャツ、メンズ、パンツ、および セール）。
• アイテム数：注文内のアイテム数（例：2）.
• Items：注文に含まれる商品の名前（例：T シャツまたは パンツ）。複数回注文した場合は、同じ商品が複数表示されます。
• 一意のアイテムカテゴリ: 一意のアイテムがグループ化されているカテゴリ（例：mens、sale）。
• Unique Items：注文内で作成された個々の item。例: シャツ、ショートパンツ。 複数の商品が注文された場合、ユニークアイテムは 1 回だけ表示されます。

売上（つまり、「確定した注もの金額」）は、次のように計算されます：（注文の価格 + 送料 - 割引）。$value に基づいてセグメントをフィルタリングするには、売上を使用してセグメントをフィルタリングします。

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

同期された顧客データ

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

• メール
• 名と姓
• 市区町村、都道府県/州・地域、郵便番号、国
• 電話番号
• Magento アカウントが作成された日時（例：2015-05-01 00:00:00）
• Magento 顧客グループ（例：卸売）
• Magento ストア（例：米国ストア）
• 生年月日（例：1990-01-01）
• 性別
• website_ID は取得されません
• 送信抑制は Klaviyo にコピーされないため、Klaviyo プラットフォームには表示されません

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

注文の確定のカスタム商品属性を同期する

Klaviyo では、「注文の確定」のメトリックに対して最大 10 個のカスタム商品属性を同期できます。カスタム商品属性は自動的に Klaviyo に同期されませんが、Klaviyo に取り込みをリクエストできます。これを行うには、カスタム属性 ID（手順は以下）を収集し、サポートチームにリクエストを送信してください。

カタログ > 属性 > 属性の管理に移動し、属性をクリックして、Magento の管理者パネルでカスタム商品 ID を見つけます。

ID は、次のように URL 内で見つかります。

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

Klaviyo は Magento データをすべてインポートします。これを確認するには、特定の日の注文数を Magento インターフェースの数と比較し、一致することを確認できます。左側のサイドバーで Analytics をクリックし、Placed Order メトリックを見つけてクリックします。これにより、メトリックのグラフページに移動し、デフォルトで直近 30 日間のデータが表示されます。以下に表示されているメトリックのグラフの例を確認できます。

昨日の注文数を確認するには、昨日のデータ ポイントにマウスオーバーするか、グラフの下にあるデータ テーブルを確認してください。その数を Magento に保存されている数と比較すると、完全に一致しているはずです。一致しない場合、最も可能性が高い問題は、Klaviyo アカウントのタイムゾーンが Magento のタイムゾーンと一致していないことです。タイムゾーン設定を確認するには：

1. 左下隅の組織名をクリックします。
2. [設定] をクリックします。
3. Select 組織.

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

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

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

これは、Magento の注文データと結合される注文に対して、正しいプロパティを送信するのに役立ちます。

注文の確定

// 
// PLACED ORDER
// ------------------------------------------

{
  "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"], // If an item is ordered more than once, duplicate it. For example, someone orders two t-shirts this would be: ["T-Shirt", "T-Shirt"]
    "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
}

購入商品

// 
// ORDERED PRODUCT
// ------------------------------------------

{
  "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", // LineId (unique)
    "$value" : 9.99,
    "Currency Code" : "USD",
    "Name" : "Winnie the Pooh",
    "SKU" : "WINNIEPOOH",
    "ProductID" : "567",
    "Categories" : ["Fiction", "Classics"],
    "Price" : 9.99,
    "Discounted" : true,
    "Cost" : 5.00, // (optional),
    "Attribute: Color" : "Red" // product attributes (optional)
    "$extra" : {
        "Product URL Key" : "winnie-pooh",
        "Product URL" : "https://www.store.com/winnie-pooh",
        "Image URL" : "https://cnd.store.com/images/winnie-pooh.png",
    }
  },
  "time" : 1387302423
}

注文発送済み

// 
// FULFILLED ORDER
// ------------------------------------------

{
  "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"], // If an item is ordered more than once, duplicate it. For example, someone orders two t-shirts this would be: ["T-Shirt", "T-Shirt"]
    "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
}

その他のリソース