Shopware 6 Integration

Das offizielle Shopware-6-Plugin verbindet deinen Storefront mit usertrax: Tracker, Ecommerce-Funnel, optionales Feedback-Widget und Identity auf der Bestellbestätigung — ohne Cookies und ohne Consent-Banner für usertrax selbst.

Kompatibel mit Shopware 6.7.

Voraussetzungen

Shopware 6.7 (shopware/core, shopware/storefront)
Domain + API-Schlüssel im usertrax Dashboard (Schnellstart)
Feedback-Widget: Pro-Tarif oder höher und Feedback für die Domain aktiviert (Feedback)

Installation

Plugin installieren (Composer empfohlen)

composer require splintnet/usertrax-shopware
bin/console plugin:refresh
bin/console plugin:install Usertrax --activate
bin/build-storefront.sh
bin/console cache:clear

Alternativ: Repository nach custom/plugins/Usertrax kopieren und dieselben Console-Befehle ausführen.

API-Schlüssel hinterlegen
Öffne Admin → Erweiterungen → usertrax → Konfiguration und trage den Domain-API-Schlüssel aus dem Dashboard ein.
Storefront prüfen
Lade eine Produktseite und prüfe in der Browser-Konsole bzw. im Network-Tab, ob cvs.js geladen wird und Events ankommen.

Konfiguration

Namespace: Usertrax.config.*

Schlüssel	Beschreibung	Standard
`active`	Tracker laden und Ecommerce-Events senden	`true`
`apiKey`	Domain-`data-key` aus dem Dashboard	—
`feedbackWidget`	`feedback.js` laden	`true`
`debugMode`	`usertraxConfig.debugMode` (Console-Logging)	`false`

Tracking und Feedback lassen sich getrennt schalten; beide nutzen denselben API-Schlüssel.

Ecommerce-Events

Events folgen dem GA4-Ecommerce-Format aus Conversion Tracking. Zusätzlich sendet das Plugin Kompatibilitätsfelder (total, id) für den aktuellen Tracker-Vertrag.

Event	Wann
`view_item`	Produktdetailseite
`add_to_cart`	In-den-Warenkorb
`remove_from_cart`	Position entfernen
`view_cart`	Warenkorbseite + Offcanvas-Warenkorb
`begin_checkout`	Checkout-CTA (Warenkorb / Offcanvas)
`add_shipping_info`	Bestätigungsseite (wenn Versandmethoden vorhanden)
`add_payment_info`	Bestätigungsseite
`purchase`	Bestellabschluss / Danke-Seite

item_id bevorzugt die Produktnummer (SKU), damit Katalog-Matching bei Meta/Google funktioniert. Siehe Meta Ads Export und Conversion Tracking.

Auf der Bestellabschlussseite ruft das Plugin zusätzlich usertrax.identify() auf und sendet user_data, damit spätere Conversions und das Feedback-Widget denselben Personenkontext teilen.

Beispiel `purchase`

usertrax.push({
  event: "purchase",
  event_id: "purchase_10001",
  id: "purchase_10001",
  currency: "EUR",
  value: 99.99,
  total: 99.99,
  transaction_id: "10001",
  tax: 15.96,
  shipping: 5.9,
  items: [
    {
      item_id: "SKU-123",
      item_name: "Produktname",
      item_brand: "Marke",
      item_category: "Kategorie",
      price: 47.05,
      quantity: 2,
      index: 0,
    },
  ],
  user_data: {
    email: "kunde@example.com",
    customer_id: "…",
    first_name: "…",
    last_name: "…",
  },
});

Geladene Scripts

Wenn aktiv, erweitert das Plugin das Shopware-Analytics-Head-Template und lädt:

https://usertrax.io/cvs.js — Conversion-Tracker (Schnellstart)
https://usertrax.io/feedback.js — Feedback-Widget (Feedback)

Beide nutzen denselben data-key. Page Views und Attribution übernimmt der Tracker; das Plugin fokussiert auf Ecommerce-Conversions.

Für First-Party-/Proxy-Setups siehe die Proxy-Guides.

Conversion-Export & Ads

Mit usertraxConfig.ga4 / tagManager / facebook kann der Tracker Events an GA4, GTM und Meta weiterleiten. Offline-Import in Werbeplattformen:

Fehlerbehebung

Keine Events: Prüfe, ob das Plugin aktiv ist und der API-Schlüssel stimmt; Storefront nach Plugin-Updates neu bauen (bin/build-storefront.sh).
Feedback fehlt: Pro-Tarif und Feedback für die Domain im Dashboard aktivieren; feedbackWidget in der Plugin-Konfiguration prüfen.
Falsche SKUs / Katalog-Matching: Produktnummer in Shopware prüfen — das Plugin nutzt sie als item_id.

Quellcode und Releases: splintnet/usertrax-shopware.