Manual installation for Kelkoo Sales Tracking

Overview

Use this installation method if you are not using Google Tag Manager (GTM) or if you prefer to integrate Kelkoo Sales Tracking directly into your website's source code.

This guide explains how to manually install the two tags required for Kelkoo Sales Tracking:

• Lead Tag – sets a first-party tracking cookie when a user visits your website.

• Conversion Tag – reads the tracking cookie and sends completed order information to Kelkoo.

Important

Both the Lead Tag and the Conversion Tag must be installed. Without both tags, Kelkoo Sales Tracking cannot correctly attribute conversions.

Before You Begin

Before installing the tags, make sure you have:

• Access to your website's source code.

• Your Merchant ID and Country Code.

• Access to the order confirmation (thank-you) page.

Find Your Merchant ID and Country Code

Log in to your Kelkoo Merchant Portal and retrieve your Merchant ID and associated Country Code.

These values are required when configuring both tracking tags.

Remove Previous Installations

If your website already includes an older version of Kelkoo Sales Tracking, remove it before installing the new tags (search for leadtag.js and _kkstrack).

Running multiple versions of the tracking code may result in duplicate or incorrect conversion tracking.

Step 1 - Install Lead tag

The Lead Tag sets the first-party tracking cookie used to attribute future conversions.

Add the following script to every page of your website, immediately before the closing </head> tag.

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

Once installed, the Lead Tag will automatically create the tracking cookie for eligible visitors.

Step 2 – Install the Conversion Tag

The Conversion Tag sends completed order information to Kelkoo.

Add the following script to your order confirmation (thank-you) page, immediately before the closing </body> tag.

<script type="text/javascript">
    _kkstrack = {
      merchantInfo : [{ country:'COUNTRY_CODE', merchantId:'MERCHANTID_VALUE' }],
      orderValue: 'ORDER_VALUE',
      orderId: 'ORDER_ID',
      basket:  [{ productname: 'name of product 1',
                 productid: '11111',
                 quantity: '1',
                 price: '4.2'
                },
                { productname: 'name of product 2',
                 productid: '22222',
                 quantity: '3',
                 price: '8.6'
                }
               ]
    };
    (function() {
      var s = document.createElement('script');
      s.type = 'text/javascript';
      s.async = true;
      s.src = 'https://s.kk-resources.com/ks.js';
      var x = document.getElementsByTagName('script')[0];
      x.parentNode.insertBefore(s, x);
    })();
</script>

Configure the Conversion Tag

Replace the placeholder values in the Conversion Tag with values from your website.

Some values remain the same for every order, while others must be populated dynamically.

Configuration Values

The following values are fixed and can be hard-coded in your implementation.

Order-Specific Values

The following values must be populated dynamically for every completed order.

Your website must provide the actual values for each completed order.

Note

This step requires access to your website's order data. The implementation depends on your platform and programming language. If you're unsure how to retrieve these values, contact your developer or technical team.

If you have multiple merchantIds and countries

If you run several Kelkoo Group campaigns for the same website, each with a different Merchant ID and/or Country Code, you can configure them all within the same tag.

Add one entry to the merchantInfo array for each campaign:

merchantInfo : [
  {
    country:'fr',
    merchantId:'12941513'
  },
  {
    country:'uk',
    merchantId:'56789'
  }
]

Consent Management (CMP)

If your website uses a Consent Management Platform (CMP), configure it so that Kelkoo's tracking tags run only after the required user consent has been obtained.

Incorrect CMP configuration may prevent conversions from being attributed correctly.

Verify Your Installation

After completing the installation, verify that both tags are working correctly.

Follow the Test Your Kelkoo Sales Tracking Setup guide to confirm that:

• the Lead Tag is loaded on all pages;

• the Conversion Tag is triggered on the order confirmation page;

• the tracking cookie is created correctly;

• conversions are successfully recorded by Kelkoo.

Troubleshooting

If conversions are not being tracked correctly, check the following:

• Both tags are installed.

• Only one version of the tracking code is present.

• The Lead Tag loads before the Conversion Tag.

• Dynamic order values are correctly populated.

• Your CMP allows the tags to run after consent is granted.

• The browser console does not report any JavaScript errors.

If the issue persists, contact Kelkoo Support and include:

• your Merchant ID;

• the URL of your order confirmation page (if accessible);

• screenshots or browser console logs where possible.