LightSpeed (C-Series)

This is the documentation to install Kelkoo Sales tracking for Lightspeed C-series.

Before setting up your Kelkoo Sales Tracking Tag

Get your merchantId

See How To get your merchantId

Remove Previous Installations

If your website already includes an older version of Kelkoo Sales Tracking, remove it before installing the tags below. See Remove Previous Installations of Kelkoo Sales Tracking for what to look for and why this matters.

Installing Kelkoo Sales Tracking

1. Login to your Lightspeed Account.

2. On the left side menu, click on 'Web Extras'.

Lead Tag

3. Click on Custom JavaScript and add the Lead Tag in the text area.

   HTML

   <script async="true" type="text/javascript" src="https://s.kk-resources.com/leadtag.js" ></script>
   

Conversion Tag

4. Copy the code below and replace the MERCHANT_ID with the one associated to your campaign in the Conversion Tag.

   JavaScript

   <script type="text/javascript">
       window._kkstrack = {
           merchantInfo: [{
               merchantId: 'MERCHANT_ID'
           }],
           orderValue: '{{ order.information.price_incl | escape('js') }}',
           orderId: '{{ order.information.number | escape('js') }}',
           basket: [
               {% for product in order.products %}
               {
                   productid: '{{ product.product_id | escape('js') }}',
                   productname: '{{ product.title | escape('js') }}',
                   price: '{{ product.base_price_incl | number_format(2, '.', '') | escape('js') }}',
                   quantity: '{{ product.quantity | escape('js') }}'
               }{% if not loop.last %},{% endif %}
               {% endfor %}
           ],
   
           // All fields below are OPTIONAL. Uncomment those you need.
           // Keep a comma between properties when enabling multiple fields.
           // Use escape('js') for any dynamic template values.
           // coupon: 'COUPON_CODE',
           // returningUser: 'RETURNING_USER',
           // currency: 'CURRENCY',
           // vatAmount: 'VAT_AMOUNT',
           // shippingCost: 'SHIPPING_COST',
           // affiliation: 'AFFILIATION',
           // discountAmount: 'DISCOUNT_AMOUNT',
           // paymentStatus: 'PAYMENT_STATUS',
           // customerLifetimeValue: 'CUSTOMER_LIFETIME_VALUE'
       };
   
       (function () {
           var script = document.createElement('script');
           script.async = true;
           script.src = 'https://s.kk-resources.com/ks.js';
           document.head.appendChild(script);
       })();
   </script>
   

5. Click on Tracking Code and add the Conversion Tag.

6. 

   Save the changes.

Optional fields

None of the fields commented out in the code sample above are required for Kelkoo Sales Tracking to work — a sale will still be tracked without them. We strongly encourage you to populate as many as you can, since they directly improve how we optimise your campaigns. For why each field matters, see Why these optional fields matter.

Configure your Consent Management Platform (CMP)

Kelkoo Sales Tracking relies on two tags with different consent requirements — the Lead Tag must be gated behind user consent, while the Conversion Tag should not be blocked by a missing consent signal, or your sales will be under-reported.

See Configuring Consent Management (CMP) for full setup and verification instructions.

Test your setup

Please check Test your Kelkoo Sales Tracking setup