Skip to main content

Setting up the Klar Pixel for Shopware 6

How to set up the Klar Pixel by adding the datasource, validating your domain, installing the Klar extension in Shopware, and adding URL parameters.

Written by Franz May

tl;dr

Setting up the Klar Pixel for Shopware 6 involves four steps:

  1. Add the Klar Pixel datasource in Klar and configure domain validation

  2. Validate your domain via two DNS records with your hosting provider

  3. Install the Klar extension in your Shopware 6 store and connect it to the pixel

  4. Add URL parameters to your ad accounts so conversions and costs can be matched

⚠️ Important: This guide uses the Klar Shopware extension together with Shopware's native consent manager. If you use a third-party consent tool (CookieBot, UserCentrics, etc.), use the Klar Pixel via Google Tag Manager instead.

If you have multiple Shopware 6 stores, create a separate Klar Pixel datasource for each.


To power our fully integrated attribution solution, you need to configure the Klar Pixel datasource in Klar and implement a tracking script on your site. This should only take a few minutes.

1️⃣ Add the Klar Pixel datasource

  1. In the left sidebar, go to Store ConfiguratorData Sources and click Add New Data Source

  2. Select Klar Pixel

  3. Enter a name (e.g. Klar Pixel DE)

  4. Select Other as your Shop System (Shopware 6 uses a custom frontend — do not select Shopify)

  5. Choose your tracking type:

    1. Domain Validated Pixel (recommended) — We strongly recommend using a domain-validated tracking script as these cannot be blocked by the browser

    2. Basic Tracking Script — a third-party script, simpler to set up but less accurate

  6. If you selected Domain Validated Pixel, enter your domain (exclude https:// and www.), then click Configure

  7. If you selected Basic Tracking Script, skip ahead to Step 3


2️⃣ Validate your domain (Domain Validated only)

Klar provides two DNS records to copy and paste into your hosting provider's DNS settings.

⚠️ WebGo, All Inkl, Strato users: When adding the records, remove your domain from the Name field. Only enter the numeric prefix.

Correct format:

Record type

Wrong ❌

Correct ✅

CNAME

3450072213.yourshop.com

3450072213

CNAME IPv4

3450072213-4.yourshop.com

3450072213-4

  1. Copy and paste both DNS records using the copy icon next to each field

  2. Click Validate DNS Records

⚠️ Note: DNS propagation can take a few hours to 2 days. Once verified, a green check icon appears next to each record. If you need help, reach out via the support chat — we're happy to assist.

Once both records are validated, the Tracking Script and your Pixel Domain appear in the datasource. Keep this tab open — you'll need the Pixel Domain in Step 3.


3️⃣ Install the Klar extension in Shopware 6

This only applies to you if you're using the Shopware 6 consent manager. If you're using any other consent management provider such as CookieBot, UserCentrics etc. you need to setup the Klar Pixel via Google Tag Manager.

  1. Download the Klar Shopware 6 extension: Download Klar Pixel Attribution extension (.zip)

  2. In your Shopware 6 Admin, go to ExtensionsMy Extensions (Shopware guide: My Extensions)

  3. Click Upload Extension and upload the .zip file you downloaded

  4. Activate the Klar Pixel extension

  5. Go back to KlarStore ConfiguratorData Sources → open your Klar Pixel datasource → copy the Pixel Domain (the highlighted part of the tracking script URL)

  6. In your Shopware 6 Admin, open the Klar Pixel extension settings and paste the Pixel Domain into the Klar Pixel Domain field

  7. 🚨 Rebuild your Shopware 6 storefront. This step is required — without it the extension will not be active. Log in to your server via SSH and run:

bin/build-storefront.sh

4️⃣ Add the Data Privacy snippet

Add the Klar Data Privacy snippet to your privacy policy. You'll find a German and English version inside the Klar Pixel datasource under the Data Protection Snippet section.


5️⃣ Implementing Klar URL Parameters

To ensure that conversions and costs can be matched as accurately as possible, you need to implement the pre-defined Klar tracking codes in your ad accounts.

Here are guides on how to do that for each marketing channel:


What happens next?

From now on, Klar tracks visitors and purchase activity on your Shopware 6 store. Data will appear in your Attribution reports from the next day onwards — historical data before the script was added is not available.

🎉 Your Klar Pixel is live — you're ready to start using the Attribution reports!

Did this answer your question?