Installation instructions
Please refer to the documentation for each plugin to configure the plugin:
Selection of tracking providers
The extension offers five separate tracking providers (Meta, Google, Reddit, Pinterest and Microsoft Advertising/Bing), each of which can be purchased and configured independently via in-app purchases. All settings can be configured on a sales channel-by-channel basis or for all sales channels simultaneously.
Meta Pixel
This provider must be activated separately via an in-app purchase.
- Activate Meta Pixel - Switch to activate/deactivate the meta pixel
- Meta Pixel ID - Enter the Meta Pixel ID
- Conversion API Access Token - Token for server-side transmission via Conversion API
- Activate Conversion API - Activates server-side event tracking via the Facebook Conversion API to improve data quality
- Deactivate user data in Conversion API - Suppresses the transmission of user data to the Conversion API
- Activate asynchronous conversion API - Uses the Symfony Messenger for asynchronous processing of API calls
- Activate Conversion API logging - Logs the conversion API calls for debugging purposes
- Activate debug mode - Activates debug mode for the pixel
- Activate Meta Automatic Configuration (auto-event detection) - Default off. Only activate for debugging with the Meta Pixel Helper browser extension. When active, the plugin allows Meta's auto-event detection (auto-purchase from Schema.org prices, SubscribedButtonClick, auto-advanced matching) - these events cannot be deduplicated against the Conversion API and can inflate conversion values. Therefore, leave them off in productive operation.
- Exclude customer groups from tracking - Certain customer groups can be excluded from tracking
- Do not trigger ViewCategory event at category root level - Prevents the ViewCategory event from firing at the top category level
Consent Manager:
- Consent Manager - Selection of the cookie consent manager used (default: Shopware Cookie Consent Manager)
- Expert mode - Own Consent Manager data attribute - Allows you to specify your own data attribute for the Consent Manager
- Cookie category - Assignment of the meta pixel to a cookie category (default: statistics)
You can find more detailed documentation for the Meta Pixel extension here:
Google Analytics/ Google Tag Manager
This provider must be activated separately via an in-app purchase.
- Activate Google Tracking - Switch to activate/deactivate Google tracking
- Tracking integration - Selection of the integration method (default: Google Tag Manager)
- Google Analytics Measurement ID (G-XXXXXX) - Enter the GA4 Measurement ID
- GTM Container ID (GTM-XXXXXX) - Enter the Google Tag Manager Container ID
- Activate Google Ads Conversion Tracking - Activates conversion tracking for Google Ads
- Activate advanced conversions (Advanced Data) - Transmits extended conversion data to Google Ads
- Google Ads Conversion ID (AW-XXXXXX) - Entering the conversion ID for Google Ads
- Google Ads Conversion Label - Entering the conversion label for Google Ads
- Activate debug mode - Activates debug mode
- Price transfer mode - Defines how prices are transmitted to Google (default: gross prices)
- Business division - Definition of the business segment (standard: retail)
- Activate server-side tracking - Activates server-side tracking via a separate GTM server container URL
- Server Container URL - URL of the server-side GTM container
- Hide prices for customer groups - Certain customer groups are hidden during price transmission
- Exclude customer groups from tracking - Certain customer groups can be excluded from tracking
Consent Manager:
- Mark content-free container as technically necessary - Marks the consent-free container as technically necessary
- Consent Manager - Selection of the Cookie Consent Manager (default: Shopware Cookie Consent Manager)
- Expert mode - Own Consent Manager data attribute - Own data attribute for the Consent Manager
- Consent attribute for analytics - Customised consent attribute for the analytics category
- Consent attribute for marketing - Customised consent attribute for the marketing category
- Cookie category - Assignment to a cookie category (default: statistics)
- Own GTM snippet (after consent) - JavaScript snippet that is inserted after consent has been granted
- GTM Consent-free snippet (always loaded) - JavaScript snippet that is loaded without requesting consent
- Consent-free GTM Container ID - Container ID for the consent-free GTM container
Custom snippets (Head & Body) — new in 2.3.0
New in version 2.3.0: On the map „My own snippets“ do you tie across providers Add your own code to the storefront:
- „Custom code in the head section“ — is displayed unchanged in the header section of every storefront page (e.g. server-side GTM containers, third-party consent tools, alternative trackers). You specify the script tags yourself.
- „Custom code after the body“ — is output immediately after the opening body tag (e.g. GTM Noscript fallback).
Important: The header code is loaded without consent handling — any consent that may be required (e.g. under the GDPR) is your responsibility. Faulty code may damage the storefront.
Further new features in version 2.3.0 – Lead conversion tracking (generate_lead), GTM preview mode and coupon mapping for tiered/RRP pricing – relate to the Google provider. You can find the setup instructions in the Google Tag Manager documentation:
In addition, the Google provider automatically collects UTM parameters and ad click IDs (gclid, fbclid, msclkid, etc.) for source tracking – this means that the source of each order is directly visible in the Shopware order list. Further details can also be found in the Google Tag Manager documentation.
Here you can find more detailed documentation for the Google Tag Manager, Google Analytics 4 extension:
Reddit Pixel
This provider must be activated separately via an in-app purchase.
- Activate Reddit Pixel - Switch to activate/deactivate the Reddit Pixel
- Reddit Pixel ID - Enter the Reddit Pixel ID
- Conversion API Access Token - Token for server-side transmission
- Activate Conversion API - Activates server-side event tracking
- Deactivate user data in Conversion API - Suppresses the transmission of user data
- Activate asynchronous conversion API - Asynchronous processing via Symfony Messenger
- Activate Conversion API logging - Logging of API calls
- Activate debug mode - Activates debug mode
- Exclude customer groups from tracking - Certain customer groups can be excluded from tracking
- Do not trigger ViewCategory event at category root level - Prevents the ViewCategory event from firing at the top category level
Consent Manager:
- Consent Manager - Selection of the Cookie Consent Manager (default: Shopware Cookie Consent Manager)
- Expert mode - Own Consent Manager data attribute - Own data attribute for the Consent Manager
- Cookie category - Assignment to a cookie category (default: statistics)
You can find more detailed documentation for the Meta Pixel extension here:
Pinterest Tag
This provider must be activated separately via an in-app purchase.
- Active: Toggle to enable/disable the Pinterest tag
- Pinterest tag ID: Entering the tag ID from Pinterest Ads Manager
- Server-side tracking via the Conversions API: Enables additional server-to-server transmission
- Ad Account ID and Conversions API access token: Access credentials for the Conversions API from Pinterest Ads Manager
- Enhanced Match: Optional. Also sends a server-side hashed email with
Consent Manager:
- Consent Manager: Selection of the cookie consent manager to be used (default: Shopware Cookie Consent Manager)
- Expert Mode – Custom Consent Manager data attribute: Allows you to specify your own ‘data’ attribute for the Consent Manager
Here you’ll find more detailed documentation for the Pinterest Tag extension:
Microsoft Advertising (Bing) UET tag
This provider must be activated separately via an in-app purchase.
- Active: Switch to enable/disable the UET tag
- UET Tag ID: Enter the UET tag ID from Microsoft Advertising (Tools › Conversion Tracking › UET Tag)
- Override currency: Optional. Leave blank to use the sales channel’s currency, or specify a fixed currency
Consent Manager:
- Consent Manager: Selection of the cookie consent manager to be used (default: Shopware Cookie Consent Manager)
- Expert Mode – Custom Consent Manager data attribute: Allows you to specify your own ‘data’ attribute for the Consent Manager
Here you will find more detailed documentation on the Microsoft Advertising (Bing) UET tag extension:
Server-side consent check for the Conversion API (new in 2.8.0)
From version 2.8.0 onwards, the extension checks, before every server-side Conversion API event (Meta, Reddit, Pinterest), whether the visitor has consented to marketing tracking via your consent manager. The check is carried out on the same cookie category or consent attribute that is also stored for the browser tag, including any custom attribute set in expert mode.
- No server event without consent: If the visitor has not consented to the ‘Marketing’ category, the extension will no longer send any server-side Conversion API events.
- UserCentrics, CCM19 and Consentmanager: With these three consent managers, the extension also reflects the consent decision in a technical status cookie. The cookie transmits only the consent status; it does not set any tracking. This means that the check is also carried out on the server side with these consent managers.
Expert attribute for each consent manager:
- Cookiebot, CookieFirst, CookieYes: Category
- UserCentrics: Service name
- Consent Manager: Vendor ID
- CCM19: Embedding name. If no embedding name is specified, server-side CCM19 events assume full consent.
GDPR notice: For each provider, there is a new toggle labelled „Disable server-side consent check“ (not recommended). If this is enabled, the extension sends Conversion API events regardless of the visitor’s consent status. This may breach the GDPR if there is no other legal basis for marketing tracking. Only enable this switch if the data processing is otherwise legally compliant. An explicit opt-out by the visitor will always be respected, even if the check is disabled.
- Disable server-side consent checking (per provider, not recommended): A toggle to disable the consent check for this tracking target.
Note for shop owners: Following the update, the total number of Conversion API events may decrease, as visitors without consent will no longer be tracked on the server side. This is a deliberate data protection adjustment and not an error.
Support
If you have any questions or problems, please do not hesitate to contact us:
- Support request: biloba-it.de/shopware-plugin-support
- e-mail: support@biloba-it.de
- Phone: +49 (0) 711 - 13633800
No solution found?
Describe your problem to us - we'll take a look at it and get back to you as soon as possible.
German 
English