Cómo funciona el Pixel
Converlay utiliza la API de Web Pixels de Shopify para capturar eventos del storefront. El pixel se ejecuta dentro de un iframe aislado gestionado completamente por Shopify, garantizando cero impacto en el rendimiento de tu tienda.
Ejecución aislada
Shopify carga los pixels personalizados en un sandbox aislado. Esto significa que el pixel no puede acceder al DOM de la página principal, a las cookies ni interferir con tu storefront. Recibe los eventos a través del bus de eventos de Shopify.
APIs del navegador disponibles
| API | Disponible |
|---|---|
browser.localStorage | Sí |
browser.cookie | No |
document.cookie | No |
window.localStorage | No (usa browser.localStorage) |
fetch / sendBeacon | Sí |
Datos capturados
Cada carga de evento incluye:
- Client ID — identificador persistente almacenado en
browser.localStorage - Session ID — ventana deslizante de 30 minutos, también persistida en localStorage
- Click IDs —
gclid,fbclid,ttclidextraídos de la URL de la página - Parámetros UTM —
utm_source,utm_medium,utm_campaign,utm_term,utm_content - Facebook Browser ID —
_fbpgenerado a partir del client ID,_fbca partir del fbclid - PII del checkout — correo electrónico, teléfono, nombre, dirección (hasheados del lado del servidor con SHA-256 antes del reenvío)
- Estado de consentimiento — mapeado desde la Customer Privacy API de Shopify a señales de Google Consent Mode v2
Transporte
Los eventos se envían al endpoint de recopilación de Converlay usando navigator.sendBeacon para mayor fiabilidad durante las descargas de página. Si sendBeacon no está disponible, el pixel recurre a una solicitud fetch POST estándar.
Persistencia
El Client ID y el Session ID se almacenan en browser.localStorage. Si localStorage no está disponible (por ejemplo, en algunos navegadores centrados en la privacidad), el pixel recurre al almacenamiento en memoria. Los IDs se regenerarán en cada carga de página en ese caso.
Versionado del pixel
Cada despliegue del pixel incluye un número de versión y un hash de commit. Puedes consultar la versión en ejecución en tu panel de Converlay o en la consola del navegador buscando las entradas de log [Converlay].
Caché
Shopify cachea agresivamente el código de los web pixels. Tras desplegar una nueva versión del pixel, las tiendas deben desconectar y reconectar el pixel en Configuración → Eventos de clientes para que los cambios de código surtan efecto. Los cambios de configuración se pueden enviar remotamente a través del actualizador masivo.