WooCommerce データリファレンス

WooCommerce との連携で同期されるデータ

この記事では、WooCommerce ストアと Klaviyo アカウントを連携する際に同期されるデータについて説明します。

Klaviyoアカウントで、[アナリティクス] > [メトリック]に移動すると、アカウント内のすべてのメトリックを確認できます。名前でメトリックを検索し、選択してデータを表示します。「商品をカートに追加」メトリックを除き、すべてのWooCommerceメトリックにはWooCommerceアイコンが表示されます。「商品をカートに追加」メトリックには歯車アイコンが表示されます。各メトリックについては、以下で個別に説明します。

チェックアウトの開始

このイベントは、次のいずれかが発生したときに追跡されます。

• 顧客がアカウントにログインし、カートに商品を追加して、チェックアウトページを表示しした場合
• 顧客がカートに商品を追加し、チェックアウトページを表示し、請求先メールアドレスを入力した場合

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

• $value：カート金額
• Categories：カート内の商品のカテゴリー
• Currency：カートの通貨の種類
• CurrencySymbol：カートの通貨記号
• ItemNames：カート内の商品の名前を含む配列

Klaviyoは、チェックアウト時点でのカート金額だけでなく、パーソナライズされたカゴ落ちメールに活用できる、顧客のカートに関するその他の関連情報も取得します。WooCommerce のカゴ落ちフローには、「チェックアウト開始」メトリックをトリガーとするフローと、「カートに追加」メトリックをトリガーとするフローの 2 種類があります。どちらのメトリックでも、カート再現キーを利用できます。このキーを使用すると、顧客が別のデバイス上で、このイベントによってトリガーされたメールからカートに戻った場合にも、顧客のカートを再現するリンクを作成できます。このキーは「extra」プロパティの配列の中にあります。このリンクは以下の URL で作成できます。

{{ organization.url|trim_slash }}/cart?wck_rebuild_cart={{ event.extra.CartRebuildKey }}

商品をカートに追加

このメトリックは、Klaviyo によって Cookie が付与された顧客が商品をカートに追加したときに追跡されます。

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

• $value：商品の金額
• AddedItemCategories：商品が属するカテゴリー
• AddedItemDescription：商品の説明
• AddedItemImageURL：商品の画像の URL
• AddedItemPrice：商品の価格
• AddedItemProductID：WooCommerceストアの商品のカスタムID（例：1234）
• AddedItemProductName：ストア内の商品の名前（例：赤い T シャツ）
• AddedItemQuantity：商品の数量
• AddedItemSKU ：ストア内の商品の SKU（例：REDMEDIUMTSHIRT）
• AddedItemTags：商品に関連付けられたタグ
• AddedItemURL：商品の URL
• Categories：カート内の全商品のカテゴリー
• ItemCount：カート内の商品の総数
• ItemNames：カート内の全商品の名前
• タグ：カート内の全商品のタグ

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

{{ organization.url|trim_slash }}/cart?wck_rebuild_cart={{ event.extra.CartRebuildKey}}

「extra」プロパティの配列はセグメント化には使用できませんが、この配列には、カート再現キーに加え、カート内のラインアイテム、カートの合計金額、小計、税合計などの有用な情報が含まれています。

注文の確定

このイベントは、顧客が WooCommerce ストアでチェックアウトプロセスを完了し、注文を作成したときに追跡されます。Klaviyoは、ステータスが処理中または完了の注文を同期した際に「注文の確定」イベントを記録します。また、返金済みの注文と支払い済みのキャンセル注文については、元の注文作成時刻を使用して「注文の確定」も記録します。未払いのキャンセル注文は追跡されません。

Klaviyo が追跡するイベントには、WooCommerce によって取得されたすべての商品情報が含まれるため、この詳細データを購入フォローアップメールで活用できます。以下の基準に基づいて、「注文の確定」イベントをフィルタリングし、ターゲットを絞ることができます。

• $value: 注文の値
• ItemNames：注文に含まれる商品の名前（例：T シャツ、パンツ）
• IsDiscounted：注文における割引の有無（true または false）
• UsedCoupon：注文におけるクーポン使用の有無（例：true または false）
• ItemCategories：カート内の商品が属するカテゴリー
• ShippingMethods（ ある場合）
• Coupons（ ある場合）

収益（注文の確定の値）は、WooCommerceで報告される注文合計を使用します。これには、割引後の配送料と税金が含まれます。

Klaviyoの注文の確定の収益では返金済みの注文が差し引かれないため、返金を差し引くWooCommerceの収益と異なる場合があります。

WooCommerce外部連携の設定で通貨コンバージョンをオンにすると、Klaviyoはイベントの処理時点の為替レートを使用して、「注文の確定」と「購入商品」の値を選択した通貨に変換します。詳細はWooCommerce設定ガイドをご覧ください。

注文発送済み

このイベントは、KlaviyoがWooCommerceストアで完了ステータスの注文を同期するタイミングを追跡します。

Klaviyo が追跡するイベントには、商品名、画像、各種商品情報など、購入された商品に関するすべての製品情報が含まれるため、それらの情報を購入フォローアップメールで活用できます。以下の条件に基づいて、注文発送済みイベントをフィルタリングし、ターゲットを絞ることができます。

• $value: 注文の値
• ItemNames：注文に含まれる商品の名前（例：T シャツ、パンツ）
• IsDiscounted：注文における割引の有無（true または false）
• UsedCoupon：注文におけるクーポン使用の有無（例：true または false）
• ItemCategories：カート内の商品が属するカテゴリー
• ShippingMethods（ ある場合）
• Coupons（ ある場合）

購入商品

注文ステータスが処理中または完了の場合、購入された各商品単位についてこのイベントが追跡されます。たとえば、Tシャツとパンツを購入した場合、1件の注文の確定イベントが追跡され、2件の購入商品イベント（Tシャツ分の1件とパンツ分の1件）が追跡されます。

同じTシャツを2枚購入した場合、Klaviyoは購入商品イベントを2件記録し、それぞれのQuantityは1に設定されます。Klaviyoは、1つの明細項目あたり最大100件の購入商品イベントを記録します。

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

• $value：商品の金額
• ProductId：WooCommerce ストアの商品のカスタム ID（例：1321）
• SKU：ストア内の商品の SKU（例：REDMEDIUMTSHIRT）
• Name：ストア内の商品の名前（例：赤い T シャツ）
• 数量：1（各イベントは購入された1単位を表すため）
• Categories：カテゴリーの一覧

注文キャンセル

このイベントは、Klaviyoがお客様のWooCommerceストアでキャンセル済みステータスの有料注文を同期したときに追跡されます。未払いのキャンセル済み注文は追跡されません。以下の条件に基づいて、「キャンセル済みの注文」 イベントをフィルタリングし、ターゲットを絞ることができます。

• $value: キャンセルされた注文の合計金額
• IsDiscounted：注文における割引の有無（true または false）
• ProductNames：注文に含まれる各商品の名前
• UsedCoupon：注文におけるクーポン使用の有無（例：true または false）
• ItemCategories： カート内の商品が属するカテゴリー
• ItemNames：注文に含まれる商品の名前（例：T シャツ、パンツ）
• Coupons（ ある場合）
• ShippingMethods（ ある場合）

返金済の注文

このイベントは、KlaviyoがWooCommerceストア内の返金済みステータスの注文を同期したときに追跡されます。注文が処理中または完了のままになる一部返金では、このイベントはトリガーされません。以下の条件に基づいて、「返金済済みの注文」イベントをフィルタリングし、ターゲットを絞ることができます：

• $value：返金済みの注文の合計金額
• IsDiscounted：注文における割引の有無（true または false）
• ProductNames：注文に含まれる各商品の名前
• UsedCoupon：注文におけるクーポン使用の有無（例：true または false）
• ItemCategories： カート内の商品が属するカテゴリー
• ItemNames：注文に含まれる商品の名前（例：T シャツ、パンツ）
• Coupons（ ある場合）
• ShippingMethods（ ある場合）

商品の閲覧

このイベントは、（Klaviyo によって Cookie が付与された）顧客が商品を閲覧した際に追跡されます。これは、閲覧放棄フローを設定したり、商品の閲覧データに基づいてセグメントを構築したい場合に便利です。

サイトの訪問

このイベントは、顧客（以前に Klaviyo によって Cookie 付与済み）がサイト上でアクティブになったときに追跡されます。

顧客データ

WooCommerceアカウントを作成しても、それだけではプロファイルは同期されません。Klaviyoは、注文が同期されたとき、またはオンサイトトラッキングによってログイン中の顧客が識別されたときにプロファイルを作成します。マーケティング同意は、設定済みのチェックアウト同意オプションを通じて別途収集されます。