Seguimiento de eventos

Usa converlay.track(eventName, properties) para enviar eventos. El SDK enriquece automáticamente cada evento con client ID, sesión, UTMs, Click IDs y estado de consentimiento.

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

Nombres de eventos estándar

Usa estos nombres de eventos para el mapeo automático a tipos de eventos de GA4, Meta y TikTok:

Nombre del evento	Cuándo dispararlo
`page_view`	Carga de página o navegación del lado del cliente
`view_item`	Página de detalle de producto
`view_item_list`	Página de colección o resultados de búsqueda
`add_to_cart`	Artículo añadido al carrito
`remove_from_cart`	Artículo eliminado del carrito
`search`	Consulta de búsqueda enviada
`begin_checkout`	Checkout iniciado
`add_payment_info`	Información de pago introducida
`add_shipping_info`	Información de envío introducida
`purchase`	Pedido completado

Eventos personalizados

Puedes usar cualquier cadena de texto como nombre de evento. Los eventos personalizados se reenviarán tal cual a los destinos que los admitan.

Campos de TrackProperties

Campo	Tipo	Descripción
`ecommerce`	`EcommerceData`	Datos de transacción y artículos
`userData`	`UserData`	PII del cliente para coincidencia avanzada (hasheado del lado del servidor)
`pageType`	`string`	Etiqueta de tipo de página (p. ej., "product", "collection", "cart")
`[key: string]`	`unknown`	Cualquier propiedad personalizada adicional

Ejemplos

Ver artículo

typescript

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

Añadir al carrito

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

Compra

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

Anterior← Inicio rápido SiguienteIdentificación de usuarios →