Dokumentation

Snippet installieren

Füge das asynchrone Script auf jeder Seite ein, idealerweise im Head. Es lädt die signierte Konfiguration für deine Tracking-ID, respektiert Consent und blockiert nie das Rendering. Ersetze TRACKING_ID durch die sechsstellige ID aus deinem Dashboard.

<script async src="https://cdn.track.site/v1/tracker.js" data-site-id="TRACKING_ID"></script>

Browser-Events senden

Standardevents (page_view, view_item, add_to_cart, begin_checkout, purchase, generate_lead, sign_up, subscribe, start_trial, contact, book_appointment, download, search, login) tragen validierte Parameter; Custom-Events verwenden Namen in lowercase snake_case.

window.tsq = window.tsq || [];
tsq.push(["track", "purchase", { order_id: "A1001", currency: "EUR", value: 129.9, items: [{ item_id: "SKU-1", price: 99.9, quantity: 1 }] }]);
tsq.push(["identify", { user_id: "u_42", email: "customer@example.com" }]); // wird clientseitig vor dem Transport gehasht

Server-API und Offline-Conversions

Lege in Einstellungen → Server-Source-Keys einen Key an und sende Events aus Backend, CRM oder Kasse. Übergib dieselbe Bestellnummer wie das Browser-Event zur Deduplizierung; setze props.offline für Offline-Conversions.

curl -X POST https://api.track.site/v1/s \
  -H "Authorization: Bearer tsk_..." -H "Content-Type: application/json" \
  -d '{"events":[{"name":"purchase","ts":1767225600000,"props":{"offline":true},"commerce":{"order_id":"A1001","currency":"EUR","value":129.9},"user_data":{"email":"customer@example.com"},"click_ids":{"gclid":"Cj0K..."},"consent":{"granted":["necessary","marketing"],"source":"crm"}}]}'

Consent-Integration

Nutze ein unterstütztes CMP (TCF 2.2, GPP/GPC, Cookiebot, OneTrust, Usercentrics) — der Tracker liest es automatisch — oder rufe die Consent-API aus deinem eigenen Banner auf. Zwecke: necessary, analytics, marketing, personalization. Ein Widerruf stoppt alles sofort.

tsq.push(["consent", { granted: ["necessary", "analytics", "marketing"], source: "api", policy_version: "2026-09" }]);

Destinationen

Jede Destination hat einen geführten Assistenten: Kennungen, Tresor-Zugangsdaten oder OAuth, Anbieter-Validierung, Event-Mapping mit geprüften Standards, echter Testevent, Lint, Diff und freigabepflichtige Veröffentlichung. Browser und Server teilen eine Event-ID; Käufe ergänzen die Bestellnummer.

• Meta, Google Ads/YouTube, GA4, TikTok, Microsoft, LinkedIn, Reddit, Pinterest, Snapchat
• X, Taboola, Outbrain, Amazon Ads, Spotify, Quora
• Yahoo DSP, The Trade Desk, Google Marketing Platform, AdRoll, Criteo, Affiliate-Postbacks (13 Presets), Webhooks

Shopsysteme

Shopify (App mit Order-Webhooks und Web Pixel), WooCommerce (Plugin mit signierten Order-Webhooks) und Shopware 6 (App mit Storefront-Script und Order-Webhooks) senden verifizierte Kauf- und Erstattungsevents mit Bestellnummern. Plugin installieren, Tracking-ID und Source-Key einfügen, fertig.

• Verifizierte Quelle: Events sind source_verified und gelten als maßgebliche Conversion
• Erstattungen erzeugen Events mit negativem Wert für Anbieter, die das unterstützen
• Browser-Käufe aus dem Theme werden über die Bestellnummer dedupliziert

Datenschutz-Center und DSAR

Aufbewahrungsfristen pro Datenart, Consent-Policy-Versionen pro Site und Betroffenenanfragen (Export, Löschen, Einschränken, Berichtigen, Widerspruch, Übertragbarkeit) werden unter Consent & Datenschutz bearbeitet. Anfragen nutzen nur gehashte Kennungen und erzeugen einen auditierten Bericht.