Conecta Shopify a OneSignal a través de la integración Vendo para notificaciones push web, etiquetas de clientes, eventos de comercio y segmentación por comportamiento.
OneSignal se ha asociado con Vendo para crear una integración de Shopify perfecta. Vendo despliega el SDK de OneSignal en tu tienda de Shopify con un solo clic — sin necesidad de editar manualmente el código del tema. Sincroniza etiquetas de clientes, eventos de navegación del lado del cliente y eventos de comercio del lado del servidor a OneSignal para que puedas crear segmentos y desencadenar campañas push basadas en comportamiento real e historial de compras.Para la documentación de Vendo, consulta Vendo OneSignal Destination.
No uses https://your-site.myshopify.com/ si los clientes acceden a tu sitio a través de un dominio personalizado como https://your-site.com/.
Default Icon URL: Sube una imagen PNG o JPG cuadrada de 256x256px para los prompts y mensajes de notificación. Si no se configura, se usa un ícono de campana.
3
Configurar la ruta del service worker
Shopify no permite servir archivos desde la raíz del sitio, por lo que debes indicarle a OneSignal dónde sirve Vendo el archivo service worker.En OneSignal, ve a Settings > Push & In-App > Web Settings, desplázate hasta Advanced Push Settings y configura:
Ajuste
Valor
Service Worker Path
/apps/vendo/
Service Worker Filename
OneSignalSDKWorker.js
Updater Filename
OneSignalSDKWorker.js
Service Worker Registration Scope
/apps/vendo/
Configuración del service worker para tiendas Shopify que usan Vendo.
Vendo sirve automáticamente el archivo OneSignalSDKWorker.js requerido en https://yourstore.myshopify.com/apps/vendo/OneSignalSDKWorker.js — no se necesitan cargas manuales de archivos.
El Updater Filename y el Service Worker Filename son el mismo archivo. OneSignal v16+ usa un único service worker para ambos propósitos.
4
Copiar tus credenciales
En OneSignal, ve a Settings > Keys & IDs y copia tu App ID y REST API Key. Los ingresarás en Vendo.
Instala la aplicación Vendo desde el Shopify App Store.
2
Agregar la integración OneSignal
En Vendo, navega a Integrations > Add Integration > OneSignal (o Destinations > OneSignal).
Agregar la integración OneSignal en Vendo.
3
Ingresar tus credenciales de OneSignal
Ingresa tu App ID y REST API Key de OneSignal de la sección anterior, luego haz clic en Save.
4
Activar el bloque de tema Vendo
El bloque de tema Vendo carga el SDK de OneSignal en tu tienda. Sin él, el prompt de push no aparecerá y el seguimiento del lado del cliente no funcionará.
En tu administrador de Shopify, ve a Online Store > Themes > Customize.
Haz clic en App embeds (ícono de pieza de rompecabezas en la barra lateral izquierda).
Activa Vendo.
Haz clic en Save.
El bloque de tema gestiona la inicialización del SDK, el registro del service worker, la visualización del prompt push, la identificación de usuarios (suscripción push, inicio de sesión, registro en newsletter) y la sincronización de etiquetas.
5
Seleccionar eventos a sincronizar
En la aplicación Vendo bajo OneSignal > Events, activa los eventos del lado del cliente y del servidor que deseas enviar a OneSignal. Consulta Seguimiento a continuación para la lista completa de eventos.
6
Sincronización de datos históricos (opcional)
Vendo puede rellenar retroactivamente clientes existentes e historial de pedidos recientes en OneSignal. Esto ocurre automáticamente en segundo plano después de guardar tus credenciales.
Opciones de sincronización de datos históricos en Vendo.
Vendo utiliza un enfoque solo para usuarios identificados — los visitantes anónimos no se rastrean en OneSignal. Los usuarios deben identificarse a través de uno de cuatro métodos antes de que se envíen los eventos. Esto evita usuarios duplicados y garantiza datos limpios y accionables.
Método
Cómo funciona
Identificador usado
Suscripción push web
El visitante hace clic en “Permitir” en el prompt push. OneSignal crea un usuario automáticamente y Vendo captura el ID de OneSignal.
OneSignal ID
Registro en newsletter
El visitante envía un formulario de newsletter o correo electrónico. Vendo captura el email y llama a OneSignal.login(email).
Email
Inicio de sesión del cliente
El cliente inicia sesión en su cuenta de Shopify. Vendo lo detecta y llama a OneSignal.login() con el identificador configurado.
Shopify Customer ID o Email
Compra completada
El cliente completa una compra. Vendo almacena el identificador y llama a OneSignal.login().
Shopify Customer ID o Email
Si tienes una aplicación móvil o conexiones de terceros, selecciona el identificador (Shopify Customer ID vs. Email) que coincida con tus otras herramientas para que los perfiles de usuario permanezcan consistentes entre plataformas. Configúralo en la aplicación Vendo bajo Settings > Customer Identifier.
Si un suscriptor push (identificado por el ID de OneSignal) luego inicia sesión o completa una compra, Vendo llama a OneSignal.login() con su Shopify Customer ID o email. OneSignal vincula la suscripción push al usuario identificado — no se crean usuarios duplicados. Todas las suscripciones push anteriores se conservan, y los eventos del lado del servidor (pedidos, cumplimientos) llegan al perfil de usuario correcto.
Vendo sincroniza las propiedades del cliente como etiquetas en OneSignal para segmentación. Todos los valores se almacenan como cadenas (formato nativo de OneSignal).
Vendo rastrea eventos personalizados del lado del cliente en tu tienda a través del Shopify Web Pixel y los envía a OneSignal. Estos eventos solo se envían después de que un usuario es identificado.
Evento
Descripción
page_viewed
El cliente visita una página (tienda, checkout o estado de pedido)
product_viewed
El cliente ve una página de detalles de producto
collection_viewed
El cliente ve una página de colección de productos
search_submitted
El cliente realiza una búsqueda en la tienda
product_added_to_cart
Un producto se agrega al carrito
product_removed_from_cart
Un producto se elimina del carrito
cart_viewed
El cliente ve la página del carrito
checkout_started
El cliente inicia el proceso de pago
checkout_contact_info_submitted
Paso de información de contacto enviado
checkout_address_info_submitted
Paso de información de dirección enviado
checkout_shipping_info_submitted
Método de envío seleccionado
payment_info_submitted
Detalles de pago enviados
checkout_completed
Pago completado exitosamente
Configuración de eventos del lado del cliente en Vendo.
Los eventos de comercio de Shopify se exportan y reenvían a OneSignal a través del pipeline de Vendo. Estos siempre usan el Shopify Customer ID como external_id.
Evento
Descripción
received_orders
Se crea un nuevo pedido
fulfilled_orders
El pedido está cumplido/enviado
delivered_orders
El pedido está entregado
refunded_orders
El pedido está completamente reembolsado
partially_refunded_orders
El pedido está parcialmente reembolsado
abandoned_checkouts
El checkout es abandonado
Configuración de eventos del lado del servidor en Vendo.
Crea un Journey desencadenado por el evento abandoned_checkouts. Espera 1 hora después del abandono, luego envía una notificación push con el enlace de recuperación usando la propiedad checkout_url.
Crea Journeys para fulfilled_orders y delivered_orders para enviar notificaciones push inmediatas con información de seguimiento cuando los pedidos se envían y llegan.
OneSignal funciona con las siguientes fuentes de datos de Vendo:
Fuente
Eventos
Etiquetas de usuario
Audiencias
Shopify
Sí
Sí
Sí
Stripe
Sí
Sí
Sí
Mixpanel
—
—
Sí
Segment
—
—
Sí
Amplitude
—
—
Sí
Los eventos y etiquetas de usuario requieren Shopify o Stripe como fuente de datos. Los segmentos de audiencia se pueden construir a partir de cualquier dato fuente en tu conjunto de datos de BigQuery.
Visita https://yourstore.myshopify.com/apps/vendo/OneSignalSDKWorker.js en tu navegador. Deberías ver código JavaScript. Si obtienes un 404, verifica que la aplicación Vendo esté instalada.También puedes abrir el DevTools del navegador (F12), ir a Application > Service Workers y confirmar que OneSignalSDKWorker.js está registrado con un scope de /apps/vendo/.
2
Probar el prompt push
Abre tu tienda en una ventana de navegación incógnito/privada. Deberías ver el prompt de permiso de notificación de OneSignal. Haz clic en Permitir para suscribirte.
3
Enviar una notificación de prueba
En el panel de OneSignal, ve a Messages > Push > New Message. Envía una notificación de prueba a tu suscriptor y verifica que aparezca.
4
Verificar datos de usuario en OneSignal
Ve a Audience > Subscriptions y confirma que tu suscripción de prueba aparece. Verifica que las etiquetas de usuario (email, nombre, etc.) se están sincronizando para usuarios identificados.
5
Desencadenar un evento de prueba
Navega por un producto o completa un checkout de prueba en tu tienda. Confirma que el evento aparece en la actividad del usuario en el panel de OneSignal.
El service worker debe estar en /apps/vendo/OneSignalSDKWorker.js. Si ves un error 404 en la ruta raíz (/OneSignalSDKWorker.js), la ruta del service worker no está configurada en OneSignal — sigue el paso de configuración del service worker. Si el 404 está en la ruta /apps/vendo/, verifica que la aplicación Vendo esté instalada y el bloque de tema esté habilitado.
Verifica que el bloque de tema Vendo esté habilitado en App embeds. Comprueba que tu navegador permita notificaciones (haz clic en el ícono de candado en la barra de direcciones). Prueba en una ventana de navegación privada por si el prompt fue rechazado previamente.
Las etiquetas solo se sincronizan para usuarios identificados — los visitantes anónimos no se rastrean. Asegúrate de que el usuario haya sido identificado mediante suscripción push, inicio de sesión, registro en newsletter o checkout. Las sincronizaciones iniciales de etiquetas pueden tardar varias horas.
Verifica que los eventos estén habilitados en la aplicación Vendo bajo OneSignal > Events. Los eventos del lado del cliente requieren que el Shopify Web Pixel esté activo y el usuario esté identificado. Los eventos del lado del servidor requieren que la REST API Key esté configurada.
Las notificaciones muestran “Entregado” pero no aparecen
La integración está funcionando — el problema está en la configuración de notificaciones de tu navegador o sistema operativo. Revisa la configuración de notificaciones de tu sistema operativo para tu navegador, asegúrate de que el modo No molestar / Concentración esté desactivado y verifica los permisos de notificación a nivel del navegador.
¿Puedo cambiar el identificador de cliente después de la configuración?
Sí. Actualiza el ajuste en la aplicación Vendo bajo Settings > Customer Identifier. Cambiar el identificador puede crear perfiles de usuario separados si los usuarios existentes ya fueron identificados con el método anterior.
La integración Vendo se enfoca en las tiendas Shopify y el push web. Si también tienes una aplicación móvil, asegúrate de que el identificador que seleccionas en Vendo coincida con el que usas en tu aplicación móvil para que los perfiles de usuario permanezcan consistentes.
Los eventos de visitantes no identificados no se envían a OneSignal. Una vez que el visitante se identifica (suscribiéndose al push, iniciando sesión, registrándose en una newsletter o completando el checkout), Vendo comienza a enviar eventos. Este enfoque solo para usuarios identificados evita usuarios duplicados y garantiza datos limpios.
¿Por qué Vendo usa un enfoque solo para usuarios identificados?
Las versiones anteriores rastreaban visitantes anónimos usando la cookie de sesión de Shopify como identificador. Esto creaba usuarios duplicados de OneSignal que nunca podían fusionarse correctamente, llevando a conteos inflados de usuarios y datos fragmentados. El enfoque solo para usuarios identificados garantiza que cada usuario de OneSignal sea real y accionable.
