Shopware データリファレンス

このページで学べること

Shopware 6 から Klaviyo に同期されるデータの内容、そのデータの確認方法、および Shopware イベントに含まれるプロパティについて説明します。

始める前に

この記事を読み進める前に、ストアを連携する手順を段階的に説明した Shopware のスタートガイドをお読みください。

データの表示方法

Shopware から Klaviyo に同期されたデータを表示するには：

1. Klaviyo アカウントで、左側のナビゲーションにある Analytics をクリックします。
2. [メトリック] を選択します。
3. API でメトリックのリストを絞り込みます。Shopware 外部連携は Klaviyo が直接構築したものではないため、イベントは API ラベルで同期され、歯車アイコンが表示されます。API で絞り込むと、API 経由で同期したカスタム メトリックも表示されます。
4. 「注文の確定」などの個別のメトリックをクリックすると、時間の経過に伴うアクティビティのチャートが表示されます。個別のメトリックについて、上部のタブを選択すると、アクティビティフィード、コホート、ベストピープル、アクティビティマップも表示できます。
5. [アクティビティ フィード] をクリックし、個々のイベントのタイムスタンプをクリックします。ここで、そのイベントに関連付けられたプロパティを確認できます。

Shopware から同期されたデータ

外部連携の設定で構成した場合、以下の種類のデータが Shopware から Klaviyo に同期されます：

• メール購読者（Shopware または Klaviyo フォーム経由で購読）
• 商品カタログ（カスタム カタログ フィードの同期を設定している場合）
• オンサイト イベント
  • サイトの訪問
  • 閲覧した商品/最近閲覧したアイテム
  • チェックアウトの開始
• トランザクション イベント
  • 商品をカートに追加
  • 注文の確定
  • 購入商品
  • 注文発送済み
  • 注文キャンセル
  • 返金済の注文
  • 有料注文
  • 再入荷通知を購読

メール購読の同期の仕組み

Shopware のフォームで登録したメール購読者は、Shopware の拡張機能設定で Klaviyo のリストを選択している場合、Klaviyo で購読者として同期されます。

購読者が Klaviyo で購読解除すると、Shopware でも購読解除されます。Shopware のニュースレター リストでは、Klaviyo で購読解除したユーザーは 「削除待ち」としてマークされます。Shopware から送信したメールで受信者が購読解除しても、Klaviyo では購読解除されません。

同期されたイベントとその最上位プロパティ

サイトの訪問

これは、Cookie 付与済みユーザーがサイト上でアクティブなときに Klaviyo が追跡するデフォルトのイベントです。このイベントには、セグメンテーションで使用する他のプロパティは含まれません。

商品の閲覧

商品閲覧 イベントは、Cookie を持つユーザーがサイトの商品ページを閲覧したときにトラッキングされます。最近閲覧したアイテムがそのユーザーのプロファイルに追加されます。このイベントには、次のトップレベルプロパティが含まれます：

• 商品名
• 商品 ID
• SKU
• カテゴリ（配列）
• 画像 URL
• URL
• ブランド
• 価格
• CompareAtPrice

商品をカートに追加

このイベントは、ログイン中のユーザーが商品をカートに追加するたびに追跡されます。このイベント内では、Items 配列に、このイベントが作成された時点でカートに入っている他のすべての商品が一覧表示されます。このイベントの CheckoutURL を使用して、現在のカートを再構築できます。

「カートに追加」イベントには、次のトップレベルプロパティが含まれます：

• AddedItemProductName
• AddedItemProductID
• AddedItemSKU
• AddedItemCategories
• AddedItemImageURL
• AddedItemURL
• AddedItemPrice
• AddedItemQuantity
• ItemNames
• チェックアウト URL
• 項目
• $value

チェックアウトの開始

このイベントは、Cookie を持つユーザーが 1 つ目のチェックアウトページでメールアドレスを入力した後、2 つ目のチェックアウトページに移動したときに追跡します。Started Checkout イベントには、次の最上位プロパティが含まれます。

• チェックアウト URL
• ItemNames（配列）
• カテゴリー
• アイテム（配列）
• $value"： 19.99

注文の確定

Placed Order は注文が行われたときにトラッキングされ、注文内のすべての商品を含む Items 配列が含まれます。Placed Order は Ordered Product と異なります。Ordered Product イベントは注文内の各商品ごとにトラッキングされる一方、Placed Order は注文全体に対して 1 回トラッキングされ、配送先住所などの情報が含まれます。Placed Order イベントには、次のトップレベル プロパティが含まれます。

• OrderId
• カテゴリー
• ItemNames
• ブランド
• 割引コード
• 割引額
• 項目
• 請求先住所
• 配送先住所
• $value

購入商品

Ordered Productイベント（注文内の各アイテムに対して追跡されます）には、次のトップレベル プロパティが含まれます：

• 商品名
• OrderId
• 商品 ID
• SKU
• 数量
• 商品 URL
• 画像 URL
• カテゴリー
• ProductBrand
• $value

注文発送済み

Fulfilled Orderイベントには、次のトップレベル プロパティが含まれます：

• OrderID
• カテゴリー
• ItemNames
• ブランド
• 割引コード
• 割引額
• 項目
• 請求先住所
• 配送先住所

注文キャンセル

キャンセルされた注文 イベントには、次のトップレベルプロパティが含まれます：

• OrderID
• カテゴリー
• ItemNames
• ブランド
• 割引コード
• 割引額
• 項目
• 請求先住所
• 配送先住所
• 理由
• $value

返金済の注文

Refunded Order イベントには、次のトップレベルプロパティが含まれています：

• OrderID
• カテゴリー
• ItemNames
• ブランド
• 割引コード
• 割引額
• 項目
• 請求先住所
• 配送先住所
• 理由
• $value

有料注文

Shopware で注文が 支払い済み に設定されると、Paid Order イベントがトリガーされます。これには、次のトップレベル プロパティが含まれます：

• OrderID
• カテゴリー
• ItemNames
• ブランド
• 割引コード
• 割引額
• 項目
• 請求先住所
• 配送先住所
• 理由
• $value

再入荷通知を購読

このイベントは、誰かが再入荷アラートを購読したときに追跡されますが、他のトップレベルのプロパティは含まれません。

その他のリソース