Integración con Shopify

Resumen de la integración

Pushwoosh se integra perfectamente con Shopify, una plataforma de comercio electrónico líder que permite a las empresas crear, gestionar y escalar tiendas en línea. Esta guía le guiará a través de la instalación y configuración de la aplicación Pushwoosh en su tienda Shopify, la configuración de la identificación de usuario y el uso de notificaciones y herramientas de automatización para atraer a los clientes a través de canales como push, email, SMS y WhatsApp.

Tipo de integración

• Destino: Shopify envía datos de clientes a Pushwoosh, donde se utilizan para la segmentación y el envío de mensajes.

Prerrequisitos

• Una cuenta de Pushwoosh
• Acceso a su panel de administración de Shopify
• Token de acceso a la API de dispositivo y Código de aplicación de Pushwoosh
• Una tienda Shopify con clientes y datos de pedidos disponibles
• Aprobación de los ámbitos de acceso read_orders, write_pixels y read_customer_events que solicita la aplicación, necesarios para los eventos de pedido/carrito, el seguimiento de los pasos de pago y los eventos de comportamiento de la tienda

¿Ya está conectado? Se le pedirá que vuelva a aprobar el acceso

Si conectó la aplicación Pushwoosh antes de que existiera el seguimiento de pedidos, carritos y pagos, Shopify le pedirá que apruebe los nuevos ámbitos la próxima vez que abra la aplicación; esta es la forma esperada en que Shopify implementa los permisos adicionales, no un error. Apruébelos para empezar a recibir eventos de pedidos, carritos y pagos.

Entidades sincronizadas

• Clientes: Se utilizan para asignar e identificar los UserIDs de Pushwoosh a través de los metacampos de Shopify

Nota

Enfoques de sincronización de clientes en Pushwoosh

Debido a limitaciones técnicas, Pushwoosh ofrece varios métodos de sincronización de clientes, dependiendo del canal de comunicación utilizado para las notificaciones:

• Email, Web, SMS y WhatsApp: Los dispositivos/usuarios se registran automáticamente en la aplicación Pushwoosh.
• Aplicaciones móviles y de escritorio: Los dispositivos/usuarios se pueden sincronizar manualmente a través de los paneles de administración de Pushwoosh y Shopify.
• Plataformas web (Chrome, Firefox, Safari): Los dispositivos/usuarios son gestionados por el propio embed del tema de Shopify.

¿Cómo funciona?

El proceso de sincronización funciona de la siguiente manera:

1. El sistema intenta recuperar la sesión de usuario actual para obtener un correo electrónico o un número de teléfono (identificadores que funcionan sin configuración adicional).
2. Si tiene éxito, el correo electrónico o el número de teléfono se establece como el identificador userID tanto para Pushwoosh como para la propiedad pushwoosh_userid en los datos del cliente.
3. Si esto no es posible, el userID del SDK de Pushwoosh por defecto se asigna como el identificador tanto para Pushwoosh como para la propiedad pushwoosh_userid.
4. En cualquier caso, se asignará un userID en ambos lados, garantizando una sincronización consistente.

• Segmentos de clientes: Se utilizan para la segmentación y el envío de mensajes basados en grupos
• Eventos y disparadores (por ejemplo, pedidos realizados, etiquetas aplicadas): Se utilizan en Shopify Flow para automatizar los mensajes a través de los canales
• Tienda: Se utiliza para capturar las suscripciones a notificaciones push web a través de scripts incrustados
• Feed de productos: El feed de la tienda de su tienda (products.json) se conecta automáticamente al Catálogo de productos de Pushwoosh cuando conecta la aplicación, y se desconecta automáticamente si la desinstala.
• Pedidos y carritos: Eventos de servidor a servidor de los webhooks orders/paid y checkouts/create de Shopify. Consulte Seguimiento de pedidos, carritos y pasos de pago.
• Comportamiento de navegación en la tienda: Vistas de productos y acciones de añadir al carrito, recopiladas por el mismo embed de tema utilizado para las suscripciones a notificaciones push web.
• Pasos de pago: Información de contacto introducida e información de pago enviada, recopilada a través de un Web Pixel de Shopify.

Glosario (mapeo de nombres de entidades si son diferentes)

Shopify	Pushwoosh
Cliente	UserID
webhook orders/paid	Evento PW_OrderCreated — compartido con otras integraciones de comercio electrónico (por ejemplo, Magento)
webhook checkouts/create	Evento PW_AbandonedCart — mismo evento compartido, también utilizado por la fuente del carrito del bloque de Productos
Vista de la página del producto	Evento PW_ProductViewed

Cómo funciona la integración

Pushwoosh actúa como un destino de mensajería para Shopify. Una vez integrado, Shopify envía datos de clientes y de comportamiento a Pushwoosh, donde impulsa notificaciones en tiempo real, segmentación de clientes y mensajería personalizada a través de los canales.

Componentes clave de la integración

1. Identificación del cliente a través de metacampos A cada cliente de Shopify se le asigna un UserID único, almacenado en un metacampo (custom.pushwoosh_userid). Este ID permite a Pushwoosh reconocer y enviar mensajes a los usuarios de forma consistente en todas las plataformas.

2. Automatización basada en eventos a través de Shopify Flow Pushwoosh proporciona acciones de Flow que le permiten automatizar la mensajería (push, email, SMS, WhatsApp) basada en eventos de Shopify, como:

   • Nuevo pedido realizado
   • Etiqueta aplicada al cliente
   • Abandono del carrito

3. Segmentación basada en segmentos Los segmentos de clientes de Shopify se pueden utilizar para enviar notificaciones específicas de grupo a través de los canales, como promociones para compradores primerizos o campañas de reactivación para usuarios inactivos.

4. Mensajería manual y en tiempo real Desde la vista de cliente o segmento de Shopify, puede activar manualmente las notificaciones utilizando las Extensiones de Pushwoosh:

   • Notificación por cliente: Para seguimientos personales o pruebas
   • Notificación por segmento: Para mensajes basados en campañas

Notificaciones push web a través del embed de la tienda

Al habilitar el embed de Pushwoosh en su tema de Shopify, puede solicitar a los visitantes del sitio web que se suscriban a las notificaciones push basadas en el navegador, sin necesidad de una aplicación móvil.

Resumen del flujo de datos

Datos de clientes y eventos de Shopify
         ↓
API de Pushwoosh (a través de la aplicación)
         ↓
UserID → Segmentación → Notificaciones activadas o manuales

Esta integración le permite entregar mensajes oportunos y relevantes que mejoran la retención de usuarios, aumentan las conversiones y mejoran la experiencia del cliente, de forma automática o bajo demanda.

Parte 1. Instalación

Inicie sesión en Shopify

1. Vaya a Shopify Admin
2. Seleccione su tienda en el panel de control

Nota

Esta guía asume que ya tiene una cuenta de Pushwoosh. Si no es así, cree una

Instale la aplicación Pushwoosh

1. Visite la página de la App Store de Pushwoosh
2. Haga clic en Instalar
3. Confirme la instalación en el cuadro de diálogo de Shopify

Conecte su aplicación Pushwoosh

Después de la instalación, será redirigido a la aplicación Pushwoosh dentro de Shopify.

1. Haga clic en Conectar.

2. Introduzca el Código de aplicación y el Token de acceso a la API de dispositivo, que puede encontrar en el Panel de control de Pushwoosh → Configuración → Acceso a la API.

Cuando se conecte, aparecerá un mensaje de éxito: “Aplicación Pushwoosh conectada”.

Conexión automática del catálogo de productos

La conexión de la aplicación también conecta el feed de la tienda de su tienda al Catálogo de productos de Pushwoosh automáticamente, sin necesidad de una configuración de feed por separado. La moneda de su tienda se captura al mismo tiempo y se actualiza automáticamente si cambia la moneda de su tienda después.

Suscríbase a un plan

1. Haga clic en Actualizar suscripción
2. Se mostrará un único plan basado en el uso.
3. Confirme la facturación.

Nota

Se requiere facturación para utilizar las funciones de entrega de mensajes y segmentación.

Parte 2. Configuración: ID de usuario del cliente a través de metacampos

Para entregar notificaciones a usuarios identificados a través de los canales (push, email, SMS, WhatsApp), Pushwoosh utiliza un ID de usuario único por cliente. Shopify almacena este valor dentro de los Metacampos de cliente de Shopify.

1. Vaya a Configuración → Metacampos y metaobjetos → Clientes

2. Haga clic en Añadir definición y utilice estos valores:

Campo	Valor
Espacio de nombres y clave	custom.pushwoosh_userid
Espacio de nombres	custom
Tipo	Texto de una sola línea
Validación	Ninguna
Acceso a la cuenta del cliente	Lectura y escritura
Acceso a la API de la tienda	Habilitado

Por qué es importante

Este metacampo es un identificador de usuario persistente en todos los dispositivos móviles/web para notificaciones y segmentación.

Parte 3. Uso de las extensiones de Pushwoosh

Pushwoosh incluye extensiones de Shopify para la segmentación, la automatización (Flow) y las notificaciones específicas del cliente.

Extensión 1. Enviar notificación por cliente

Caso de uso

Enviar manualmente mensajes personalizados o notificaciones de prueba a un usuario específico.

Pasos

1. Abra Clientes → Seleccione un cliente
2. Haga clic en Más acciones → Notificación por cliente
   
3. Seleccione la plataforma de mensajería (por ejemplo, Email) y un preajuste de contenido.
4. Haga clic en Enviar

Consejo

Utilice esto para recordatorios posteriores a la compra, agradecimientos personales o avisos de reactivación.

Extensión 2. Notificación por segmento

Caso de uso

Diríjase a grupos de clientes: carritos abandonados, compradores primerizos, grandes gastadores.

Pasos

1. Vaya a Clientes → Segmentos

2. Elija un segmento → Haga clic en Usar segmento

3. Seleccione Notificación por segmento
4. Seleccione el canal de comunicación deseado y el preajuste de mensaje. Haga clic en Enviar.

Consejo

Los segmentos se pueden crear en función del historial de compras, la ubicación, la actividad o las etiquetas.

Extensión 3. Pushwoosh en Shopify Flow

Caso de uso

Automatice la mensajería en los recorridos del cliente utilizando disparadores como pedidos, etiquetas o comportamiento.

Pasos

1. Cree un nuevo Flow en Shopify Flow
2. Añadir acción → Elija Notificaciones de Pushwoosh

3. Configure el mensaje y los campos dinámicos

Por ejemplo:

• Enviar un mensaje después de realizar el pedido

• Recordar al usuario cuando se abandona el carrito

• Enviar un push de reactivación después de 30 días de inactividad

Parte 4. Habilitar las notificaciones push web (opcional pero recomendado)

Para admitir notificaciones push web basadas en el navegador en su tienda, haga lo siguiente:

1. Vaya a Tienda en línea → Temas → Personalizar
   
2. Abra App Embeds en el menú de la izquierda
3. Active Push Init Embed

Nota

Ahora su tienda puede solicitar a los usuarios que se suscriban a las notificaciones push web directamente desde la tienda.

Parte 5. Seguimiento de pedidos, carritos y pasos de pago

Una vez que apruebe los ámbitos read_orders, write_pixels y read_customer_events (consulte Prerrequisitos), Pushwoosh comenzará a recibir tres tipos de eventos de comercio de su tienda. Vienen de diferentes lugares y se detienen independientemente unos de otros; no los trate como un solo feed.

Eventos de pedidos y carritos del lado del servidor

Shopify envía eventos de pedido pagado (webhook orders/paid, evento PW_OrderCreated) y pago creado (webhook checkouts/create, evento PW_AbandonedCart) a Pushwoosh directamente, de servidor a servidor. Ambos se comparten con otras integraciones de comercio electrónico: Magento utiliza los mismos dos nombres de evento. Al igual que otros eventos de webhook entrantes (Stripe funciona de la misma manera), aparecen en el menú desplegable Evento cuando crea un segmento o configura un disparador de Customer Journey, y puede asignar cualquiera de ellos como fuente para eventos de conversión para incorporar los ingresos de Shopify en la segmentación RFM, la atribución de recorridos y las estadísticas de los bloques de productos que envía en los correos electrónicos.

Debido a que estos provienen del servidor de Shopify, no del navegador del comprador, siguen llegando incluso para los compradores que bloquean los rastreadores o utilizan un bloqueador de anuncios.

El abandono del carrito significa tres cosas diferentes aquí

• El disparador de Abandono del carrito en Shopify Flow (consulte Automatización basada en eventos a través de Shopify Flow) es una condición nativa de Shopify, no relacionada con los eventos de Pushwoosh.
• El webhook checkouts/create anterior solo significa que se inició un pago; Shopify no ha decidido que esté “abandonado” y tampoco se ha confirmado ningún pedido.
• La fuente del carrito del bloque de Productos lee el carrito del destinatario a través de la etiqueta PW_AbandonedCartID, independientemente de estos eventos.

Elija el que coincida con lo que realmente está construyendo, no el nombre que suene más parecido.

Eventos de navegación en la tienda

Las vistas de productos (evento PW_ProductViewed) y las acciones de añadir al carrito se recopilan mediante el mismo embed de tema que ya instaló para las suscripciones a notificaciones push web; no hay nada nuevo que añadir a su tema, pero el embed debe estar activado ON (consulte Habilitar las notificaciones push web) para que lleguen estos eventos. Si omitió ese interruptor, no obtendrá ni suscripciones a notificaciones push web ni eventos de la tienda.

Los eventos de la tienda necesitan que el embed del tema esté habilitado

Las vistas de productos y los eventos de añadir al carrito provienen del navegador del comprador. Si un comprador bloquea el script del embed, o si deja el embed del tema desactivado, dejará de recibir estos dos eventos, pero los de pedido pagado y pago creado seguirán llegando independientemente, ya que provienen del servidor de Shopify. No asuma que un embed de tema deshabilitado también pausa el seguimiento de pedidos.

PW_ProductViewed no tiene deduplicación

PW_ProductViewed se activa en cada carga de la página del producto, incluidas las visitas repetidas en la misma sesión, las recargas de la página y el tráfico de bots o rastreadores. No hay deduplicación ni limitación. Dado que las estrategias como Basado en lo que vieron se basan en este evento, el tráfico ruidoso también alimenta esas recomendaciones.

Eventos de los pasos de pago

Un Web Pixel de Shopify informa de dos hitos de pago a medida que el comprador rellena el formulario de pago:

• PW_CheckoutContactInfo: el comprador introdujo su información de contacto.
• PW_PaymentInfoSubmitted: el comprador envió sus datos de pago.

La compra completada no forma parte de este píxel

El Web Pixel no realiza un seguimiento intencionado de la compra completada; ese es el evento de pedido pagado del lado del servidor anterior. Utilice los eventos del Web Pixel para ver dónde abandonan los compradores durante el pago y el evento de pedido para saber que realmente se ha producido una venta.

Parte 6. Cumplimiento de datos

Shopify requiere que todas las aplicaciones públicas respondan a sus webhooks obligatorios de GDPR/CCPA. Pushwoosh los gestiona de la siguiente manera:

• customers/redact: Cuando un comprador pide a la tienda que borre sus datos, Pushwoosh borra los registros de Pushwoosh correspondientes por los identificadores que envíe Shopify: correo electrónico, teléfono e ID de cliente de Shopify.
• customers/data_request: Cuando un comprador solicita una copia de sus datos, Pushwoosh publica una notificación en el canal interno de soporte y una persona gestiona la solicitud manualmente. Shopify requiere que las aplicaciones respondan a estas solicitudes en un plazo de 30 días.
• shop/redact: Shopify envía esto 48 horas después de que una tienda desinstale la aplicación, pidiendo que se borren los datos de la tienda. Pushwoosh no tiene un gestor separado para ello por diseño: la desinstalación ya elimina todo el registro de integración de la tienda (incluida la clave de la API del dispositivo, el código de la aplicación y los ID de facturación), por lo que no queda nada que este webhook pueda borrar cuando llegue.

Resumen de casos de uso

Escenario	Herramienta utilizada
Seguimiento personalizado	Notificación por cliente
Recordatorio de abandono del carrito	Shopify Flow + acción de Pushwoosh
Promoción basada en segmentos	Notificación por segmento
Mensaje de bienvenida después de registrarse	Flow + Seguimiento de metacampos
Suscripción a notificaciones push	Embed de tema + Interruptor de inicialización de push
Atribución de ingresos y segmentación RFM	Eventos de pedido/pago asignados a eventos de conversión
Análisis de abandonos en el pago	Eventos PW_CheckoutContactInfo / PW_PaymentInfoSubmitted
Segmentos de abandono de navegación o de carrito	Eventos de vista de producto de la tienda / añadir al carrito