Cómo integrarse con OpenCart

Qué aprenderás

Aprenda a integrar OpenCart con Klaviyo. Una vez completados estos pasos, podrá personalizar y dirigir los correos electrónicos en función de la compra y la actividad en el sitio web de cada cliente. La integración con OpenCart se sincroniza cada hora.

Información importante antes de empezar 

Tenga en cuenta que Klaviyo no sincroniza su catálogo desde OpenCart.

Añadir la integración OpenCart

El proceso de añadir la integración OpenCart de Klaviyo es de varios pasos y requiere tomar acciones dentro de ambos OpenCart y Klaviyo.

Para empezar, Klaviyo actualmente soporta OpenCart 1.4.x y 1.5.x. Descargue el módulo OpenCart de Klaviyo desde aquí: https://www.klaviyo.com/media/downloads/OpenCartKlaviyo-1.1.0.tgz.

1. Descomprima el archivo en la raíz de su instalación de OpenCart.
2. Acceda a la sección de administración de OpenCart y vaya a la página Extensiones > Módulos.
3. Instale el módulo Klaviyo y luego haga clic en Editar para el módulo Klaviyo.
4. Lo último que debe hacer con su instalación de OpenCart es copiar y pegar el siguiente código PHP al final del `upload/index.php`, justo antes de la línea `$response->getOutput();`:

   // [Klaviyo] Guardar carrito de cliente si existe.
   if ($registry->get('carrito')->hasProducts()) {
     $registry->get('cargar')->model('modulo/klaviyo');
   
     if ($registry->get('customer')->isLogged()) {
       $registry->get('model_module_klaviyo')->saveCustomerCart(
         session_id(),
         $registry->get('customer')->getId(),
         $session->data['cart']
       );
     } else if (array_key_exists('guest', $session->data)) {
       $registry->get('model_module_klaviyo')->saveGuestCart(
         session_id(),
         $session->data['guest'],
         $session->data['cart']
       );
     }
   }

5. En Klaviyo, selecciona la pestaña Integraciones.
6. Haz clic en Añadir integraciones y busca OpenCart, luego haz clic en la tarjeta. Luego, haz clic en Instalar.
7. Accederá a una página de configuración de la integración . En la página de configuración, introduzca la URL de su sitio OpenCart y haga clic en Conectar con OpenCart.
   
8. En la página siguiente, copie la clave API bajo el módulo K laviyo OpenCart y péguela en la configuración del módulo Klaviyo en OpenCart. Guarde la configuración del módulo Klaviyo en el admin de OpenCart.
   
9. Si lo desea, marque la opción Añadir nuevos clientes de OpenCart a una lista de Klaviyo y seleccione una lista en el desplegable.
10. De vuelta en Klaviyo, haga clic en Completar configuración para empezar a sincronizar los datos.

Instale el seguimiento in situ de Klaviyo

Para rastrear la actividad en el sitio en OpenCart, primero encuentre su clave API pública de Klaviyo ingresando a su cuenta, haciendo clic en el nombre de su cuenta en la esquina inferior izquierda y navegando a Configuración > Claves API. Su clave pública tiene seis caracteres. Puede instalar dos tipos de seguimiento in situ:

• Activo en el sitio
  Esta métrica se rastrea cada vez que un navegador identificable visita su sitio web.
• Producto visto
  Esta métrica se rastrea cada vez que un navegador identificable ve una página de producto en su sitio web.

Añadir "Activo en el sitio" seguimiento

Esta métrica se rastrea cada vez que un navegador identificable visita su sitio web. Para iniciar el seguimiento de la actividad Activo en el sitio:

1. Añada el siguiente fragmento de código a la plantilla principal de su tienda para que se incluya en todas las páginas. Debe colocar este fragmento junto a otros scripts de análisis que utilice o justo antes de la </body>etiqueta de cierre</body >:
   

   <script type="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=PUBLIC_API_KEY"></script>
   <script type="text/javascript"> 
   //Inicializar el objeto Klaviyo al cargar la página
   !function(){if(!window.klaviyo){window._klOnsite=window._klOnsite||[];try{window.klaviyo=nuevo 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]=argumentos[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>
   

2. Asegúrese de sustituir PUBLIC_API_KEY por la clave de la API pública de su cuenta de Klaviyo.
3. Si los visitantes o clientes pueden crear cuentas para su tienda, añada el siguiente fragmento directamente debajo del primer fragmento:

   <script type="text/javascript">
     var klaviyo = window.klaviyo || [];
     {% if user.is_logged_in %}
     klaviyo.identify({
       $email: '{{ user.email }}',
       $nombre: '{{ user.first_name }}',
       $apellido: '{{ user.last_name }}'
       });
     {% endif %}
   </script>

4. Dependiendo de los tipos de plantillas que utilice para su sitio web, es probable que la sintaxis {% if user.is_logged_in %} y {{ user.email }} sean diferentes. Utilizando el idioma de plantilla disponible, desea comprobar si la persona que está viendo la página actual ha iniciado sesión. En caso afirmativo, deberá indicar su dirección de correo electrónico y su nombre, si están disponibles. Si no tiene información sobre el nombre, elimine esas dos líneas y la coma final después de la línea $email.

Añadir "Producto visto" seguimiento

Si desea configurar un flujo de abandono de navegación o construir segmentos basados en datos de navegación de productos, querrá añadir un seguimiento de eventos JavaScript para una métrica "Viewed Product".

1. En la plantilla de su página de producto, añada el siguiente fragmento:

   <script type="text/javascript">
       var klaviyo = window.klaviyo || [];
       klaviyo.track("Visto Producto", {
         Título: '{{ product.title }}',
         ItemId: {{ product.id }},
         Categorías: {{ category in product.categories|json }}, // La lista de categorías es una matriz de cadenas. 
         ImageUrl: '{{ product.image_url }}',
         Url: '{{ product.url }}',
         Metadatos: {
           Marca: '{{ product.brand }}',
           Precio: {{ product.price }},
           CompararPrecio: {{ product.compare_at_price }} // Si tiene un comparar a precio. También podría incluirlo para una venta o precio especial.
         }
     });
   </script>

2. El fragmento anterior utiliza la sintaxis de marcador de posición {{ }} que puede ser diferente para su tienda OpenCart. Lo importante es que los campos de producto se renderizan dinámicamente en función de la página de producto que esté viendo.
3. Una vez configurado el seguimiento de productos vistos para su sitio, los datos de productos vistos deberían empezar a aparecer en su cuenta de Klaviyo a medida que los visitantes conocidos navegan por las páginas de sus productos.

Cómo funciona el seguimiento in situ

Cuando añade el seguimiento web de Klaviyo a su sitio, sólo podemos rastrear la actividad de navegación de los navegadores conocidos de "" , es decir, los navegadores que han visitado y participado al menos una vez antes. Existen dos formas principales de identificar a un visitante del sitio con fines de seguimiento web:

• Si alguien, en algún momento, ha hecho clic a través de un correo electrónico Klaviyo a su sitio web
• Si alguien, en algún momento, se ha suscrito/optado a través de un formulario de Klaviyo

Klaviyo no rastreará navegadores anónimos.

Supervise la sincronización de Klaviyo

El tiempo que tardará en sincronizar todos los datos históricos de clientes y pedidos de su tienda OpenCart dependerá del tamaño de su tienda. Una vez completada esta sincronización histórica, verá un borde verde alrededor de su integración OpenCart bajo Integraciones habilitadas.

Para comprobar su integración:

1. Navegue hasta la pestaña Métricas de su cuenta, que se encuentra en Análisis. Aquí puede filtrar para ver todas las métricas de OpenCart. Busque la métrica de pedidos realizadosde OpenCart y haga clic en el icono Activity Feed. Si su integración ha comenzado a sincronizar los datos, empezará a ver que los eventos de Pedido realizado aparecen aquí.
2. Sincronizaremos automáticamente todos los datos históricos de los pedidos. Para comprobarlo, puede comparar el número de eventos de un día concreto en Klaviyo con lo que aparece en su interfaz de OpenCart y confirmar que coinciden.
3. Por ejemplo, al explorar la métrica Pedidos realizados, puede pasar el ratón por encima del punto de datos de ayer o mirar la tabla de datos que hay debajo del gráfico para ver cuántos pedidos se registraron ayer.
4. Compare ese número con el almacenado en OpenCart desde ayer y debería ver que coinciden exactamente. Si no lo hacen, lo más probable es que el problema sea que la zona horaria de su cuenta de Klaviyo no coincide con la zona horaria que ha establecido en OpenCart.

5. Para comprobar o actualizar la zona horaria de tu cuenta:

   • Haz clic en el nombre de tu organización en la parte inferior izquierda.

   • Selecciona Configuración.
   • Vaya a la pestaña Organización . 

Datos sincronizados desde OpenCart

• Datos de ventas y pedidos
  Qué productos se compraron, incluidos los detalles y las imágenes de los productos.
• Información del cliente
  Nombre, apellidos, ubicación y grupo de clientes.
• Inicio de los datos de pago
  Se utiliza para activar los correos electrónicos de Carrito Abandonado. Esto se activa mediante el fragmento de código PHP que añadió al realizar la integración.
• Datos de pedidos cumplimentados
  Se utiliza para hacer un seguimiento de cuándo se envían los pedidos.
• Seguimiento in situ
  Cuando la gente visita su sitio web

Para sus métricas de OpenCart, navegue a Analytics > Metrics en Klaviyo, donde puede filtrar por OpenCart.

Por defecto, Klaviyo sincroniza los siguientes estados para las métricas Pedido realizado y Pedido cumplido:

• Pedido realizado: Pendiente, Procesado, En proceso, Enviado, Completo
• Pedido cumplido: Enviado, Completo

Recursos adicionales

• Con qué frecuencia se sincronizan las integraciones de referencia
• ¿Necesita más ayuda para integrarse con Klaviyo? Eche un vistazo a las agencias asociadas de Klaviyo