Kameleoon.API.Products: Tracking - Kameleoon Documentation

これらのメソッドを使用して、製品とカテゴリの閲覧、検索、カートの変更、ウィッシュリストへの追加、購入を Kameleoon に送信します。

このモジュールは、Product Recommendation モジュールまたは Product Targeting アドオンを購読している場合に利用できます。

trackAddToCart

trackAddToCart() メソッドは、訪問者がショッピングカートに商品を追加したときにトリガーされます。

var buyButton = Kameleoon.API.Utils.querySelectorAll("#buyButton")[0];
Kameleoon.API.Utils.addEventListener(buyButton, "mousedown", function () {
  Kameleoon.API.Products.trackAddToCart("myProductId", 19.99, 1, {
    stock: true, 
    recommended_code: 'some-unique-code', //see the arguments table for more information
    recommended_by: 'dynamic'//see the arguments table for more information
  });
});

引数

名前	型	説明
productID	String	商品の一意の識別子。このフィールドは必須です。
unitPrice	Number	productID で参照される製品の 1 単位あたりの価格。このフィールドは省略可能です。指定しない場合、Kameleoon はインポートした製品フィードの製品のデフォルト価格を使用します。
amount	Number	カート更新後の商品の合計数量。インクリメンタルな値ではなく絶対値を使用してください。たとえば、カートに同じ `productID` のアイテムが 2 つあり、もう 1 つ追加する場合は 3 を指定します。20 個入っているカートから 2 個削除する場合は 18 を指定します。
parameters	Object	推奨プラットフォームのパラメータ。このフィールドは省略可能です。

推奨プラットフォームのパラメータ

名前	型	説明
recommended_by	String	SPA またはポップアップの場合、この値を “dynamic” に設定します。このフィールドは特定のシナリオで必須です。
recommended_code	String	SPA またはポップアップの場合、アカウントの “data-recommender-code” 属性にある一意のウィジェットコードを提供します。
stock	Boolean	商品の在庫状況。この値は商品フィードまたはカタログインポートからのデータを上書きします。このフィールドは省略可能です。

trackAddToWishList

trackAddToWishList() メソッドは、訪問者がウィッシュリストやお気に入りに商品を追加または削除したときに実行されます。

Kameleoon.API.Products.trackAddToWishList("myProductId"); // to add to wish list

Kameleoon.API.Products.trackAddToWishList("myProductId", -1); // to remove from wish list

名前	型	説明
productId	String	ウィッシュリストに追加された商品の一意の識別子。このフィールドは必須です。
quantity	Number	更新する数量。削除を示すには負の値 (例: -1) を使用します。省略された場合、このメソッドはデフォルトで 1 になります。

trackCategoryView

trackCategoryView() メソッドは、セッション中の各カテゴリページビューに対して実行されます。

if (location.href.indexOf("productPage") != -1) {
  Kameleoon.API.Core.runWhenConditionTrue(function () {
    return typeof dataLayer != null;
  }, function () {
    dataLayer.forEach(function (map) {
      if (map.categoryID) {
        Kameleoon.API.Products.trackCategoryView(5);
      }
    });
  }, 200);
}

引数

名前	型	説明
categoryID	String	一意のカテゴリ識別子。このフィールドは必須です。

trackProductView

trackProductView() メソッドは、セッション中の各商品ビューに対して実行されます。このメソッドにより、Kameleoon は XML フィード統合なしで自動化された商品カタログを構築でき、商品推奨プロジェクトのセットアップが簡素化されます。

Kameleoon.API.Products.trackProductView("myProductID", {
    "name": "productName",
    "categories": [{
        "id": "13",
        "name": "productCategory",
        "parent": null,
        "url": "website.com/category/2"
    }],
    "imageURL": "https://www.mywebsite/productImage.jpg",
    "price": 19.99,
   "oldPrice": 23.99,
    "accessories": ['productID1', 'productID2'],
    "available": true,
    "availableQuantity": 15,
    "brand": "productBrand",
    "groupId": "groupID1",
    "sku": "productSKU",
    "description": "This is a short description",
    "rating": 4,
    "model": "phone 14 128GB",
    "leftovers": "one",
    "tags": ["shirt", "red"],
    "typePrefix": "mobile phone",
    "seasonality": [1, 2, 3, 10, 11, 12],
    "priceMargin": 100,
    "isChild": false,
    "isNew": false,
    "isFashion": true,
    "auto": {
        "vds": ["BP8AN5", "HH5820"],
        "compatibility": [ 
            {
                "brand": "BMW"
            }, 
            { 
                "brand": "Mini", "model": "Cooper S" 
            } 
        ]
    },
    "fashion":  {
        "gender": "f",
        "type": "shoe",
        "sizes": ["37", "42"],
        "feature": "adult",
        "colors": [ 
            { 
                "color": "red" 
            }, 
            { 
                "color": "green", "picture": "https://example.com/items/395532-green.jpg" 
            }
        ]
    },
    "params": [
        {
            "name": "connectivity",
            "value": ["bluetooth", "wi-fi"]
        },
        {
            "name": "lengths",
            "value": ["4", "6", "8"],
            "unit": "cm"
        }
    ]
});

引数

名前	型	説明
productID	String	製品の識別子。この製品を特定する一意の値を使用してください。このフィールドは必須です。
productData	Object	Product オブジェクト。Product Recommendation アドオンを通じて製品フィードをインポートする場合は必須です。

trackSearchQuery

trackSearchQuery() メソッドはユーザーの検索クエリを記録します。

Kameleoon.API.Products.trackSearchQuery("Example search request");

引数

名前	型	説明
search_query	String	検索クエリの値。このフィールドは必須です。

trackTransaction

trackTransaction() メソッドは、取引または購入が発生したときに実行されます。

Kameleoon.API.Products.trackTransaction(
 [
  {
   "productID": "myProductID1",
   "quantity": 4
  },
  {
   "productID": "myProductID4564",
   "quantity": 1
  }
 ],
 {
  "order": "N318",
  "order_price": 29999
 }
);

引数

名前	型	説明
products	Array	取引内の各商品の `productID` と `quantity` を含むオブジェクトのリスト。このフィールドは必須です。
params	Object	推奨プラットフォーム用の追加パラメータ。このフィールドは省略可能です。

trackTransaction の追加パラメータ

名前	型	説明
order	string	店舗の注文番号。これを省略すると、エンジンは内部の番号付けシステムを使用し、注文ステータスの同期ができなくなります。下記のパラメータ説明を参照してください。
order_price	Number	割引、ボーナス、追加サービスを含む最終的な注文金額。省略すると、エンジンは商品データベースから割引やサービスを含まない金額を計算します。
email	string	顧客のメールアドレス。
phone	string	顧客の電話番号。
promocode	string	取引のプロモコード。
order_cash	number	現金支払金額。
order_bonuses	number	ボーナス支払金額。
order_delivery	number	配送料。
order_discount	number	注文割引金額。
delivery_type	string	配送方法。
payment_type	string	支払いタイプ (例: “cash”、“card”、“wire”)。
tax_free	boolean	免税ステータス。

API

​trackAddToCart

​推奨プラットフォームのパラメータ

​trackAddToWishList

​trackCategoryView

​trackProductView

​trackSearchQuery

​trackTransaction

​trackTransaction の追加パラメータ

trackAddToCart

推奨プラットフォームのパラメータ

trackAddToWishList

trackCategoryView

trackProductView

trackSearchQuery

trackTransaction

trackTransaction の追加パラメータ