Events & Parameter

Grundlegendes Event-Tracking

Einfaches Event

usertrax.push({
  event: "purchase",
  total: 99.99,
  currency: "EUR",
});

Ecommerce-Event (GA4-Shape)

usertrax.push({
  event: "purchase",
  event_id: "purchase_10001",
  currency: "EUR",
  value: 99.99,              // Alias für total
  total: 99.99,              // Contract-Feld
  transaction_id: "10001",   // Bestellnummer
  tax: 15.96,
  shipping: 5.9,
  items: [
    {
      item_id: "SKU-123",
      item_name: "iPhone 15 Pro",
      item_brand: "Apple",
      item_category: "smartphones",
      price: 47.05,
      quantity: 2,
    },
  ],
  user_data: {
    email: "user@example.com",
    customer_id: "cust_12345",
  },
});

Vollständiges Event mit allen Parametern

usertrax.push({
  // Erforderliche Parameter
  event: "purchase",
  total: 99.99,
  currency: "EUR",

  // Optionale Parameter
  id: "purchase_order_12345", // Dedup / CAPI event_id (Alias: event_id)
  event_id: "purchase_order_12345",
  transaction_id: "order_12345",
  label: "iPhone 15 Pro",
  tax: 15.96,
  shipping: 5.9,

  // Attributionsparameter (automatisch erfasst)
  gclid: "abc123def456",
  fbclid: "fb.123.456.789",
  msclkid: "ms123456789",
  ttclid: "tt123456789",

  // UTM-Parameter
  utm: {
    utm_source: "google",
    utm_medium: "cpc",
    utm_campaign: "summer_sale",
    utm_term: "iphone",
    utm_content: "banner_ad",
  },

  // GA4 items[]
  items: [
    {
      item_id: "iphone_15_pro",
      item_name: "iPhone 15 Pro",
      item_brand: "Apple",
      item_category: "smartphones",
      price: 99.99,
      quantity: 1,
    },
  ],

  // Benutzerdefinierte Metadaten
  metadata: {
    plan: "pro",
  },

  // Nutzerdaten
  user_data: {
    email: "user@example.com",
    name: "John Doe",
    phone: "+1234567890",
    customer_id: "cust_12345",
  },
});

Verfügbare Objektschlüssel

Kern-Event-Parameter

Parameter	Typ	Erforderlich	Beschreibung
`event`	string	Ja	Event-Name (z.B. `"purchase"`, `"add_to_cart"`, `"view_item"`)
`total`	number	Nein	Conversion-Wert/Betrag (primärer Contract)
`value`	number	Nein	Alias für `total` (GA4-Style; wird zu `total` normalisiert)
`currency`	string	Nein	Währungscode (Standard: `"EUR"`)
`id`	string	Nein	Dedup-ID (Server/`event_id`, Meta `eventID`)
`event_id`	string	Nein	Alias/Bevorzugung für Dedup-ID (`event_id ?? id`)
`transaction_id`	string	Nein	Bestellnummer (Ads `transaction_id`, Meta/CAPI `order_id`)
`label`	string	Nein	Lesbare Bezeichnung
`tax`	number	Nein	Steueranteil
`shipping`	number	Nein	Versandkosten
`shipping_tier`	string	Nein	Versandmethode
`payment_type`	string	Nein	Zahlungsart
`coupon`	string	Nein	Gutscheincode
`items`	array	Nein	GA4-Ecommerce-Items (`item_id`, `item_name`, `price`, `quantity`, …)

Attributionsparameter

Parameter	Typ	Beschreibung
`gclid`	string	Google Ads Click ID
`gclsrc`	string	Google Ads Click Source
`dclid`	string	Display & Video 360 Click ID
`fbclid`	string	Facebook Ads Click ID
`fbc`	string	Facebook Browser Cookie
`fbp`	string	Facebook Browser Parameter
`msclkid`	string	Microsoft Ads Click ID
`ttclid`	string	TikTok Ads Click ID
`adcell`	string	Adcell Tracker ID

UTM-Parameter

Parameter	Typ	Beschreibung
`utm_source`	string	Traffic-Quelle (z.B. “google”, “facebook”)
`utm_medium`	string	Marketing-Medium (z.B. “cpc”, “email”)
`utm_campaign`	string	Kampagnenname
`utm_term`	string	Keywords für bezahlte Suche
`utm_content`	string	Inhaltsvariation für A/B-Tests

Benutzerdefinierte Daten

Parameter	Typ	Beschreibung
`metadata`	object	Benutzerdefinierte JSON-Daten für die Conversion
`user_data`	object	Nutzerinformationen (E-Mail, Name, etc.)

HTML-Datenattribute

Grundlegendes Tracking

<button
  data-usertrax="purchase"
  data-usertrax-total="99.99"
  data-usertrax-currency="EUR"
  data-usertrax-id="order_12345"
  data-usertrax-label="iPhone 15 Pro"
>
  Jetzt kaufen
</button>

Erweitertes Tracking mit Metadaten

<button
  data-usertrax="signup"
  data-usertrax-total="0"
  data-usertrax-currency="EUR"
  data-usertrax-meta-data='{"plan": "premium", "source": "landing_page"}'
  data-usertrax-user-data='{"email": "user@example.com"}'
>
  Kostenlos testen
</button>

Verfügbare Datenattribute

Attribut	Beschreibung
`data-usertrax`	Event-Name
`data-usertrax-total`	Conversion-Wert
`data-usertrax-value`	Alias für `data-usertrax-total`
`data-usertrax-currency`	Währungscode
`data-usertrax-id`	Event-Identifier
`data-usertrax-label`	Event-Bezeichnung
`data-usertrax-meta-data`	JSON-String mit benutzerdefinierten Daten
`data-usertrax-user-data`	JSON-String mit Nutzerinformationen