Mage Loyalty ayuda a las tiendas Shopify a gestionar recompensas de puntos o crédito de tienda, niveles VIP, referencias y listas de deseos. Conecte Mage Loyalty a Omnisend para utilizar información de lealtad en segmentos y mensajes, y comience flujos de trabajo de automatización a partir de la actividad de lealtad.
Beneficios
Crea audiencias por puntos disponibles o crédito de tienda y nivel VIP.
Personaliza campañas y automatizaciones con el saldo de lealtad actual de un cliente.
Haz un seguimiento cuando los clientes ganen recompensas o canjeen un descuento.
Utiliza eventos opcionales de referencia, cumpleaños y lista de deseos cuando estén configurados en Mage.
Antes de empezar
Instala Mage Loyalty en tu tienda Shopify y configura tu programa de lealtad.
Necesitas el plan Esencial de Mage o superior para la integración de Omnisend.
Necesitas acceso a la tienda Shopify y a la marca de Omnisend que deseas conectar.
Proceso de Configuración
Paso 1. Crea una clave API de Omnisend.
En Omnisend, selecciona la marca que deseas conectar.Ve a Configuración de la tienda API Claves API y crea una clave dedicada con permisos de Contactos: leer y escribir y Eventos: leer y escribir.Copia la clave completa y mantenla privada.
Paso 2. Conectar Mage Loyalty
En tu administrador de Shopify, abre Apps Mage Loyalty Integraciones Omnisend.Pega la clave en Clave API de Omnisend y haz clic en Guardar Clave API.Verifica que la integración muestre Conectado.
4A1 Para las instrucciones de configuración de Mage, consulta Cómo configurar la integración de Omnisend.
Paso 3. Elige tus eventos
En la página de Omnisend de Mage, revisa Configuración de Eventos y selecciona los eventos que deseas utilizar.Los cambios se guardan automáticamente.Los programas de crédito de tienda utilizan Crédito de Tienda Otorgado, Crédito de Tienda Pendiente y Crédito de Tienda por Expirar Pronto en lugar de los eventos de puntos correspondientes.
Los eventos de referencia y lista de deseos requieren sus características de Mage asociadas y configuraciones de eventos.Las alertas de la lista de deseos también requieren que el proveedor de alertas de la lista de deseos esté configurado en Omnisend.Habilita solo los eventos que planeas usar.
Paso 4. Verifica la conexión
Utiliza Enviar Evento de Prueba en Mage con un Correo electrónico que controles para enviar datos de muestra.
En Omnisend, ve a Audiencia → Contacto, encuentra esa dirección de correo electrónico y abre el evento bajo actividad de Contacto → detalles del evento.A continuación, gana crédito o canjea una recompensa a través de tu tienda utilizando un cliente de prueba.Verifica que el saldo del Contacto se actualice y que aparezca el evento correspondiente.
Si el modo de prueba Test Mode de Mage está habilitado, solo los clientes de prueba listados generan eventos.Revisa la guía del Modo de Prueba de Mage antes de probar.
Qué datos se envían
Mage empareja a los clientes por Correo electrónico y escribe sus propias propiedades de lealtad en los contactos de Omnisend.Las propiedades se actualizan cuando los puntos, el nivel o las recompensas de un Cliente cambian.
Propiedades de Contacto
Programas de puntos: magePointsBalance,mageLifetimePoints, ymagePuntosRedimidos.
Programas de crédito de Tienda: mageStoreCreditBalance (moneda formateada),mageStoreCreditBalanceValue (número),mageLifetimeStoreCredit, y mageRedeemedStoreCredit.
Información VIP: mageVipTierName,mageNextVipTierName, ymageAmountToNextVipTier.
Fechas: inscripción, última sincronización y cumpleaños donde se proporcionen.
Algunas propiedades dependen de la configuración de su programa o del Plan de Mage.Consulta la referencia completa de propiedades y eventos de Mage para los campos disponibles.
Eventos de Lealtad
Puntos Otorgados / Crédito de Tienda Otorgado: una acción de ganancia aprobada. Los premios de crédito de tienda incluyen Crédito Otorgado, Valor de Crédito Otorgado, Regla de Ganancia y Estado.
Recompensa Canjeada: un cliente gasta puntos o crédito de tienda en una recompensa. Los detalles incluyen Nombre de la Recompensa, Tipo de Descuento, Código de Descuento donde se emitió y el saldo después del canje. Para programas de crédito de tienda, el Crédito Gastado está formateado en la moneda de su tienda, mientras que los Puntos Gastados contienen el monto en centavos. Por ejemplo, un canje de $1.00 envía Crédito Gastado $1.00 y Puntos Gastados 100.
Cambio de Nivel VIP: el nivel cambia cuando se habilitan los niveles VIP; consulte la referencia de Mage para el comportamiento y los campos de activación admitidos.
Eventos opcionales: recompensas pendientes o que están por expirar, referencias, cumpleaños, bienvenida, reembolso, desafíos fotográficos, recordatorios de regalos y alertas de lista de deseos, dependiendo de las características habilitadas.
Usar Datos de Lealtad en Omnisend
Crear un Segmento de Lealtad
Ir a Audiencia Segmentos y usar una propiedad personalizada de Mage como filtro.Por ejemplo, dirígete a un nivel VIP con mageVipTierName, o a clientes con crédito disponible usando el numérico mageStoreCreditBalanceValue.
📝 Aprende más: Contacto Propiedades Personalizadas.
Personaliza un Mensaje
En tu campaña o mensaje de automatización, elige un campo de Mage bajo Personalización → Propiedades personalizadas.
Por ejemplo, usa [[contact.custom_properties.mageStoreCreditBalance]] para un saldo formateado o [[contact.custom_properties.mageVipTierName]] para el nivel actual.Agrega un valor por defecto para contactos cuya propiedad esté vacía.
🔋 Sigue Usar Personalización en Omnisend.
Construir Automatización activada por Eventos
Usa eventos de Mage para enviar mensajes cuando un cliente gana crédito de tienda o canjea una recompensa.
Ve a Automatización → Crear flujo de trabajo → Crear desde cero y selecciona el evento de Mage que deseas activar el flujo de trabajo (el evento estará disponible después de que Omnisend lo reciba por primera vez).
Agrega un correo electrónico al flujo de trabajo, luego usa Personalización → Evento para incluir detalles de ese evento.Por ejemplo:
Tienda Crédito Otorgado: incluyeCrédito Otorgado para informar a los clientes cuánto crédito han ganado.
Recompensa Canjeado: incluyeRecompensa Nombre yDescuento Código para que los clientes puedan usar su recompensa. Para programas de crédito de tienda, también puedes incluirCrédito Gastado.
Estos detalles del evento están disponibles solo en flujos de trabajo activados por el evento correspondiente.Para personalizar una campaña regular con el saldo o nivel de lealtad actual de un cliente, usa sus propiedades de contacto sincronizadas en su lugar.
📝 Para más información sobre cómo configurar disparadores de eventos y usar campos de eventos, consulta Crear y Gestionar Eventos Personalizados en Omnisend.
FAQ
¿Por qué faltan propiedades de lealtad?
Los clientes sin actividad de lealtad desde la conexión pueden no tener propiedades de Mage aún.Verifica el correo electrónico del cliente, la marca conectada y los permisos de la clave API, luego inspecciona un cambio de lealtad soportado.
Un evento de lealtad crea o actualiza el contacto en Omnisend.Los nuevos contactos se agregan como no suscriptores.Una actualización solo de propiedad requiere que el contacto ya exista en Omnisend.
¿Puedo sincronizar miembros de lealtad existentes?
No asumas que conectar importa automáticamente todos los datos históricos de lealtad.La actual guía de importación CSV de Mage describe la sincronización masiva asistida por el proveedor en Omnisend.Contacta a Mage si necesitas una sincronización masiva de miembros existentes.
¿Por qué aparece un evento sin un correo electrónico?
Verifica que el flujo de trabajo de Omnisend correspondiente esté activo y que su disparador, filtros de audiencia y configuraciones de mensaje permitan que el contacto entre y reciba el mensaje.En Mage, también confirma que el evento esté habilitado.Para un premio de crédito manual, selecciona Enviar notificación de crédito de tienda ganado cuando pretendas activar la notificación configurada.
¿Cómo me desconecto?
Abre Mage Lealtad → Integraciones → Omnisend y haz clic en Desconectar para detener la sincronización futura.
Para configuraciones del programa Mage, importaciones o preguntas de conexión, contacta a soporte de Mage.Para ayuda con contactos, segmentos o flujos de trabajo de Omnisend, contacta a nuestro equipo de Soporte a través del chat en la aplicación o en [email protected].Estamos disponibles 24/7.

