Referencia de eventos

Converlay rastrea automáticamente 10 eventos del storefront a través de la API de Web Pixels de Shopify. No se necesita configuración manual de eventos — todos los eventos se disparan automáticamente cuando un visitante interactúa con tu tienda.

Eventos rastreados automáticamente

Evento	Disparador	Datos clave
`page_view`	Cada carga de página	URL, referrer, UTMs
`view_item`	Página de producto vista	ID de producto, nombre, precio, variante
`view_item_list`	Colección / resultados de búsqueda vistos	ID de lista de artículos, artículos
`add_to_cart`	Artículo añadido al carrito	ID de producto, cantidad, precio
`remove_from_cart`	Artículo eliminado del carrito	ID de producto, cantidad
`search`	Búsqueda realizada	Término de búsqueda
`begin_checkout`	Checkout iniciado	Valor del carrito, artículos
`add_payment_info`	Información de pago introducida	Método de pago
`add_shipping_info`	Información de envío introducida	Método de envío
`purchase`	Pedido completado	ID de transacción, valor, artículos, datos de usuario

Estructura de la carga del evento

Cada evento enviado al endpoint de recopilación de Converlay sigue esta estructura. Aquí un ejemplo de evento purchase:

purchase event payload

{
  "event_id": "evt_abc123",
  "event_name": "purchase",
  "shop_domain": "my-store.myshopify.com",
  "page_url": "https://my-store.com/thank-you",
  "client_id": "clid_...",
  "session_id": "sid_...",
  "fbp": "fb.1.1700000000000.1234567890",
  "gclid": "CjwKCAiA...",
  "consent_data": {
    "analytics": true,
    "marketing": true,
    "ad_user_data": true,
    "ad_personalization": true
  },
  "ecommerce": {
    "transaction_id": "5678",
    "value": 129.99,
    "currency": "USD",
    "items": [
      {
        "item_id": "gid://shopify/ProductVariant/123",
        "item_name": "Classic Tee",
        "price": 29.99,
        "quantity": 2
      }
    ]
  },
  "user_data": {
    "email": "sha256:abc...",
    "phone": "sha256:def..."
  }
}

Manejo de PII

Los datos de usuario (correo electrónico, teléfono, dirección) se hashean con SHA-256 en el servidor antes de reenviarse a las plataformas publicitarias. Los PII sin procesar nunca se almacenan ni comparten. Se aplica normalización específica por país antes del hashing.

Enriquecimiento de eventos

Antes del reenvío, cada evento se enriquece con:

Vinculación de Click ID — gclid, fbclid, ttclid se persisten entre sesiones
Parámetros de Facebook — _fbp y _fbc se generan para la coincidencia de Meta CAPI
Contexto de sesión — sesión deslizante de 30 minutos con client ID persistente
Señales de consentimiento — señales de Google Consent Mode v2 mapeadas desde la Customer Privacy API de Shopify
Deduplicación de eventos — un event_id único evita el doble conteo entre fuentes de pixel y webhook

Anterior← Conectar destinos SiguienteConsentimiento y privacidad →