Nutzer-Identifikation

Verknüpft den aktuellen Browser mit einem bekannten Nutzer (ähnlich wie PostHog identify). Einmal nach Login oder Registrierung aufrufen — jedes spätere push() enthält automatisch den Person-Kontext.

Bevorzuge usertrax.identify() als einzigen Aufruf: Wenn das Feedback-Widget auf derselben Seite läuft, setzt derselbe Call die Identität dort ebenfalls (E-Mail-Feld ausblenden, Metadaten). Die Identität liegt in localStorage (usertrax_identify) — das Widget übernimmt sie auch, wenn es nach dem Tracker lädt.

// Nach dem Login
usertrax.identify("user_xyz", {
  email: "jane@example.com",
  plan: "team",
  seats: 5,
});

// Spätere Conversions erben user_data + Meta-Snapshot
usertrax.push({ event: "purchase", total: 49.99, currency: "EUR" });

tracker.identify("user_xyz", {
  email: "jane@example.com",
  plan: "team",
});

1. Persistenz — Wird in localStorage (usertrax_identify) gespeichert und über Seitenaufrufe und Sessions hinweg wiederverwendet.
2. user_data-Merge — Kanonische Trait-Schlüssel (email, phone, phone_number, first_name, last_name, name, customer_id, address) werden in user_data jeder Conversion gemerged. Die Distinct-ID wird zu customer_id, wenn du keine explizit setzt. Felder in einem einzelnen push({ user_data: … }) überschreiben Traits aus identify.
3. Vollständiger Trait-Snapshot — Alle Traits (inkl. benutzerdefinierter Keys wie plan oder seats) gehen bei jeder Conversion unter meta_data.$usertrax_identify mit:

{
  "distinct_id": "user_xyz",
  "traits": { "email": "jane@example.com", "plan": "team", "seats": 5 }
}

4. PostHog — Wenn PostHog geladen ist und usertraxConfig.posthog nicht false ist, ruft identify zusätzlich posthog.identify(distinctId, traits) auf.
5. Feedback-Widget — Feuert usertrax:identify, damit ein geladenes Feedback-Widget dieselbe Identität übernimmt (hydriert beim Start auch aus localStorage).

Nutze setUserData(), wenn du nur Google Enhanced Conversions mit Hashing brauchst, ohne stabile Distinct-ID — siehe Ads & Enhanced Conversions. Nutze identify(), wenn eine persistente Person-ID und Traits auf allen Events mitgehen sollen.