Google Tag Manager is often blocked by ad blockers. We strongly recommend using a plugin or direct integration instead, as 5%–10% of traffic may be lost otherwise. Alternative Integration Methods:
This comprehensive guide explains how to set up and implement Sovendus on your website using Google Tag Manager, as an alternative to direct code integration.
What You'll Accomplish
By following this guide, you'll successfully integrate Sovendus Voucher Network and/or Checkout Benefits into your website using Google Tag Manager. Integration Checklist:
Install the Sovendus GTM tag on your website
Configure tag parameters and triggers
Add div container for Sovendus offers display
Test the integration thoroughly
Deploy to production
📋 Complete Step-by-Step Guide
Step 1 – 🚀 Access Google Tag Manager
Getting Started with GTM
Log in to the GTM account for the site where you want to implement Sovendus.
Quick Steps:
Navigate to the Tags section
Click New to add a new tag
Give your tag a descriptive name (e.g., "Sovendus Integration")
Step 2 – 🔍 Find and Install the Sovendus Template
Template Installation Process
Follow these steps to locate and install the official Sovendus template from the GTM gallery.
Step 2.1: Open Tag Configuration
Click on Tag Configuration to open the tag type selector.
Step 2.2: Access Template Gallery
Click on Discover more tag types... to browse the community template gallery.
Step 2.3: Search for Sovendus
Search for Sovendus and select Sovendus Integration .
Step 2.4: Confirm Installation
Click Choose template to add it to your GTM container.
Step 3 – ⚙️ Configure Your Sovendus Tag
Configuration Overview
Configure your Sovendus tag with the traffic source and medium numbers provided by your account manager. Choose between single or multi-country setup based on your needs.
🌍 Option A: Single Country/Language Configuration
Simple Setup for Single Market
Perfect for websites operating in one country or language. Simply enter your Sovendus identifiers directly.
Configuration Steps:
Enter your Traffic Source Number (provided by Sovendus)
Enter your Traffic Medium Number (provided by Sovendus)
Verify the numbers match what you received from your account manager
🌐 Option B: Multi-Country/Language Configuration
Advanced Configuration Required
For websites serving multiple countries or languages, you'll need to create GTM variables that dynamically return the correct identifiers.
Create Variables in GTM:
Navigate to Variables section in GTM
Create variables that return appropriate numbers per locale
Variables should return empty string if country/language not supported
Variable Creation Methods:
URL-based detection (e.g., /en/, /de/, /fr/)
Data layer variables from your website
Custom JavaScript variables
Lookup tables based on domain or subdomain
Implementation Example:
Step 4 – 🎯 Select Your Sovendus Products
Product Selection Guide
Choose the Sovendus products you want to integrate. Each product requires different order and customer data parameters.
Available Products:
Voucher Network - Display relevant vouchers and offers to customers
Checkout Benefits - Show exclusive benefits during checkout process
Ensure your data layer contains the required order and customer information before configuring variables. If they don't exist, add them to your website's data layer implementation.
For detailed parameter descriptions, data types, required vs optional fields, and implementation examples, see the comprehensive Sovendus Parameter Guide .
Order Data Configuration
Map your order data from the data layer to these Sovendus parameters (order ID, value, currency, session ID, coupon code).
Customer Data Configuration
Map your customer data from the data layer to these Sovendus parameters (name, email, address fields for personalization).
Step 6 – 📍 Create the Sovendus Display Container
Container Placement
The position of this container doesn't affect the placement of the Sovendus sticky banner and overlay variants if you're using one.
When is the container required?
The container is only required when one of the following is true for you:
you are using an inline/embedded version of our banner or product list
you are using a SPA (single page app - e.g. react, angular, vue, etc.) as the existence of this container will trigger the sovendus overlay removal process
Container ID Must Match
The div container ID must exactly match the iframeContainerId value in your Sovendus tag configuration. Mismatched IDs will prevent the integration from working.
🎯 Choose Your Container Setup Method
Container Placement Options
You have two options for adding the Sovendus container to your thank-you page. Choose the method that best fits your technical setup.
🔧 Option A: Direct HTML Integration
Manual HTML Implementation
Add the container directly to your thank-you page HTML. This method provides the most control over placement.
Implementation Methods:
Edit your thank-you page template directly
Use your CMS or page builder's custom HTML feature
Create the container using Google Tag Manager's Custom HTML tag. This method is useful when you can't directly edit your thank-you page HTML. Create New Tag:
Navigate to Tags section in GTM
Click New button
Name the tag (e.g., "Sovendus Container")
Configure Custom HTML:
Click Tag Configuration
Search for Custom HTML and select it
Add Container HTML:
Paste the following HTML code into the HTML field
Step 7 – Create and Set a Trigger
If you don’t already have a trigger for your Thank-you page, follow these steps (You can skip this steps if you already have a thank-you page trigger and go to the assign steps below):
1. Click on the Triggers tab in the left menu
2. Click New to create a new trigger
3. Name your trigger (e.g., "Thank-you Page Trigger")
4. Under Trigger Configuration, select Page View
5. Under This trigger fires on, select Some Page Views
6. In the Fire this trigger on section, specify the conditions that will cause the trigger to fire. In this case, you will want to select Page Path from the dropdown menu and set the contains operator.
Then, enter the page path of your thank-you page in the value field. For example, if your
thank-you page is at example.com/thank-you, you would enter /thank-you in the value field.
7. Click Save to create the trigger. Now, any Google Tag Manager tags that are associated
with this trigger will fire on the thank-you page whenever the trigger conditions are met.
Now assign this trigger to your HTML tag containing the Sovendus container:
Final Check
After completing the steps above:
Make sure the id of the div container on your Thank-you page exactly matches the iframeContainerId value in your Sovendus tag configuration.
You should now have successfully integrated Sovendus into your website using Google Tag Manager.
Test Your Integration Before Publishing
Before publishing the changes you made in Google Tag Manager, you should test the integration to ensure that the Sovendus banner is correctly displayed on your Thank-you page.
If you're operating in Switzerland, you must add an additional landing page script to ensure proper compliance and attribution tracking. Why is this required?
Provides proper attribution tracking for Swiss traffic
Required for all Swiss Sovendus integrations
Ensures optimal performance of the Sovendus integration in Switzerland
🏔️ Swiss Landing Page Script Setup
Step-by-Step Implementation
Follow these detailed steps to add the required Swiss landing page script to your GTM setup.
Step 1: Create New Custom HTML Tag
Navigate to Tags section in GTM
Click New button
Name the tag "Sovendus Swiss Landing Script"
Click Tag Configuration
Search for and select Custom HTML
Step 2: Add Swiss Landing Script Code
Copy and paste this exact code into the HTML field:
You have two options for configuring the landing page trigger based on your needs:
🌐 Option A - All Pages Trigger (Recommended)
Universal Landing Page Setup
This option fires the script on all pages of your website, which is the simplest and most reliable approach.
Configuration Steps:
Create a new trigger using the process from Step 7
Name it "Swiss Landing - All Pages"
Under Trigger Configuration, select Page View
Under This trigger fires on, select All Page Views
Click Save to create the trigger
🎯 Option B - Specific Campaign Pages Trigger
Targeted Landing Page Setup
Use this option if you want to limit the script to specific landing pages or campaign pages only.
Step 1: Create New Trigger
Create a new trigger using the process from Step 7
Name it "Swiss Landing - Campaign Pages"
Step 2: Configure Trigger Type
Under Trigger Configuration, select Page View
Under This trigger fires on, select Some Page Views
Step 3: Set Page Conditions
Set conditions for your specific pages:
Page Path contains /campaign/
Page Path contains /landing/
Page Path equals / (for homepage)
Step 4: Finalize Configuration
Add multiple conditions as needed for your landing pages
Click Save to create the trigger
📞 Need Support?
Contact your Sovendus account manager if you encounter any issues or need assistance with the integration.
You can use a custom JavaScript variable to determine the correct traffic source number based on the URL path.
// Example: URL-based country detectionfunction(){var path ={{PagePath}};switch(true){case path.indexOf('/de/')===0:return'12345';// German traffic sourcecase path.indexOf('/fr/')===0:return'67890';// French traffic sourcedefault:return'';// In other cases, return empty string }}
<
!
--
the integration loads the content into
this
div element
--
>
<
/
div
>
Placement Tips:
Position after order confirmation details
Ensure adequate spacing from other elements
Consider mobile responsiveness
<
!
--
Sovendus
Container
--
>
<
div id
=
"sovendus-container-1"
>
<
!
--
the integration loads the content into
this
div element
--
>
<
/
div
>
Set Tag Sequencing:
In Tag Sequencing section, click Select a tag to fire before
Search for and select your Sovendus tag
This ensures the container loads before the Sovendus content
Create Variables in GTM:
Available Products:
Add Container HTML:
