Shopware 5

After you’ve downloaded the appropriate extension version for your Shopware installation, please proceed with the following steps.

Step one: Open Plugin Manager.

Step two: Go to Installed Plugins.

Step three: Click Upload Plugin.

Step four: Select and upload the Awin plugin.

Step five: Click on Install in the lower pane.

Step six: Activate the plugin.

Reset cache for immediate effect

Step seven: Configure the plugin with your Awin Advertiser/Merchant ID (you can find this in the platform under Program profile).

Step eight: Close Awin Plugin configuration.

Step nine: Plugin is now shown as installed in the upper pane.

The Awin tracking extension should now be fully configured and you can move on to testing the tracking.

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 module 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 source parameter with the proper value (e.g., source=email, source=fb, source=na, etc.).

Example

www.yourdomain.com?utm_source=facebook&utm_medium=social&source=na

The Awin module reads the source query parameter from the landing page URL and uses its value for last-click attribution. In this example, the value na indicates that the last click originated from a non-Awin channel. Where a transaction is attributed to a non-Awin channel, no Awin commission is awarded, regardless of whether an Awin affiliate click was previously recorded.

The presence of the source query parameter typically doesn’t impact reporting in analytics platforms such as Google Analytics or other reporting tools. In most cases, traffic source reporting is based on standard UTM parameters (for example, utm_source, utm_medium, and utm_campaign), whereas the source parameter is used specifically for attribution purposes within the Awin deduplication process.

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 read our guide on consent framework.