Kameleoon.API.Products: Tracking - Kameleoon Documentation

Verwenden Sie diese Methoden, um Produkt- und Kategorieaufrufe, Suchanfragen, Änderungen im Warenkorb, Ergänzungen der Wunschliste und Käufe an Kameleoon zu senden.

Dieses Modul ist verfügbar, wenn Sie das Modul “Produktempfehlung” oder das Zusatzmodul “Produkt-Targeting” abonniert haben.

trackAddToCart

Die trackAddToCart() Methode wird ausgelöst, wenn ein Besucher ein Produkt zum Einkaufswagen hinzufügt.

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', //siehe Argumenttabelle für weitere Informationen
    recommended_by: 'dynamic'//siehe Argumenttabelle für weitere Informationen
  });
});

Arguments

Name	Type	Description
productID	String	Eindeutige Produktkennung. Dieses Feld ist erforderlich.
unitPrice	Number	Preis für eine Einheit des Produkts, auf das productID verweist. Dieses Feld ist optional; wenn Sie es nicht angeben, verwendet Kameleoon den Standardpreis des Produkts aus dem importierten Produkt-Feed.
amount	Number	Gesamtmenge des Produkts nach der Warenkorb-Aktualisierung. Verwenden Sie nicht-inkrementelle Werte. Wenn der Warenkorb beispielsweise zwei Artikel mit der gleichen `productID` enthält und Sie einen weiteren hinzufügen, geben Sie 3 an. Wenn Sie zwei Artikel aus einem Warenkorb mit 20 Artikeln entfernen, geben Sie 18 an.
parameters	Object	Parameter für die Empfehlungsplattform. Dieses Feld ist optional.

Parameter für die Empfehlungsplattform

Name	Type	Description
recommended_by	String	Setzen Sie für SPAs oder Pop-ups diesen Wert auf “dynamic”. Dieses Feld ist erforderlich in bestimmten Szenarien.
recommended_code	String	Stellen Sie für SPAs oder Pop-ups den eindeutigen Widget-Code bereit, den Sie im Attribut “data-recommender-code” in Ihrem Konto finden.
stock	Boolean	Produktverfügbarkeit. Dieser Wert setzt Daten aus Produktfeeds oder Katalogimporten außer Kraft. Dieses Feld ist optional.

trackAddToWishList

Die trackAddToWishList() Methode wird ausgeführt, wenn ein Besucher ein Produkt von der Wunschliste oder den Favoriten hinzufügt oder entfernt.

Kameleoon.API.Products.trackAddToWishList("myProductId"); // zum Hinzufügen zur Wunschliste

Kameleoon.API.Products.trackAddToWishList("myProductId", -1); // zum Entfernen von der Wunschliste

Name	Type	Description
productId	String	Eindeutige Kennung des zur Wunschliste hinzugefügten Produkts. Dieses Feld ist erforderlich.
quantity	Number	Menge zum Aktualisieren. Verwenden Sie negative Werte (z. B. -1), um Entfernung anzuzeigen. Wenn weggelassen, wird die Methode standardmäßig auf 1 gesetzt.

trackCategoryView

Die Methode trackCategoryView() wird bei jedem Seitenabruf einer Kategorie während einer Sitzung ausgeführt.

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);
}

Arguments

Name	Type	Description
categoryID	String	Eindeutige Kategorikennung. Dieses Feld ist erforderlich.

trackProductView

Die Methode trackProductView() wird für jeden Produktaufruf während einer Sitzung ausgeführt. Diese Methode ermöglicht es Kameleoon, einen automatisierten Produktkatalog ohne XML-Feed-Integration zu erstellen, was die Einrichtung von Produktempfehlungsprojekten vereinfacht.

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"
        }
    ]
});

Arguments

Name	Type	Description
productID	String	Produktkennung. Verwenden Sie einen eindeutigen Wert, der dieses Produkt identifiziert. Dieses Feld ist erforderlich.
productData	Object	Product-Objekt. Dieses Feld ist erforderlich, um Produkt-Feeds über das Add-on Product Recommendation zu importieren.

trackSearchQuery

The trackSearchQuery() method records user search queries.

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

Arguments

Name	Type	Description
search_query	String	Der Suchabfragewert. Dieses Feld ist erforderlich.

trackTransaction

The trackTransaction() method executes wenn a transaction or purchase occurs.

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

Arguments

Name	Type	Description
products	Array	Liste von Objekten, die `productID` und `quantity` für jedes Produkt in der Transaktion enthalten. Dieses Feld ist erforderlich.
params	Object	Zusätzliche Parameter für die Empfehlungsplattform. Dieses Feld ist optional.

Zusätzliche Parameter für trackTransaction

Name	Type	Description
order	string	Bestellnummer des Geschäfts. Wenn Sie diese weglassen, verwendet die Engine ein internes Nummerierungssystem, das die Bestellstatusverwaltung verhindert. Siehe die Parameterbeschreibungen unten.
order_price	Number	Endgültige Bestellkosten, einschließlich Rabatte, Boni und zusätzliche Services. Wenn Sie dies auslassen, berechnet die Engine die Kosten aus der Produktdatenbank ohne Rabatte oder Services.
email	string	Customer email.
phone	string	Customer phone number.
promocode	string	Transaction promo code.
order_cash	number	Cash payment amount.
order_bonuses	number	Bonus payment amount.
order_delivery	number	Delivery fee.
order_discount	number	Order discount amount.
delivery_type	string	Delivery method.
payment_type	string	Payment type (e.g., “cash”, “card”, “wire”).
tax_free	boolean	Tax-free status.

APIs

​trackAddToCart

​Parameter für die Empfehlungsplattform

​trackAddToWishList

​trackCategoryView

​trackProductView

​trackSearchQuery

​trackTransaction

​Zusätzliche Parameter für trackTransaction

trackAddToCart

Parameter für die Empfehlungsplattform

trackAddToWishList

trackCategoryView

trackProductView

trackSearchQuery

trackTransaction

Zusätzliche Parameter für trackTransaction