Technical Documentation

技術文書

Matomoに関する技術文書

Eコマースの手動トラッキング:クイックスタート

 

このガイドでは、カスタムEコマースプラットフォームを使用しているサイトにEコマーストラッキングを手動で実装する方法の例を提供します。WooCommerceのようなカスタムビルドでないEコマースプラットフォームを使用している場合は、Eコマース統合ページのページを参照してください。あなたのプラットフォーム用の統合方法やプラグインがすでに存在するかどうかを確認してください。またShopifyとの統合ガイドも提供しています。

このガイドはJavaScriptトラッキング・クライアントで使用するために書かれていますが、このガイドに含まれるトラッキング・コールは、カスタム HTML タグを使用してMatomo Matomo タグマネージャ経由で Web ページに組み込むことができます。

はじめに

Eコマースのアクションを追跡しやすくするために、すべてのカートアイテムを次のような1つのJavaScript変数cartProductsに含めることをお勧めします。これにより、Eコマースのアクションを Matomo に報告する際に、アイテムをループすることができます。以下は、変数がどのように作成されるかの例です。各商品に正しい詳細を割り当てるには、カスタムスクリプトを使用する必要があります。

//array containing all items in the cart along with product details
var cartProducts = [
{
    productSKU: "0123456789",
    productName: "Ecommerce Analytics Book",
    productCategory: ["Books", "Best sellers"],
    price: 9.99,
    quantity: 1
},
{
    productSKU: "9876543210",
    productName: "Product 2",
    productCategory: ["Electronics", "Gadgets"],
    price: 19.99,
    quantity: 2
},
{
    productSKU: "4567891230",
    productName: "Product 3",
    productCategory: ["Clothing", "T-Shirts"],
    price: 14.99,
    quantity: 3
},
{
    productSKU: "7890123456",
    productName: "Product 4",
    productCategory: ["Toys", "Kids"],
    price: 24.99,
    quantity: 2
}
];

カートアイテムの管理

カートの在庫を管理するには、サーバーサイドでカートアイテムのリストを管理する必要があります。これはcartProducts変数に代入します。顧客がまだカートに商品を入れていない場合、空の配列を cartProductsに割り当てて空のカートを追跡することをお勧めします。これにより、既存の商品の有無にかかわらず、単純に新しい商品を配列にプッシュできるようになり、商品を追加する前に配列が存在するかどうかをチェックする必要がなくなります。

Matomoでカートアイテムを管理するには2つの方法があります:
1.数量を減らした商品、削除した商品、カートに追加した商品のみを追跡することで、個々の商品の変更を管理します。
2.Matomoのすべてのカートアイテムをクリアし、カートの更新ごとにカートアイテムの完全なリストを追跡します。

本ガイドラインと実施方法を簡単にするため、以下ではオプション2を使用する。

Eコマース・アクションのトラッキング

さて、顧客のすべてのカートアイテムを格納した変数ができたので、これらのアイテムを Matomo に追跡する方法を見てみましょう。以下のスクリプトは、各項目をループし、製品の詳細を提供しながら、メソッドaddEcommerceItemを呼びだします。そして、そのcartProducts変数の全商品の合計金額を集計し、最後にメソッドtrackEcommerceCartUpdateを呼びだしてカートのデータをMatomoに送信します。

//reset the cart items in Matomo
_paq.push(['clearEcommerceCart']);

//loop through each item to report cart data to Matomo
cartProducts.forEach(function(product) {
    _paq.push(['addEcommerceItem',
    product.productSKU,
    product.productName,
    product.productCategory,
    product.price,
    product.quantity
]);
});

//calculate the sum total of all cart items
var totalCartValue = cartProducts.reduce(function(total, product) {
    return total + (product.price * product.quantity);
}, 0);

//push the cart data to Matomo
_paq.push(['trackEcommerceCartUpdate', totalCartValue]);

注文を追跡するために、前のステップで計算したのと同じカート値を使用してtrackEcommerceOrderメソッドを使用してください。税金や送料を追加する必要がある場合は、この呼び出しの中でこれらの値を指定してください…

_paq.push(['trackEcommerceOrder',
    "000123", // (Required) orderId
    totalCartValue, // (Required) grandTotal (revenue)
    0, // (Optional) subTotal
    0, // (optional) tax
    0, // (optional) shipping
    false // (optional) discount
]);

製品ビューのトラッキング

商品ビューのトラッキングは、カート時間のトラッキングと同様の方法で行うことができます。商品ページが読み込まれたら、商品の詳細を例えばこのviewProduct変数には、閲覧した商品の詳細が格納される。例えば

var viewProduct = {
    name: "Neon Lamp",
    sku: "SKU1",
    category: ["Category1", "Subcategory1"]
};

ページビューを追跡する直前にsetEcommerceViewメソッドに、変数から詳細を渡す。

//set the commerce view
_paq.push(['setEcommerceView',
    viewProduct.name, // Product name is not applicable for a category view.
    viewProduct.sku, // Product SKU is not applicable for a category view.
    viewProduct.category, // Product category, or array of up to 5 categories
]);

//you must call trackPageView when tracking an Ecommerce view
_paq.push(['trackPageView']);

さらに詳しく

このガイドでは、カスタムEコマースプラットフォームでMatomoのEコマースアクションを追跡するために必要なフレームワークの基本的な理解を提供します。また上記で説明した方法や、Matomoで利用可能なその他のEコマース方法の詳細については、こちらをご覧ください。
上級者向け:マニュアルEコマース追跡ガイド

 

 

同じカテゴリーの技術文書

Eコマースレポートを分析して売上を向上させる

Eコマースの概要 についてEコマースの概要セクションは、オンラインストアの一般的なパフォーマンスをハイレベルで把握するのに最適な場所です。一目で、どれだけの売上があり、どれだけの収益を上げているのか、そしてウェブサイトの…

Eコマースレポートを分析して売上を向上させる

  Eコマースの概要 Eコマースの概要セクションは、オンラインストアの一般的なパフォーマンスをハイレベルで把握するのに最適な場所です。一目で、売上数、売上高、ウェブサイトのコンバージョン率を確認することができま…

MatomoでEコマースのトラッキングを設定する

  MatomoでEコマーストラッキングを設定するには、主に2つの段階があります。最初の段階では、Matomoのインターフェイス内でEコマースのトラッキングを有効にしておく必要があります。この設定は、Matom…

上級者向け:MatomoでEコマースのアクションを手動でトラッキングする

  もしあなたのウェブサイトがMatomoと統合できるコンテンツマネージメントシステムやeコマースプラットフォームを利用していない場合、手動で統合する必要があるかもしれません。チェックアウトプロセスにJavaS…

既存のGTMカートデータによる手動Eコマース・トラッキング

  すでに Google Tag Manager (GTM) で E コマースの注文をトラッキングしている場合、GTM dataLayer を読み込むことで Matomo で E コマースのトラッキングを設定で…

オンラインデモを体験

面倒なアカウント登録や
サーバーへのインストールは一切不要です。
実際の解析データを反映した管理画面で、
Matomoの快適な操作感を
今すぐ体験できます。

matomo画面
※Matomo Cloudは
Matomo開発元である
InnoCraft社が
提供するサービスです。
matomo画面

法人向け導入運用サポート

導入から運用まで 完全支援

Matomoユーザー会では、法人・団体向けにMatomoの導入から運用までの技術支援を行っています。
必要なサービスだけを組み合わせてご利用いただけます。

導入・運用支援

初期構築をお任せ

要件の整理から環境構築、導入直後の調整まで、必要な作業をまとめてお任せいただけます。

  • 要件整理・ヒアリング
  • 環境構築・インストール
  • パフォーマンス調整

matomo保守

導入後も安心の保守

操作や設定のご相談から、バージョンアップや性能改善までを継続的に支援します。

  • お問い合わせ対応
  • バージョンアップ対応
  • 性能・障害の調査対応

サーバ保守

サーバ稼働もお任せ

Matomoが動作するサーバを監視し、障害時も含めて計測を止めない状態を維持します。

  • 死活・リソース監視
  • 障害の一次・二次対応
  • 24時間365日の対応

オプション

必要な分だけ依頼

ご契約の有無にかかわらず、必要な作業だけを単発でご依頼いただけます。

  • トレーニング・設定代行
  • マニュアル・運用設計
  • データ移行
法人導入のご相談はお気軽にお問い合わせください。

要件整理・見積もり・PoC環境提供まで無償で対応いたします。