e-Commerce Tracking

Alle Events verwenden den gleichen Aufruf:
trackboxx(‚Purchase‘, [
{ type: ‚<EventName>‘ },
…weitere Objekte (product, cart, optional context) …
]);

Events und Payloads

1. ViewProduct (Produktdetailseite)
   Auslösen: Wenn eine Produktdetailseite geladen wird.
   Minimaldaten: Produktname, Preis.
   Beispiel:

<script> trackboxx('Purchase', [ { type: 'ViewProduct' }, { type: 'product', name: '%%PRODUCT_NAME%%', price: 99.90 } ]); </script>Code-Sprache: HTML, XML (xml)

Hinweise:

• Preis numerisch (Punkt als Dezimaltrenner).
• Optional weitere Felder ergänzen (z. B. sku, category, currency).

2. ViewCart (Warenkorbseite)
   Auslösen: Beim Aufruf der Warenkorbseite.
   Minimaldaten: Cart-Summe (amount). Optional: alle enthaltenen Produkte.
   Beispiel:

<script> trackboxx('Purchase', [ { type: 'ViewCart' }, { type: 'cart', amount: 149.70 }, { type: 'product', name: 'Produkt A', price: 99.90 }, { type: 'product', name: 'Produkt B', price: 49.80 } ]); </script>Code-Sprache: HTML, XML (xml)

Hinweise:

• amount = aktuelle Warenkorb-Summe (brutto oder netto, im System konsequent bleiben).
• Pro Warenkorbposition ein eigenes { type: ‚product‘, … }-Objekt anhängen.

3. AddToCart (Produkt in den Warenkorb gelegt)
   Auslösen: Unmittelbar nach erfolgreichem „In den Warenkorb“-Vorgang (Button-Klick oder Server-Bestätigung).
   Minimaldaten: Produktname, Preis.
   Beispiel:

<script> trackboxx('Purchase', [ { type: 'AddToCart' }, { type: 'product', name: '%%PRODUCT_NAME%%', price: 19.99 } ]); </script>Code-Sprache: HTML, XML (xml)

Hinweise:

• Bei AJAX-Warenkörben nach dem „added to cart“-Callback feuern.
• Bei serverseitigen Adds nach erfolgreicher Aktion auf der Folgeseite feuern (einmalig!).

Best Practices

• Deduplizierung: Achte darauf, dass AddToCart nur einmal pro Aktion gesendet wird (z. B. keine Dopplung bei Seitenreload).
• Timing: ViewProduct/ViewCart beim Seitenaufbau feuern; AddToCart erst nach bestätigtem Erfolg.
• Währungen: Wenn möglich, im gesamten Shop einheitlich (z. B. EUR). Optional könnt ihr ein zusätzliches Objekt übergeben:
  { type: ‚context‘, currency: ‚EUR‘ }
• Preise & Beträge: Als Number (kein String). Dezimalpunkt verwenden (z. B. 19.99).
• Datenschutz: Keine personenbezogenen Daten übergeben (keine E-Mail, keine Namen, keine Adressen). Consent respektieren.

Schnell-Checkliste je System

• Custom Shops: Serverseitig Variablen (Name/Preis/Summe) in das Inline-Script einsetzen.
• Shopify: Snippets in Templates (product.liquid, cart.liquid) einbauen; für AddToCart am AJAX-Callback andocken.
• Shopware/Magento: Im Theme/Plugin an die jeweiligen Events/Hooks hängen (Produktseite, Warenkorbseite, Add-Events).

Referenz: Minimalvarianten

ViewProduct (minimal)
trackboxx('Purchase', [
{ type: 'ViewProduct' },
{ type: 'product', name: 'Product Name 1', price: 19.99 }
]);Code-Sprache: JavaScript (javascript)

ViewCart (minimal)
trackboxx('Purchase', [
{ type: 'ViewCart' },
{ type: 'cart', amount: 19.99 }
]);Code-Sprache: JavaScript (javascript)

AddToCart (minimal)
trackboxx('Purchase', [
{ type: 'AddToCart' },
{ type: 'product', name: 'Product Name 1', price: 19.99 }
]);Code-Sprache: JavaScript (javascript)