Shopware 5
- 16 Jan 2025
- DarkLight
Shopware 5
- Updated on 16 Jan 2025
- DarkLight
Article summary
Did you find this summary helpful?
Thank you for your feedback
Compatibility Notice
The Awin extension has only been validated with standard Shopware themes. We provide no guarantee that the extension will be compatible with other themes.
Supported Tracking Types & Features
Method and feature support notes are based on the latest available extension version. If a feature is not present on your shop, please ensure you have updated the Awin extension.
Each of these tracking methods is required for compliance with our Tracking Policy. To review the Awin Tracking Policy, please reach out to your Awin point-of-contact.
✅ Conversion Tag
✅ Fall-back Conversion Pixel
✅ Server-to-Server (S2S)
✅ Deduplication
✅ Consent Signals
Installation and Configuration
The most efficient way to integrate Awin’s tracking with your site is to use our Shopware extension. Please find the extensions in .zip file format for the supported Shopware 5 versions below.
Shopware versions 5.6.8 - 5.6.10
Shopware versions 5.7.1 - 5.7.3
Shopware versions 5.7.3 - 5.7.18
The Awin extension includes our Hybrid tracking solution with its benefits. The extension will trigger the tracking tags on order confirmation pages and the tracking tags will include all aspects of tracking, including client-side conversion tags, fallback image pixel, server-to-server tracking, and the Awin Mastertag on all pages.
Installation
Please download the extension .zip file for your Shopware version from the banner above, and continue with the steps below.
Step One: Open Plugin Manager
.png)
Step Two: Go to Installed Plugins
.png)
Step Three: Click Upload Plugin
.png)
Step Four: Select and upload the Awin plugin
.png)
Step Five: Click on Install in the lower pane
.png)
Step Six: Activate the plugin
.png)
Reset cache for immediate effect
.png)
Step Seven: Configure the plugin with your Awin Advertiser/Merchant ID (you can find this by logging onto your Awin account and clicking on Account > Overview, where the ID will be shown underneath your account name).
.png)
Step Eight: Close Awin Plugin configuration
.png)
Step Nine: Plugin is now shown as installed in the upper pane
.png)
The Awin tracking extension should now be fully configured and you can move on to testing the tracking.
Stuck? Check out our Shopware Integration video tutorial:
Tracking Features
The extension utilizes the source query parameter from the landing page URL and passes this value along to the channel parameter of our tracking request for deduplication purposes.
It is important to note that only the source query parameter will be used for deduplication, not the more commonly used utm_source parameter. You should ensure that the source parameter is correctly configured for your program. Your Awin point of contact can assist you with changes to this configuration.
To implement this on Awin’s side, a source=aw query parameter will be appended as standard with Shopware extension setups under Default Query String Append in the Tracking Settings.
Additionally, the extension creates a cookie named source to store the value of the source parameter. This value will update accordingly each time the value of this parameter changes in the URL.
If you are configuring other channels, please ensure that they’re reporting to the
sourceparameter with the proper value. (e.g. source=email, source=fb, source=na, etc.)
Product Level Tracking (PLT) information is sent via the extension’s tracking tags and follows the default format of an Awin PLT dataset:
AW:P|{{advertiserId}}|{{orderReference}}|{{productId}}|{{productName}}|{{productItemPrice}}|{{productQuantity}}|{{productSku}}|{{commissionGroupCode}}|{{productCategory}}Shopware extension v1.1.5 and above supports Awin Consent Signals to use third party consent tools. Built-in Shopware consent management works with the Shopware extension out-of-the-box, starting from this version.
Whenever a custom consent management solution is used, please also see more information on Consent Framework.
Testing your Tracking
Please see our article on testing your Integration for further instruction.
Was this article helpful?