Compatibility notice
The Awin extension has been validated only with standard Shopware themes. We provide no guarantee that the extension will be compatible with other themes.
Supported tracking types and features
Method and feature support notes are based on the latest available extension version. If a feature isn’t present on your shop, please ensure you have updated the Awin extension.
All of these tracking methods are included within the Shopware extension, meaning full compliance with our Awin Tracking Policy. To review the Awin Tracking Policy, please reach out to your Awin point of contact.
✅ Conversion tag
✅ Fallback conversion pixel
✅ Server-to-server (S2S)
✅ Deduplication
✅ Consent signals
Installation and configuration
Note
Current extension version: 1.1.5, compatible with Shopware versions 6.6.0.0 - 6.7.11.0.
The most efficient way to integrate Awin’s tracking with your site is to use our Shopware extension, which you can find in the Shopware store.
The Awin extension includes our hybrid tracking solution and its associated benefits. The extension will trigger the tracking tags on order confirmation pages and the tracking tags will include all aspects of tracking. This includes client-side conversion tags, fallback image pixel, server-to-server tracking, and the Awin MasterTag on all pages.
Installation
Please download the extension file from the Shopware store, and continue with the steps below.
Step one: Log in to your Shopware admin panel and navigate to Settings > System > Plugins > My Extensions.
.png)
Step two: Click on the Upload extension button in the top right corner and select the Awin plugin file from your device.
.png)
Step three: After the plugin is uploaded, you’ll see it in the list of available extensions. Click on the Install button in the lower pane of the plugin card.
Step four: Once the plugin is installed, you’ll see a green check mark and an Activate button. Click on it to enable the plugin.
Step five: After the plugin is activated, you’ll see a Configure button in the lower pane of the plugin card. Click on it to open the plugin settings.
.png)
Step six: In the plugin settings, you need to enter your Awin Advertiser/Merchant ID in the Awin ID field. You can find this in the platform under Program profile. Click on the Save button to apply the changes.
.png)
After installing the plugin, please provide your Awin Advertiser ID in the configuration section. The Awin tracking extension should now be fully configured and you can move on to testing the tracking.
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’s 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.
Important
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}}The Shopware extension for 6.5.0.0 - 6.6.10.2 versions 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. For this functionality, Awin cookies need to be categorized as Marketing.
In addition, the Shopware extension natively supports Usercentrics CMP. When using Usercentrics instead of Shopware’s built-in CMP, you can now run Awin tracking in a GDPR-compliant way, as the Awin consent signals are set on base of the Usercentrics consent status. The CMP can be selected in the extension settings, and the Usercentrics Settings ID will need to be added to make use of the feature..png)
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.
FAQ
Are the tracking amounts including or excluding tax and delivery costs?
By default, the Shopware extension excludes both taxes and delivery costs in the tracked transactions amounts. Commissions will therefore be applied on base of the amounts excluding taxes and delivery costs. For further information or guidance, please reach out to your Awin technical point of contact.