Cómo configurar cupones (para Magento 1.x)
La integración de Magento 1 de Klaviyo ya no acepta nuevas instalaciones y alcanzará el final total del soporte a finales de 2027. El equipo de soporte de Klaviyo ya no puede ayudar con las solicitudes relacionadas con Magento 1.
Qué aprenderás
Magento admite reglas de precios del carrito de compra que se pueden usar para aplicar un descuento al pedido de un cliente. Se pueden crear códigos de cupón para las reglas de precios existentes, de modo que los compradores puedan aprovechar fácilmente un código determinado para aplicar un descuento durante el proceso de pago.
La función de cupones de Klaviyo para Magento permite que las tiendas de Magento 1.0 hagan lo siguiente:
- Crea nuevos cupones en Klaviyo asociados a reglas de precios ya existentes en Magento.
- Incluye cupón único en los emails de flujo para que cada destinatario reciba un código único.
Esta guía explicará cómo configurar cupones de Magento en Klaviyo.
Los códigos de cupón único no están disponibles actualmente al enviar emails de campaña. Enviar cupones únicos en una campaña requeriría generar miles de códigos por segundo. Klaviyo no puede garantizar que la configuración de limitación de tasa de un servidor específico de Magento no afecte a la generación de cupones únicos a este volumen y velocidad. Debido a esto, los cupones únicos solo están disponibles al enviar emails de flujo.
Requisitos
Como requisito previo, asegúrate de haber habilitado la integración de Magento en Klaviyo e instalado la extensión de Klaviyo en Magento.
Habilitar la API REST
Empieza por habilitar la API de REST creando un nuevo rol de REST y otorgándole acceso completo, y luego asigna el rol a uno de tus usuarios administradores.
- Haz clic en System > Web Services > REST - Roles.
- Crea un rol de Administrador nuevo. En el campo Role Name, introduce un nombre, por ejemplo, «Administrator».
- Haz clic en la pestaña Recursos de API de rol de la izquierda. Configura Acceso a recursos en Todo y haz clic en Guardar rol.
- A continuación, ve a Sistema > Servicios web > REST - Atributos.
- Selecciona Administrador en la lista de tipos de usuario.
- Configura Resource Access en Todos y haz clic en Guardar.
- A continuación, ve a Sistema > Permisos > Usuarios.
- Selecciona un usuario administrador de la lista y haz clic en Editar usuario.
- Haz clic en la pestaña rol de REST en la barra lateral izquierda.
- Haz clic en el botón de opción para asignar a tu usuario el nuevo rol de administrador de REST.
- Pulsa Guardar usuario.
Ya has habilitado la API REST para tu tienda Magento.
Si no estás seguro de si tu API de REST está configurada correctamente, revisa los pasos descritos en nuestro recurso sobre la solución de problemas de cupón para Magento 1x.
Generar credenciales REST en Magento
Para habilitar la función de cupones de Magento de Klaviyo, primero genera credenciales de la API REST desde tu tienda de Magento con la cuenta de administrador de REST que acabas de crear y, a continuación, pégalas en tu cuenta de Klaviyo.
- Inicia sesión como el usuario administrador de REST que creaste en la sección Habilitar la API de REST anterior
- Haz clic en Sistema > Configuración y, a continuación, haz clic en Klaviyo en la sección Clientes.
- Haz clic en Generar tokens OAuth.
Se completarán la Consumer Key, Consumer Secret, Authorization Token y el Authorization Secret. Copiarás y pegarás estos valores en tu cuenta de Klaviyo en el siguiente paso.
Configurar cupones de Magento en Klaviyo
- Desde tu cuenta de Klaviyo, ve a tu integración de Magento.
- Haz clic en la flecha Opciones avanzadas para expandir la Configuración del cupón.
- Pega las credenciales REST que has creado arriba.
Tu servidor de Magento debe ser compatible con firmas HMAC-SHA1 para la autenticación OAuth.
- Haz clic en Actualizar la configuración de Magento.
Klaviyo validará tus credenciales REST y podrás empezar a crear cupón con la pestaña Cupón de tu cuenta.
Crear un cupón de Magento en Klaviyo
Cuando accedas por primera vez a la pestaña cupón en tu cuenta de Klaviyo después de proporcionar tus credenciales REST, verás el mensaje: «Todavía no has añadido ningún cupón».
Antes de crear un nuevo cupón, primero deberás definir una regla de precios en Magento que incluya todas las especificaciones del cupón. Las reglas de precios no se pueden crear desde Klaviyo. Un nuevo cupón creado en Klaviyo debe hacer referencia a una regla de precios ya existente en Magento.
Al crear una regla de precios en Magento, ten en cuenta que la opción de asociar una nueva regla de precios a un cupón específico debe dejarse configurada como Specific Coupon y debes tener seleccionada la casilla Use Auto Generation.
- Haz clic en Añadir cupón para crear un nuevo cupón.
- Rellena la siguiente información: Nombre del cupón y el ID de regla de Magento.
- Nombre del cupón: El nombre que especifiques solo puede incluir letras, números y guiones bajos, y puede tener hasta 32 caracteres
- ID de regla de Magento: Crea primero una regla en Magento y pega aquí el ID de esa regla para asociarla con este cupón
Todos los cupones creados aparecerán con los siguientes detalles generales:
- Nombre del cupón: Nombre del cupón
- Periodo activo: hay las siguientes opciones:
- Activo, sin caducidad
- Fecha A: sin caducidad
- Fecha A - Fecha B
- Activo, fecha de caducidad B
- Fecha de creación: Fecha en que se creó el cupón
- Fecha de la última actualización: Fecha en la que se actualizó el cupón por última vez
Los cupones se pueden editar y eliminar desde esta pestaña mediante el menú desplegable de la parte derecha.
Usar un cupón de Magento en un email de flujo
Una vez que se crea un cupón, puedes insertarlo en un email de flujo usando la siguiente variable de marcador de posición. Solo puedes añadir 1 código de cupón por email. Puedes mostrar el mismo código de cupón en varios lugares, pero no puedes usar varios códigos.
{% coupon_code 'CouponName' %}Sustituye CouponName por el nombre de tu cupón. Por ejemplo:
Usar cupones únicos en mensajes de flujo SMS
Los cupones únicos también están disponibles para tus mensajes SMS/MMS en flujos. Los códigos se generan igual que para el email. Después, usa la etiqueta de plantilla que se indica a continuación para añadir el código de cupón a tu mensaje SMS o MMS:
{% coupon_code 'CouponName' %}.
En el fragmento, cambia CouponName por el nombre del cupón que quieras y añádelo al mensaje (ya sea de flujo o de campaña).
A diferencia de lo que ocurre con los emails, solo puedes usar un código de cupón por mensaje SMS. Con el email, tienes acceso a bloques ocultos para enviar cupones distintos en función de dónde viva alguien o de lo que haya hecho. Si intentas añadir varios cupones a un mensaje SMS, verás un mensaje de error.
Solución de errores
Mensaje de error: «No se puede conectar a la API REST con las credenciales de REST especificadas. Comprueba que estas credenciales sean válidas en el administrador de Magento».
Si estás viendo este mensaje de error en Klaviyo, hay dos posibles causas raíz:
- Tu servidor de Magento no está configurado para admitir firmas HMAC-SHA1 para la autenticación OAuth.
- Puede que no hayas habilitado el acceso completo a los roles para la API REST.
Para resolver este problema, habilita las firmas HMAC-SHA1 para la autenticación OAuth en tu servidor Magento. Después, completa los siguientes pasos para actualizar tus permisos REST:
- Quita los comentarios o añade la regla de reescritura en tu archivo .htaccess . Esta es la línea que querrás asegurarte de que esté sin comentar:
RewriteRule ^api/rest api.php?type=rest [QSA,L] - Vuelve a comprobar que tu rol de REST está configurado correctamente
En nuestra guía para configurar cupón para Magento en la sección enlazada aquí se explican las instrucciones para hacerlo. - Otra causa habitual es que varios módulos de Apache pueden eliminar el encabezado «Authorization: Basic base64 (user:password)».
Consulta esta publicación para obtener más información
Los códigos de cupón que Klaviyo añade a los emails no son únicos: parece que todos los destinatarios reciben el mismo código.
Al crear una regla de precio en Magento, la opción para asociar una nueva regla de precio con un cupón específico debe mantenerse configurada en «Specific Coupon» y debes tener seleccionada la casilla «Use Auto Generation».
Haz clic en tu regla de precios en Magento y, en Información general, desplázate hacia abajo hasta la opción de línea «Cupón» y cambia esta configuración a «Cupón específico». A continuación, marca la casilla de generación automática aquí. Esto debería solucionar el problema y permitirnos generar un nuevo código de cupón único para cada destinatario del email.