Contents x
    Shopware 6
    • 12 Feb 2025
    • Dark
      Light
    Contents

    Shopware 6

    • Updated on 12 Feb 2025
    • Dark
      Light
    Article summary

    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.

    ✅ Mastertag

    ✅ Conversion Tag

    ✅ Fall-back Conversion Pixel

    ✅ Server-to-Server (S2S)

    ✅ Product Level Tracking (PLT)

    ✅ 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 Awin extension on the Shopware store.

    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 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.

    Step Two: Click on the Upload Extension button at the top right corner and select the Awin plugin file from your computer.

    Step Three: After the plugin is uploaded, you will 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 will see a green check mark and an Activate button. Click on the Activate button to enable the plugin.

    Step Five: After the plugin is activated, you will see a Configure button in the lower pane of the plugin card. Click on the Configure button to open the plugin settings.

    Step Six: In the plugin settings, you will need to enter your Awin Advertiser/Merchant ID in the Awin ID field. 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. Click on the Save button to apply the changes.

    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 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 source parameter 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.9.0 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 it is needed to categorise the Awin cookies as ‘Marketing’.

    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?
    What's Next

    © 2024, AWIN Ltd. All rights reserved. Awin is part of Axel Springer Group. No part of this publication may be reproduced, translated, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, photocopying, recording or otherwise, without the prior permission of the copyright owner.