Implementing Nosto
Adding the Order Tagging
All thank-you and order-confirmation pages must have the conversion tracking markup.
The conversion metadata is used for sending personalised order-followup emails, personalise the recommendations e.g. order-related, for segmentation insights and conversion statistics.
1
<div class="nosto_page_type" style="display:none">order</div>
2
<div class="nosto_purchase_order" style="display:none">
3
<span class="order_number">1445</span>
4
​
5
<div class="buyer">
6
<span class="email">[email protected]</span>
7
<span class="first_name">John</span>
8
<span class="last_name">Doe</span>
9
<span class="marketing_permission">false</span>
10
</div>
11
​
12
<span class="payment_provider">checkmo</span>
13
<span class="order_status_code">pending</span>
14
​
15
<div class="purchased_items">
16
<div class="line_item">
17
<span class="product_id">Canoe123</span>
18
<span class="quantity">1</span>
19
<span class="name">Acme Canoe</span>
20
<span class="unit_price">999.00</span>
21
<span class="price_currency_code">EUR</span>
22
</div>
23
​
24
<div class="line_item">
25
<span class="product_id">Canoe245</span>
26
<span class="quantity">3</span>
27
<span class="name">Acme Large Canoe</span>
28
<span class="unit_price">19.00</span>
29
<span class="price_currency_code">EUR</span>
30
</div>
31
</div>
32
</div>
Copied!
Note: The product ID of the product tagging, cart tagging and order tagging must match. Failure to do so will lead to a mismatch in both attribution and statistics across the Nosto product.
Tagging the buyer
You can omit the buyer tagging either partially, or completely if you do not want Nosto to crawl this information. The user details are stored for possible marketing purposes and mainly observed email address is used in this context. Marketing permission is false by default but if this user has explicitly agreed to receive marketing then you can set it to true manually.
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 payment provider
Payment provider is the payment method or provider used by a shopper to pay the purchase. Omit the payment provider detail if you do not want Nosto to crawl this information.
Tagging the order status code
Status code will be used to track the order state. Different payment providers may use different status codes.
Adding support for advanced use cases
Many ecommerce 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​
Troubleshooting order tagging:
Once included on all pages, you can review if the site is transmitting data using the Nosto Debug Toolbar. If you can see order contents being picked up under "Tagging" → "Order" then the order details are correctly set up in the source code.
You can further verify your session in the Nosto admin by using the live feed under: https://my.nosto.com/admin/$accountID/liveFeed to see if Nosto correctly picks up product view → product carted → product bought events. You can export all the order history from the store under Settings → Other → Order report under https://my.nosto.com/admin/$account/account/orders/report​
​
​
Last modified 2yr ago