Managing the Cart

This page describes some helpful Javascript functions that allow you to manage the cart.

Reload Cart

This function replaces the cart in Nosto with the cart contents from Shopify and then loads recommendations. This can be useful if you have an Add to Cart button that adds a product to cart via AJAX and you want to subsequently show cart-based recommendations.

Nosto.reloadCart()

Additionally, if event tracking for this call needs to be disabled, you can call the below function instead and pass in the skipEvents: true flag. This is particularly helpful in cases where other recommendations on the page should reflect cart content when the cart is changed without explicitly counting it as an additional page load. By default, the skipPageViews flag is true for both cases.

Nosto.reloadCartWithFlags({ skipEvents: true })

Add Recommended Products to Cart

Nosto supports a quick-buy function straight from within its recommendations. This feature will be referred to as the add-to-cart feature henceforth.

Note: The function definition is a part of the app and is automatically added to all pages. You do not need to define the function or include any additional scripts.

In order to do this, you two arguments must be passed to the Nosto.addSkuToCart method.

The first argument is a javascript object containing the id of the configurable product and the variation, and the second one is the resultId value from the response of the ev1 request that rendered the product . If configurable product's id is 123, the id of the variation is 124 and the resultId is frontpage-nosto-1 , the method call in recommendations template would look like this,

Nosto.addSkuToCart({productId: '123', skuId: '124'}, 'frontpage-nosto-1')

Leveraging Quantities

It is possible to specify the quantity when adding products to cart. The second parameter (productpage-nosto-1) is the resultId value form the ev1 response.

Nosto.addSkuToCart({productId: '425', skuId: '310'}, 'productpage-nosto-1', 5)

Adding Multiple Products

It is also possible to add multiple products to the cart by using an array of objects containing the productId, skuId and quantity. The product id is the parent product that holds the variations, and the SKU is the variation itself. The parent id is needed in order to recognize which product was added and improve the recommendations. Note that if you use a configurable product as SKU ID, will simply not be added to the cart, since you need to select the options.

Nosto.addMultipleProductsToCart(
    [
        {productId:"1234", skuId:"4321", quantity: 1},
        {productId:"345", skuId:"543", quantity: 1}
    ], 
    'categorypage-nosto-1' 
)

Use Cases

A common way to implement the functionality to add a variation directly to cart is to implement drop down of available variations for recommended products. The selected variation id is then picked up from the drop down and passed to the Nosto.addSkuToCart method. An example implementation can be found below.

#if($product.skus.size() > 0)
  <div class="nosto-sku-select-wrapper">
    <label class="nosto-sku-select">
      <select onChange="document.getElementById('selected_sku').value = this.value">
        <option value="">Choose</option>
          #foreach($sku in $product.skus)
            <option value="$!sku.id">
              #foreach($attr in $sku.customFields)
                $!attr.key: $!attr.value
              #end
            </option>
          #end
      </select>
    </label>
  </div>
  <button onclick="Nosto.addSkuToCart({productId: '$!product.productId', skuId: document.getElementById('selected_sku').value}, '$!product.attributionKey'); return false;" class="nosto-btn">
    <img src="$!props.display.buyButtonIcon.url" width="15" height="15">
  </button>
#end

Below is the example of how to add an SKU to cart where your product has a single SKU or you want to simply add the product's first SKU to cart instead of allowing the user to select which SKU to add.

<a
  href="#"
  onclick="window.Nosto.addProductToCart('$!product.lastPathOfProductUrl()', '$!product.attributionKey');">
  Add to Cart
</a>

Migrating from the Legacy approach

The older approach of APIs required this object representing the element that triggered the API call. For example, in the below example, addSkuToCart api takes this object as second parameter. Nosto internally extracted the resultId from the object.

Nosto.addSkuToCart({productId: '123', skuId: '124'}, this)

With the newer approach, the addSkuToCart api has been updated to accept the resultId directly to improve effectiveness of the api and at the same time ensures proper attribution.

Nosto.addSkuToCart({productId: '123', skuId: '124'}, 'productpage-nosto-1')

Similarly, the second parameter for addProductToCart and addMultipleProductsToCart APIs can be updated to send the resultId value instead of the this object

Nosto.addProductToCart('$!product.lastPathOfProductUrl()', 'productpage-nosto-1')

Nosto.addMultipleProductsToCart(
    [
        {productId:"1234", skuId:"4321", quantity: 1},
        {productId:"345", skuId:"543", quantity: 1}
    ], 
    'categorypage-nosto-1' 
)

When invoking these APIs from Nosto's recommendation template, use the $!product.attributionKey context value to send the resultId instead of the this object