Benutzeridentifikation
Verwenden Sie converlay.identify(), um den aktuellen Besucher mit Kundendaten zu verknüpfen. Dies verbessert die Zuordnungsraten auf Werbeplattformen wie Meta CAPI und TikTok Events API.
API
identify()
converlay.identify({
customerId: 'cust_12345',
email: 'jane@example.com',
phone: '+15551234567',
firstName: 'Jane',
lastName: 'Doe',
})IdentifyData-Felder
| Feld | Typ | Beschreibung |
|---|---|---|
customerId | string | Ihre interne Kunden-ID |
email | string | E-Mail-Adresse des Kunden |
phone | string | Telefonnummer (E.164-Format empfohlen) |
firstName | string | Vorname des Kunden |
lastName | string | Nachname des Kunden |
PII-Hashing
Alle personenbezogenen Daten (E-Mail, Telefon, Name) werden im Klartext an den Converlay-Erfassungsendpunkt gesendet und dann auf dem Server mit SHA-256 gehasht, bevor sie an Werbeplattformen weitergeleitet werden. Vor dem Hashing wird eine länderspezifische Normalisierung angewendet (Kleinschreibung, Leerzeichen-Trimming, Telefonnummernformatierung).
Wann identify aufrufen
- Nach dem Login — sobald sich der Kunde authentifiziert hat
- Beim Checkout — wenn Versand-/Rechnungsinformationen verfügbar sind
- Auf der Kontoseite — wenn der Kunde sein Profil ansieht oder aktualisiert
Identitätsdaten bleiben für die aktuelle Session bestehen. Nachfolgende track()-Aufrufe enthalten automatisch die Daten des identifizierten Benutzers.
Beispiele
Nach dem Login
typescript
async function handleLogin(email, password) {
const user = await api.login(email, password)
// Identify after login
converlay.identify({
customerId: user.id,
email: user.email,
firstName: user.firstName,
lastName: user.lastName,
})
}Bei Checkout-Abschluss
typescript
function onCheckoutComplete(order) {
// Identify + track purchase
converlay.identify({
customerId: order.customerId,
email: order.email,
phone: order.phone,
firstName: order.shippingAddress.firstName,
lastName: order.shippingAddress.lastName,
})
converlay.track('purchase', {
ecommerce: {
transaction_id: order.id,
value: order.total,
currency: order.currency,
items: order.lineItems.map(item => ({
item_id: item.variantId,
item_name: item.title,
price: item.price,
quantity: item.quantity,
})),
},
})
}