Primeros pasos con Shift4Shop
Qué aprenderás
Descubre cómo integrar Shift4Shop (anteriormente 3dcart) con Klaviyo para personalizar y dirigir los emails en función de las compras y la actividad en el sitio web de cada cliente. Los datos sincronizados de Shift4Shop a Klaviyo incluyen:
- Datos sobre los pedidos que hacen los clientes, incluidas las ventas, los pedidos completados y los pedidos cancelados
- Datos del cliente de los pedidos, incluidas las direcciones de email, los nombres y los números de teléfono
Las visitas al sitio web y las visualizaciones de productos se registran por separado después de añadir el seguimiento onsite de Klaviyo a tu sitio.
La sincronización inicial de pedidos usa una búsqueda retrospectiva de 3 años basada en el momento en que los pedidos se actualizaron por última vez e importa los datos del cliente de esos pedidos.
Tabla de contenidos
- Añadir la integración de Shift4Shop
- Añadir seguimiento en el sitio de Klaviyo
- Supervisa la sincronización de datos
- Datos sincronizados desde Shift4Shop
- Actualiza tu integración de Shift4Shop
- Recursos adicionales
Añadir la integración de Shift4Shop
- En Klaviyo, selecciona la pestaña Integraciones.
- Selecciona Explorar aplicaciones.
- Busca Shift4Shop, haz clic en la tarjeta y, después, en Instalar.
- Para encontrar la URL de tu tienda Shift4Shop (también conocida como tu URL segura), abre tu cuenta de Shift4Shop en una nueva pestaña.
- En Shift4Shop, ve a Settings > General > Store Settings.
- En Información de la tienda, haz clic en Administrar dominio y URL de la tienda.

- Copia la URL de la tienda desde debajo de Ajustes del dominio.

- De vuelta en Klaviyo, pega la URL de tu tienda en el cuadro y haz clic en Conectar a Shift4Shop.
- Copia la clave de API pública de Klaviyo que aparece en la siguiente página.

- Haz clic en el botón Ir a Shift4Shop.
- En la página REST API Apps de Shift4Shop, haz clic en Añadir en la esquina superior derecha para añadir la clave de API de Klaviyo.

- Pega la clave de API pública de Klaviyo que copiaste de la página de configuración de integraciones de Shift4Shop.

- Pulsa Guardar.
- Aparecerá una ventana emergente que te pedirá que des a Klaviyo autorización para extraer los datos de Shift4Shop a nuestra plataforma; haz clic en Autorizar.

- Se te redirigirá de vuelta a tu cuenta de Klaviyo. Un modal de confirmación indicará que tu cuenta de Shift4Shop está conectada y que el histórico de datos ha empezado a sincronizarse.
Añadir seguimiento en el sitio de Klaviyo
Hay 2 fragmentos de código de seguimiento onsite de Klaviyo que puedes añadir a tu sitio Shift4Shop. El primer fragmento de código de seguimiento onsite te permite hacer un seguimiento de cuándo los usuarios con cookies están activos en tu sitio (la métrica Activo en el sitio ) y el segundo fragmento de código de seguimiento onsite te permite hacer un seguimiento de qué productos ven (la métrica Producto visto ).
Luego puedes usar la métrica Active on Site para crear segmentos de navegadores identificados que han visitado tu sitio, pero no han comprado nada. El fragmento de código Active on Site (también conocido como Klaviyo.js) también permite usar el formulario de registro de Klaviyo.
El seguimiento de Viewed Product se utiliza con mayor frecuencia para activar un flujo automatizado de email de abandono de navegación. Para obtener más información, consulta nuestro artículo sobre crear un flujo de abandono de navegación.
- Inicia sesión en el panel de administración de tu tienda de Shift4Shop y dirígete a Content > Site Content.
- Haz clic en el botón Editar en Encabezado y pie de página.

- Haz clic en el + a la derecha de Encabezado global para abrir el editor de encabezados.

- Haz clic en el control deslizante junto a Modo WYSIWYG desactivado/activado para cambiar la vista al editor HTML.

- Para añadir el seguimiento Activo en el sitio, pega el siguiente script en la parte inferior del editor de HTML:
<script type="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/PUBLIC_API_KEY/klaviyo.js"></script>
<script type="text/javascript">
//Initialize Klaviyo object on page load
!function(){if(!window.klaviyo){window._klOnsite=window._klOnsite||[];try{window.klaviyo=new Proxy({},{get:function(n,i){return"push"===i?function(){var n;(n=window._klOnsite).push.apply(n,arguments)}:function(){for(var n=arguments.length,o=new Array(n),w=0;w<n;w++)o[w]=arguments[w];var t="function"==typeof o[o.length-1]?o.pop():void 0,e=new Promise((function(n){window._klOnsite.push([i].concat(o,[function(i){t&&t(i),n(i)}]))}));return e}}})}catch(n){window.klaviyo=window.klaviyo||[],window.klaviyo.push=function(){var n;(n=window._klOnsite).push.apply(n,arguments)}}}}(); </script>- En Klaviyo, haz clic en el nombre de tu cuenta y luego ve a Configuración > Claves de API y copia tu clave de API pública/ID del sitio. Sustituye
PUBLIC_API_KEYen la primera línea del fragmento por este valor. Usa aquí el ID del sitio de tu cuenta, no la clave de autorización de la aplicación copiada durante la configuración de las integraciones de Shift4Shop. - Para añadir el seguimiento de Producto visto, añade este script debajo del script Activo en el sitio en el encabezado:
<script type="text/javascript">
var klaviyo = window.klaviyo || [];
// Track each product view.
if ('[price]' !== '[' + 'price]') {
klaviyo.track("Viewed Product", {
ProductID: "[id]",
Name: "[name]",
Description: "[description]",
URL: [location.protocol, '//', location.host, location.pathname].join(''),
Categories: "[catid]",
ImageURL: [location.protocol, '//', location.host, '/[image1]'].join(''),
Price: parseFloat("[price]".slice(1), 10)
});
}</script>- En la esquina superior derecha de la página, haz clic en Guardar.
Después de guardar, prueba el seguimiento del sitio para confirmar que los eventos Active on Site y Viewed Product aparecen cuando un visitante identificado navega por tu sitio.
Supervisa la sincronización de Klaviyo
Para ver los datos de integración de Shift4Shop:
- En tu cuenta de Klaviyo, ve a Analytics > Metrics.
- Haz clic en la métrica Placed Order de Shift4Shop para comprobar que los datos han empezado a completarse. Los datos del gráfico muestran que los pedidos se están sincronizando, pero no significa que la importación histórica esté completa.
- Para comprobar el progreso de la importación histórica, ve a Integraciones > Shift4Shop > Datos y revisa Histórico de datos. Cuando finalice la importación, esta sección confirma que los datos se han sincronizado.

- Cuando finalice la importación histórica, compara una muestra de pedidos de Shift4Shop aptos con los eventos Placed Order en Klaviyo. De forma predeterminada, los pedidos con los estados 2 y 4 crean estos eventos, usando la hora de la última actualización del pedido.
- Si las fechas o los totales diarios difieren, comprueba que ambas cuentas usan la misma zona horaria. En Klaviyo, haz clic en el nombre de la cuenta y luego ve a Configuración > Cuenta.
- En la sección Zona horaria, selecciona la zona horaria correcta y haz clic en Guardar.
Datos sincronizados desde Shift4Shop
La integración de Shift4Shop sincroniza los datos en Klaviyo una vez cada hora. Los retrasos de la API o los límites de frecuencia pueden provocar que los eventos tarden más de 1 hora en aparecer.
Las siguientes métricas se sincronizan desde Shift4Shop:
- Pedido Cancelado
- Pedido Procesado
- Producto Pedido
- Pedido Realizado
- Pago iniciado

Pedido Cancelado
Este evento se rastrea cuando se cancela un pedido en Shift4Shop (estado 5). Incluye los artículos y las categorías del pedido.
Pedido Procesado
Este evento se rastrea cuando se completa un pedido en Shift4Shop (estado 4). Incluye toda la información del producto sobre los artículos que alguien compró, incluidos los nombres de los productos, las imágenes y la información de la variante, para usarla en emails de seguimiento de compras. Puedes filtrar y orientar los eventos de Pedido completado en función de los siguientes criterios:
- ItemNames: los nombres de los productos del pedido de alguien (por ejemplo, camiseta o pantalones)
- Categorías: el conjunto completo de las categorías de los productos del pedido de alguien (por ejemplo, camisetas, hombre, pantalones y oferta)
Producto Pedido
Esta métrica se registra cuando un pedido apto crea un evento de Pedido realizado, y registra un evento por cada unidad comprada, hasta 100 unidades por artículo en un pedido. Por ejemplo, si alguien compra una camiseta y un par de pantalones, se crean 2 eventos de Ordered Product: 1 para la camiseta y 1 para los pantalones.
El evento Ordered Product incluye información detallada sobre cada producto que compra alguien. Esto es útil al crear segmentos de comportamiento basados en nombres de producto individuales, SKU y categorías. Puedes filtrar y orientar los eventos de Producto Pedido en función de los siguientes criterios:
- Nombre: el nombre o el título del producto en Shift4Shop, por ejemplo, camiseta o pantalones
- SKU: el SKU de la variante del producto, p. ej., REDMEDIUMTSHIRT
- Categorías: el conjunto completo de categorías del producto (por ejemplo, camisetas, hombre y oferta)
Pedido Realizado
Se registra cuando un cliente completa el proceso de pago y crea un pedido en tu tienda de Shift4Shop. Incluye toda la información del producto sobre los artículos que alguien compró, incluidos los nombres de los productos, las imágenes y la información de variantes, para usarla en emails de seguimiento de compra. Puedes filtrar y orientar los eventos de Placed Order en función de los siguientes criterios:
- ItemNames: los nombres de los productos del pedido de alguien (por ejemplo, camiseta o pantalones)
- Categorías: el conjunto completo de las categorías de los productos del pedido de alguien (por ejemplo, camisetas, hombre, pantalones y oferta)
Nota: de forma predeterminada, Shift4Shop sincroniza 2 estados para Pedido realizado: 2, 4
Pago iniciado
Este evento se rastrea cuando Klaviyo sincroniza un proceso de pago o un pedido de Shift4Shop con una dirección de email de facturación válida y, de forma predeterminada, el estado 2, 4 o 7. Incluye toda la información del producto sobre los artículos del carrito de alguien, incluidos los nombres de los productos, las imágenes y la información de la variante para usarla en los emails de carrito abandonado. Puedes filtrar y orientar los eventos de Inicio de pago en función de los siguientes criterios:
- ItemNames: los nombres de los productos del carrito de alguien, p. ej., camiseta o pantalones
- Categorías: el conjunto completo de las categorías de los productos del carrito de alguien, por ejemplo, camisetas, hombre, pantalones y oferta
Datos de clientes
Además de las métricas, Klaviyo importa los detalles del cliente a partir de los pedidos. Puedes usar estas propiedades de perfil en segmentos y flujos. Las siguientes propiedades se sincronizan cuando están disponibles:
- Nombre
- Apellidos
- Phone Number
Klaviyo también puede estimar los siguientes detalles de ubicación a partir de la dirección IP proporcionada con un pedido. Estos no se copian de la dirección de facturación o de envío del pedido:
- City
- Estado o región
- Country
Resultado
Ya has integrado Shift4Shop, has habilitado el seguimiento onsite de Klaviyo y has verificado tus datos de Shift4Shop sincronizados. Ahora puedes ver tus datos de Shift4Shop en Klaviyo y personalizar y dirigir los emails en función de las compras y la actividad en el sitio web de cada cliente.
Actualiza tu integración de Shift4Shop
Si integraste Klaviyo con Shift4Shop antes del 12 de mayo de 2025 y no has actualizado la aplicación, sigue los pasos que se indican a continuación para cambiar a Klaviyo v2. La fecha límite para actualizar desde la aplicación anterior era el 6 de septiembre de 2025.
Para actualizar a Klaviyo v2, vuelve a autenticar la integración de Shift4Shop en Klaviyo. No necesitas reinstalar el seguimiento in situ de Klaviyo.
- En Klaviyo, haz clic en la pestaña integraciones.
- Selecciona Shift4Shop en la lista de integraciones habilitadas.
- En la esquina superior derecha, haz clic en Gestionar integraciones.
- Selecciona Volver a autenticar.
- Copia la clave de API pública de Klaviyo.
- Haz clic en el botón Ir a Shift4Shop.
- En la página Apps de API REST de Shift4Shop, haz clic en Añadir para añadir la clave de API de Klaviyo y pega la clave.
- Pulsa Guardar.
- En el modal de solicitud de autorización que aparece, haz clic en Autorizar.
- Se te redirigirá de nuevo a tu cuenta de Klaviyo, donde una ventana modal de confirmación indicará que tu cuenta de Shift4Shop ya está conectada.
Tus integraciones se han actualizado y empezarán a usar la nueva aplicación.
Aunque no es necesario, puede que quieras eliminar la aplicación obsoleta de Klaviyo de tus Aplicaciones conectadas en Shift4Shop. Para hacerlo, elimina la aplicación «Klaviyo» de la página de aplicaciones de la API REST de Shift4Shop.
Recursos adicionales
- Introducción al seguimiento en el sitio de Klaviyo
Descubre las diferentes formas en las que Klaviyo puede ayudarte a hacer un seguimiento de tu sitio web de comercio electrónico. Hay dos tipos fundamentales de seguimiento:
- Cómo actualizar Klaviyo después de cambiar de plataformas de comercio electrónico
Descubre las áreas de Klaviyo que deben actualizarse cuando cambias de una plataforma de comercio electrónico a otra. Es totalmente posible cambiar de plataforma de comercio electrónico manteniendo la misma cuenta de Klaviyo, pero hay algunos pasos importantes que debes tener en cuenta para asegurarte de que tus formularios de registro, flujos y otras funciones de Klaviyo sigan rindiendo como esperas.