Tracciamento eventi

Usa converlay.track(eventName, properties) per inviare eventi. L'SDK arricchisce automaticamente ogni evento con client ID, sessione, UTM, Click ID e stato del consenso.

Firma dell'API

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',
})

Nomi degli eventi standard

Usa questi nomi di evento per la mappatura automatica verso i tipi di evento di GA4, Meta e TikTok:

Nome evento	Quando generarlo
`page_view`	Caricamento pagina o navigazione lato client
`view_item`	Pagina dettaglio prodotto
`view_item_list`	Pagina collezione o risultati di ricerca
`add_to_cart`	Articolo aggiunto al carrello
`remove_from_cart`	Articolo rimosso dal carrello
`search`	Ricerca effettuata
`begin_checkout`	Checkout avviato
`add_payment_info`	Informazioni di pagamento inserite
`add_shipping_info`	Informazioni di spedizione inserite
`purchase`	Ordine completato

Eventi personalizzati

Puoi usare qualsiasi stringa come nome di evento. Gli eventi personalizzati verranno inoltrati così come sono alle destinazioni che li supportano.

Campi di TrackProperties

Campo	Tipo	Descrizione
`ecommerce`	`EcommerceData`	Dati di transazione e articoli
`userData`	`UserData`	PII del cliente per il matching avanzato (sottoposti a hashing server-side)
`pageType`	`string`	Etichetta del tipo di pagina (es. "product", "collection", "cart")
`[key: string]`	`unknown`	Qualsiasi proprietà personalizzata aggiuntiva

Esempi

Visualizzazione prodotto

typescript

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

Aggiungi al carrello

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,
    }],
  },
})

Acquisto

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',
  },
})

Precedente← Avvio rapido SuccessivoIdentificazione utenti →