Identifizierte Benutzer & CRM-Integration

Scale Plan

Verbinden Sie anonyme Besucherdaten mit bekannten Benutzern. Wenn sich Besucher anmelden oder Formulare absenden, verknüpft Zenovay deren gesamte Historie mit ihrer Identität.

Wie die Benutzeridentifikation funktioniert

Von anonym zu bekannt

Besucherreise:

Besuch 1 (Anonym):
Anonymer Besucher durchstöbert die Website
→ Zugewiesene Besucher-ID: viz_abc123

Besuch 2 (Anonym):
Derselbe Besucher kehrt zurück
→ Dieselbe Besucher-ID: viz_abc123

Besuch 3 (Identifiziert):
Besucher meldet sich als [email protected] an
→ zenovay('identify', '[email protected]')
→ Gesamte Historie mit [email protected] verknüpft

Zukünftige Besuche:
Automatisch erkannt
→ Vollständige Journey erhalten

Daten zusammengeführt

Bei der Identifikation:

Vergangene anonyme Besuche verknüpft
Zukünftige Besuche nachverfolgt
Vollständige Journey sichtbar
Geräteübergreifend möglich

Identifikation implementieren

Grundlegende Identifikation

Rufen Sie identify auf, wenn der Benutzer bekannt ist:

// Wenn sich der Benutzer anmeldet
zenovay('identify', userId);

// Beispiel
zenovay('identify', 'user_12345');
// oder
zenovay('identify', '[email protected]');

Mit Benutzereigenschaften

Benutzerdetails als drittes Argument hinzufügen:

zenovay('identify', 'user_12345', {
  email: '[email protected]',
  name: 'John Smith',
  company: 'Acme Corporation',
  plan: 'enterprise',
  role: 'admin'
});

Information

Entweder eine E-Mail-Adresse oder eine Kunden-ID ist erforderlich, um einen Besucher zu identifizieren. Das erste Argument kann eine E-Mail-Adresse oder Ihre eigene Benutzer-ID sein.

Unterstützte Eigenschaften

Eigenschaft	Typ	Beschreibung
email	string	E-Mail-Adresse
name	string	Vollständiger Name
first_name	string	Vorname
last_name	string	Nachname
company	string	Firmenname
phone	string	Telefonnummer
custom_*	any	Benutzerdefinierte Eigenschaften

Alle zusätzlichen Schlüssel, die Sie übergeben, werden als benutzerdefinierte Attribute im Benutzerprofil gespeichert.

Implementierungsbeispiele

Bei der Anmeldung

// Nach erfolgreicher Anmeldung
async function handleLogin(credentials) {
  const user = await loginUser(credentials);

  // In Zenovay identifizieren
  zenovay('identify', user.id, {
    email: user.email,
    name: user.name,
    company: user.company_name
  });

  // Mit der App fortfahren
  redirectToDashboard();
}

React Hook

import { useEffect } from 'react';
import { useAuth } from './auth';

function useZenovayIdentify() {
  const { user, isAuthenticated } = useAuth();

  useEffect(() => {
    if (isAuthenticated && user) {
      if (window.zenovay) {
        window.zenovay('identify', user.id, {
          email: user.email,
          name: user.name,
          company: user.company
        });
      }
    }
  }, [user, isAuthenticated]);
}

Formularübermittlung

// Bei Formularübermittlung (vor der Anmeldung)
async function handleFormSubmit(formData) {
  // Mit E-Mail aus dem Formular identifizieren
  zenovay('identify', formData.email, {
    email: formData.email,
    name: formData.name,
    company: formData.company
  });

  // Die Formularübermittlung tracken
  zenovay('goal', 'form_submission');

  // An das Backend senden
  await submitForm(formData);
}

Identifizierte Benutzer anzeigen

Benutzeransicht

Öffnen Sie das Dashboard Ihrer Website (/domains/{id})
Öffnen Sie in der Seitenleistengruppe Audience die Registerkarte Journeys
Wählen Sie die Unterregisterkarte Users aus, um identifizierte Benutzer und ihre Zeitleisten zu sehen
Klicken Sie auf einen Benutzer, um sein Profil und die vollständige Aktivitätszeitleiste zu öffnen

Benutzerliste

Jede Zeile zeigt den Namen oder die E-Mail-Adresse des Besuchers, wo er/sie herkam, wie viele Seiten angesehen wurden, welcher Umsatz ihm/ihr zugeordnet ist, und wann er/sie zuletzt aktiv war. Sortieren Sie die Liste, um Ihre aktivsten oder umsatzstärksten Benutzer hervorzuheben:

Besucher	Quelle	Seitenaufrufe	Umsatz	Zuletzt aktiv
[email protected]	Google	24	4.999 USD	Heute
[email protected]	Direkt	18	—	Gestern
[email protected]	Twitter	12	99 USD	vor 3 Tagen

Besucher, die sich noch nicht identifiziert haben, werden als Anonym angezeigt, bis ein identify-Aufruf (oder eine bekannte E-Mail aus einem Event) eine echte Identität verknüpft. Klicken Sie auf eine beliebige Zeile, um das vollständige Profil und die Aktivitätszeitleiste des Besuchers zu öffnen.

Benutzerprofil

┌─────────────────────────────────────────────────────┐
│ John Smith                                          │
│ [email protected]                                       │
│ ─────────────────────────────────────────────────── │
│                                                     │
│ Unternehmen: Acme Corporation                       │
│ Plan: Enterprise                                    │
│ Rolle: Admin                                        │
│ Erstellt: 15. November 2024                         │
│                                                     │
│ ─────────────────────────────────────────────────── │
│                                                     │
│ Analyse-Zusammenfassung:                            │
│ • Sitzungen insgesamt: 24                            │
│ • Gesamtzeit: 3h 45m                                │
│ • Seitenaufrufe: 89                                 │
│ • Abgeschlossene Ziele: 5                           │
│ • Umsatz: 4.999 USD                                 │
│                                                     │
│ Erstes Besuch: 20. Okt. 2024 (anonym)               │
│ Identifiziert: 15. Nov. 2024                        │
│ Letzter Besuch: Heute um 14:30 Uhr                  │
│                                                     │
└─────────────────────────────────────────────────────┘

Benutzer-Journey

Vollständige Zeitleiste

Sehen Sie die komplette Benutzerhistorie:

John Smith - Journey-Zeitleiste

15. Januar 2025
├── 14:30 - Einstellungsseite (5 Min.)
├── 14:00 - Dashboard (10 Min.)
└── Angemeldet

10. Januar 2025
├── 15:45 - Abrechnungsseite (3 Min.)
├── 15:40 - Upgrade-Modal → Upgrade durchgeführt ✓
└── Angemeldet

15. Dezember 2024
├── 10:00 - Onboarding-Ablauf
└── Konto erstellt, identifiziert

28. November 2024 (anonym)
├── Demo-Anfrage eingereicht → Identifiziert
├── /pricing (8 Min.)
└── /features (5 Min.)

20. Oktober 2024 (anonym)
├── /blog/guide (4 Min.)
└── Erstes Besuch über Google-Suche

Geräteübergreifendes Tracking

Wenn sich ein Benutzer auf mehreren Geräten anmeldet, werden seine Sitzungen mit derselben Identität verknüpft:

Verwendete Geräte:

Desktop (Chrome/Windows)
├── 18 Sitzungen
└── Zuletzt: Heute

Mobil (Safari/iOS)
├── 4 Sitzungen
└── Zuletzt: 10. Jan.

Tablet (Chrome/iPad)
├── 2 Sitzungen
└── Zuletzt: 20. Dez.

Alle Sitzungen mit [email protected] verknüpft

Wenn derselbe Besucher auf mehr als einer Ihrer verfolgten Domains identifiziert wird, werden in der Zeitleiste auch die anderen Domains angezeigt, auf denen er/sie gesehen wurde.

Datenschutzaspekte

Benutzereinwilligung

Vor der Identifikation:

Ordnungsgemäße Einwilligung sicherstellen
Datenschutzrichtlinie befolgen
Opt-outs respektieren

Datenverarbeitung

Benutzerdaten werden:

Im Ruhezustand verschlüsselt
Bei der Übertragung verschlüsselt
Durch Team-Mitgliedschaft und Rolle zugriffskontrolliert
Gemäß dem Datenverfügbarkeitsfenster Ihres Plans aufbewahrt

Benutzerdaten löschen

Um die persönlichen Daten einer Person zu entfernen, verwenden Sie eine standardmäßige Anfrage zur Betroffenenanfrage: Lassen Sie sie (oder Sie in ihrem Namen) die Löschung über Einstellungen → Konto anfordern, wenn sie ein Kontoinhaber sind, oder kontaktieren Sie den Support unter [email protected] für einen Besucher, der kein Kontoinhaber ist. Das Entfernen der Tracking-Zuordnung der Website stoppt auch die weitere Erfassung.

Opt-Out respektieren

// Vor der Identifikation auf Opt-out prüfen
if (!userHasOptedOut()) {
  zenovay('identify', userId, userData);
}

API-Zugriff

Daten zu identifizierten Benutzern sind über die Zenovay REST API auf kostenpflichtigen Plänen verfügbar. Verwenden Sie sie, um das Profil, die Statistiken und die Zeitleiste eines Benutzers in Ihre eigenen Systeme zu ziehen oder um die Identifikation von einem Backend aus zu durchzuführen.

Informationen zu Authentifizierung, Endpunkten und Antwortformaten finden Sie unter API-Übersicht. Der oben gezeigte identify-Aufruf (zenovay('identify', ...)) ist die clientseitige Möglichkeit, einen Benutzer zu erstellen oder zu aktualisieren; die REST API ist die serverseitige Entsprechung zum Auslesen dieser Daten.

Best Practices

Frühzeitig identifizieren

Identifizieren Sie so früh wie möglich:

Bei Registrierung/Anmeldung
Bei Formularübermittlung
Wenn E-Mail bekannt ist

Konsistente IDs verwenden

Wählen Sie eine ID-Strategie:

E-Mail (wenn eindeutig)
Benutzer-ID aus der Datenbank
UUID

Eigenschaften aktualisieren

Halten Sie Eigenschaften aktuell:

// Wenn der Benutzer seinen Plan upgradet
zenovay('identify', userId, {
  plan: 'enterprise',
  upgraded_at: new Date()
});

Nicht zu häufig identifizieren

Vermeiden Sie den Aufruf von identify:

Bei jedem Seitenaufruf
Für anonyme Besucher
Ohne Benutzereinwilligung

Fehlerbehebung

Benutzer wird nicht identifiziert

Wenn die Identifikation fehlschlägt:

Konsole auf Fehler prüfen
Überprüfen, dass das Tracking-Script geladen wurde
Bestätigen, dass identify nach dem Script aufgerufen wird

Historie nicht verknüpft

Wenn vergangene Besuche nicht angezeigt werden:

Cookies wurden möglicherweise gelöscht
Anderer Browser/anderes Gerät
Inkognito-Modus wurde verwendet