ConverlayConverlay

Ereignisverfolgung

Verwenden Sie converlay.track(eventName, properties), um Events zu senden. Das SDK reichert jedes Event automatisch mit Client ID, Session, UTMs, Click IDs und Einwilligungsstatus an.

API-Signatur

track() signature
converlay.track('event_name', {
  ecommerce: {
    transaction_id: 'ORD-123',
    value: 99.99,
    currency: 'USD',
    items: [
      {
        item_id: 'SKU-001',
        item_name: 'Classic Tee',
        price: 29.99,
        quantity: 2,
      },
    ],
  },
  userData: {
    email: 'customer@example.com',
  },
  pageType: 'product',
})

Standard-Event-Namen

Verwenden Sie diese Event-Namen für die automatische Zuordnung zu GA4-, Meta- und TikTok-Event-Typen:

Event-NameWann auslösen
page_viewSeitenaufruf oder clientseitige Navigation
view_itemProduktdetailseite
view_item_listKollektion oder Suchergebnisseite
add_to_cartArtikel in den Warenkorb gelegt
remove_from_cartArtikel aus dem Warenkorb entfernt
searchSuchanfrage abgesendet
begin_checkoutCheckout gestartet
add_payment_infoZahlungsinformationen eingegeben
add_shipping_infoVersandinformationen eingegeben
purchaseBestellung abgeschlossen

Benutzerdefinierte Events

Sie können jeden beliebigen String als Event-Namen verwenden. Benutzerdefinierte Events werden unverändert an Ziele weitergeleitet, die sie unterstützen.

TrackProperties-Felder

FeldTypBeschreibung
ecommerceEcommerceDataTransaktions- und Artikeldaten
userDataUserDataKunden-PII für erweitertes Matching (serverseitig gehasht)
pageTypestringSeitentyp-Label (z. B. "product", "collection", "cart")
[key: string]unknownBeliebige zusätzliche benutzerdefinierte Eigenschaften

Beispiele

Artikel anzeigen

typescript
converlay.track('view_item', {
  ecommerce: {
    items: [{
      item_id: 'SKU-001',
      item_name: 'Classic Tee',
      item_variant: 'Blue / Large',
      price: 29.99,
      quantity: 1,
    }],
  },
})

In den Warenkorb

typescript
converlay.track('add_to_cart', {
  ecommerce: {
    value: 29.99,
    currency: 'USD',
    items: [{
      item_id: 'SKU-001',
      item_name: 'Classic Tee',
      price: 29.99,
      quantity: 1,
    }],
  },
})

Kauf

typescript
converlay.track('purchase', {
  ecommerce: {
    transaction_id: 'ORD-5678',
    value: 129.99,
    currency: 'USD',
    items: [
      { item_id: 'SKU-001', item_name: 'Classic Tee', price: 29.99, quantity: 2 },
      { item_id: 'SKU-042', item_name: 'Hoodie', price: 70.01, quantity: 1 },
    ],
  },
  userData: {
    email: 'customer@example.com',
    phone: '+15551234567',
    firstName: 'Jane',
    lastName: 'Doe',
  },
})
Zurück← SchnellstartWeiterBenutzeridentifikation →