Implementing Nosto
Default Product Tagging
Basic tagging
1
<div class="nosto_page_type" style="display:none">product</div>
2
<div class="nosto_product" style="display:none">
3
<span class="product_id">Canoe123</span>
4
<span class="name">Acme Canoe</span>
5
<span class="url">https://example.com/canoe123</span>
6
<span class="image_url">https://image.example.com/canoe1.jpg</span>
7
<span class="availability">InStock</span>
8
<span class="price">999.50</span>
9
<span class="price_currency_code">USD</span>
10
</div>
Copied!
Nosto also supports multiple optional values which may enrich the usage of the service, but are not required. These span elements should be inserted into the "nosto_product" parent container.
Tagging attribute extension
1
<span class="category">/Mens/Jackets</span>
2
<span class="category">/Mens/Jackets/Ski Jackets</span>
3
<span class="brand">Acme</span>
4
<span class="description">This is a great product!</span>
5
<span class="google_category">Interior > Towels</span>
6
<span class="list_price">1299.00</span>
7
<span class="tag1">sporty</span>
8
<span class="tag2">new-in</span>
9
<span class="tag3">limited-offer</span>
10
<span class="tag3">add-to-cart</span>
11
<span class="rating_value">3.8</span>
12
<span class="review_count">36</span>
13
<span class="alternate_image_url">https://image.example.com/canoe2.jpg</span>
14
<span class="alternate_image_url">https://image.example.com/canoe3.jpg</span>
15
<span class="custom_fields">
16
<span class="material">Cotton</span>
17
<span class="weather">Summer</span>
18
</span>
Copied!
Tagging the prices
Prices must always be denoted in a simple numerical form using dot as the decimal separator. For example,
1.234,45 is invalid while 1234.45 is valid.Tagging the categories
Categories must always be delimited by a slash. For example,
/Home/Accessories is a valid category while Home > Accessories is not.Tagging the currencies
Currencies should always be represented in the ISO-4471 three-letter format. For example, use the code
USD instead of $ to represent the United States Dollar.Tagging the availability
The availability of a product is represented by
InStock or http://schema.org/InStock for products that are in stock and saleable. For products that are out of stock or you don't want to be recommended, you can use OutOfStock or http://schema.org/OutOfStockTagging the Google Categories
The category of your item based on the Google product taxonomy. Use the schema provided by Google here (https://support.google.com/merchants/answer/6324436?hl=en)
Tagging the Rating
The rating of a product must be represented as a number between 0.0 and 5.0. For example, a product cannot be rated 9.1. You must normalize your rating value to fit our specified range.
Tagging the Tags and/or Custom fields
The three tag fields,
tags1, tags2 and tags3 are simply labels that can be used to annotate tags like discounted, limited collection or other use cases where you might want to filter your Nosto recommendations by certain product groupings.Custom fields accept a key:value pair where the
class of the attribute is the key. Common use cases are material, color or other similar unique identifiers.Fields that are not exposable in tagging
Nosto also supports two attributes that are not crawlable through tagging. This is due to the sensitive nature of the attributes. They are:
supplier_cost and inventory level. To send these two values to Nosto you will need to use the Products API.Adding support for advanced use cases
Many e-commerce stores utilize SKU:s or "child" products that are sorted under the same "parent" product. To extend the above example with SKU support refer to this article​
In cases where a product might have multiple prices in differing currencies, you can also add support for multi-currency. Refer to this article​
Supplier Cost / Margin Filter
If you want to use Nosto’s margin filter, you need to send supplier cost via API since it's a sensitive data that you might not want to expose in the product tagging.
Troubleshooting
Once included on all pages, you can review if the site is transmitting data using the Nosto Debug Toolbar. If you can see product attributes being picked up under "Tagging" then the product details are correctly set up. You can further verify that products are being indexed to the catalog under the Nosto admin by navigating to Tools → Products: https://my.nosto.com/admin/$accountID/campaigns/products/list​
Nosto debug toolbar / products
Nosto product catalogue
live-feed-product-view
Last modified 1yr ago
Copy link