Integración con Shopify
Resumen de la integración
Anchor link toPushwoosh 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, correo electrónico, SMS y WhatsApp.
Tipo de integración
Anchor link to- Destino: Shopify envía datos de clientes a Pushwoosh, donde se utilizan para la segmentación y la mensajería.
Requisitos previos
Anchor link to- Una cuenta de Pushwoosh
- Acceso a su panel de administración de Shopify
- El Token de acceso a la API de dispositivo y el Código de aplicación de Pushwoosh
- Una tienda Shopify con clientes y datos de pedidos disponibles
- Aprobación del ámbito de acceso
read_orderspara eventos de pedido/carrito, ywrite_pixelsmásread_customer_eventspara el seguimiento de los pasos de pago
Entidades sincronizadas
Anchor link to- Clientes: Se utiliza para asignar e identificar los ID de usuario de Pushwoosh a través de los metacampos de Shopify.
- Segmentos de clientes: Se utilizan para la segmentación y mensajería basada en grupos.
- Eventos y disparadores (por ejemplo, pedidos realizados, etiquetas aplicadas): Se utilizan en Shopify Flow para automatizar la mensajería 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 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,checkouts/createycheckouts/updatede 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 del 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)
Anchor link to| Shopify | Pushwoosh |
|---|---|
| Cliente | User ID |
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 de Carrito del bloque de Productos |
webhook checkouts/update | Evento PW_AbandonedCartUpdate — se dispara mientras el comprador sigue editando el mismo pago, sobrescribiendo el carrito almacenado de PW_AbandonedCart |
| Vista de página de producto | Evento PW_ProductViewed |
| Añadir al carrito (sin recargar la página) | Evento PW_AddToCart |
Web Pixel checkout_contact_info_submitted | Evento PW_CheckoutContactInfo |
Web Pixel payment_info_submitted | Evento PW_PaymentInfoSubmitted |
Cómo funciona la integración
Anchor link toPushwoosh 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
Anchor link to-
Identificación del cliente a través de metacampos A cada cliente de Shopify se le asigna un ID de usuario ú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. -
Automatización basada en eventos a través de Shopify Flow Pushwoosh proporciona acciones de Flow que le permiten automatizar la mensajería (push, correo electrónico, SMS, WhatsApp) basándose en eventos de Shopify, como:
- Nuevo pedido realizado
- Etiqueta aplicada al cliente
- Abandono de carrito
-
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.
-
Mensajería manual y en tiempo real Desde la vista de cliente o segmento de Shopify, puede activar manualmente 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
Anchor link toAl 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
Anchor link toDatos de clientes y eventos de Shopify ↓API de Pushwoosh (a través de la aplicación) ↓ID de usuario → Segmentación → Notificaciones activadas o manualesEsta 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
Anchor link toInicie sesión en Shopify
Anchor link to- Vaya a Shopify Admin
- Seleccione su tienda desde el panel de control
Instale la aplicación Pushwoosh
Anchor link to- Visite la página de la App Store de Pushwoosh
- Haga clic en Instalar

- Confirme la instalación en el diálogo de Shopify

Conecte su aplicación Pushwoosh
Anchor link toDespués de la instalación, será redirigido a la aplicación Pushwoosh dentro de Shopify.
- Haga clic en Conectar.

- Introduzca el Código de aplicación y la Clave API, que puede encontrar en el Panel de control de Pushwoosh → Configuración → Acceso a la API. La clave API aquí es su Token de acceso a la API de dispositivo.

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

Cuando Shopify solicite permisos (pedidos, píxeles, eventos de clientes), apruébelos. Esos ámbitos son necesarios para el seguimiento de la Parte 5. Si conectó la aplicación anteriormente, consulte ¿Ya está conectado? Se le pedirá que vuelva a aprobar el acceso.
Suscríbase a un plan
Anchor link to- Haga clic en Actualizar suscripción
- Se mostrará un único plan basado en el uso.
- Confirme la facturación.

Parte 2. Configuración: ID de usuario del cliente a través de metacampos
Anchor link toPara entregar notificaciones a usuarios identificados a través de los canales (push, correo electrónico, SMS, WhatsApp), Pushwoosh utiliza un ID de usuario único por cliente. Shopify almacena este valor dentro de los Metacampos de cliente de Shopify.
- Vaya a Configuración → Metacampos y metaobjetos → Clientes

- 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 |

Establezca el Acceso a las cuentas de los clientes y el Acceso a la API de la tienda como en la tabla anterior.

Parte 3. Uso de las extensiones de Pushwoosh
Anchor link toPushwoosh incluye extensiones de Shopify para la segmentación, la automatización (Flow) y las notificaciones específicas para clientes.
Extensión 1. Enviar notificación por cliente
Anchor link toCaso de uso
Anchor link toEnviar manualmente mensajes personalizados o probar notificaciones a un usuario específico.
Pasos
Anchor link to- Abra Clientes → Seleccione un cliente
- Haga clic en Más acciones → Notificación por cliente

- Seleccione la plataforma de mensajería (por ejemplo, Correo electrónico) y un preajuste de contenido.

- Haga clic en Enviar
Extensión 2. Notificación por segmento
Anchor link toCaso de uso
Anchor link toDirigirse a grupos de clientes: carritos abandonados, compradores primerizos, grandes gastadores.
Pasos
Anchor link to-
Vaya a Clientes → Segmentos
-
Elija un segmento → Haga clic en Usar segmento

- Seleccione Notificación por segmento

- Seleccione el canal de comunicación deseado y el preajuste de mensaje. Haga clic en Enviar.

Extensión 3. Pushwoosh en Shopify Flow
Anchor link toCaso de uso
Anchor link toAutomatice la mensajería en los recorridos del cliente utilizando disparadores como pedidos, etiquetas o comportamiento.
Pasos
Anchor link to- Cree un nuevo Flow en Shopify Flow
- Añadir acción → Elija Pushwoosh enviar notificación

- Configure el mensaje y los campos dinámicos

Por ejemplo:
-
Enviar un mensaje después de realizar un pedido
-
Recordar al usuario cuando el carrito está abandonado
-
Enviar un push de reactivación después de 30 días de inactividad
Parte 4. Habilitar notificaciones push web (y eventos de navegación en la tienda)
Anchor link toOpcional solo para notificaciones push web. Requerido si necesita eventos de vista de producto y añadir al carrito en la Parte 5.
Active el embed del tema para las notificaciones push web del navegador en su tienda:
- Vaya a Tienda en línea → Temas → Personalizar

- Abra App Embeds en el menú de la izquierda
- Active Push Init Embed

Parte 5. Seguimiento de pedidos, carritos y pasos de pago
Anchor link toDespués de conectar la aplicación y aprobar los permisos solicitados por Shopify para el seguimiento de pedidos, carritos y pagos (read_orders, write_pixels, read_customer_events), los eventos de pedido, pago y pasos de pago comienzan a llegar sin una pantalla de seguimiento de Pushwoosh por separado. Consulte Requisitos previos y Parte 1 para el paso de aprobación. La navegación en la tienda (vistas de productos y añadir al carrito) también necesita que Push Init Embed esté ACTIVADO.
El seguimiento cubre tres grupos de eventos independientes. Cada uno necesita un acceso diferente, por lo que desactivar uno no pausa los otros:
- Pedido pagado y pago: llegan desde Shopify incluso si el embed del tema está desactivado.
- Navegación en la tienda (vistas de productos y añadir al carrito): necesitan que el embed del tema esté ACTIVADO.
- Pasos de pago: necesitan los permisos de seguimiento de pago de Shopify de la Parte 1 (
write_pixelsyread_customer_events), aprobados por separado del permiso de seguimiento de pedidos (read_orders) anterior.
Antes de conectar la aplicación, compruebe cómo Pushwoosh maneja los tipos de atributos de dinero y fecha para PW_OrderCreated y PW_AbandonedCart. Un tipo incorrecto enviado antes de que lo detecte no se puede corregir retroactivamente.
Eventos de pedido pagado y pago
Anchor link toUtilícelos para la mensajería post-compra (PW_OrderCreated), los recorridos o segmentos de pago abandonado (PW_AbandonedCart / PW_AbandonedCartUpdate) y el mapeo de conversión de compra. Llegan desde Shopify incluso si el comprador bloquea el seguimiento del navegador:
| Nombre del evento en Pushwoosh | Cuándo se dispara |
|---|---|
PW_OrderCreated | Se paga un pedido |
PW_AbandonedCart | Un comprador inicia el pago |
PW_AbandonedCartUpdate | El comprador añade, elimina o cambia artículos durante un pago existente |
Estos corresponden a las notificaciones de pedido y pago que Shopify envía a Pushwoosh automáticamente (los webhooks orders/paid, checkouts/create y checkouts/update, listados en Entidades sincronizadas).
La propia condición de Flow de Shopify, el webhook checkouts/create y la fuente de Carrito del bloque de Productos son tres cosas diferentes que se llaman abandono de carrito. Elija la que coincida con lo que está construyendo, utilizando la tabla a continuación.
| Lo que quiere construir | Qué usar |
|---|---|
| Recordatorio desde Shopify Flow (la propia condición de Abandono de carrito de Shopify) | Shopify Flow + acción Pushwoosh enviar notificación. No los nombres de evento PW_AbandonedCart. |
| Recordatorio o segmento en Pushwoosh desde el inicio del pago o el cambio del carrito | Customer Journey o segmento en PW_AbandonedCart / PW_AbandonedCartUpdate |
| Mostrar los artículos del carrito del comprador dentro de un correo electrónico | Bloque de Productos fuente de Carrito (utiliza la etiqueta PW_AbandonedCartID en el momento del envío). Separado de qué disparador inició el recorrido. |
Cómo se comportan estos eventos. checkouts/create solo significa que se inició un pago. Shopify no ha decidido que está abandonado, y tampoco se ha confirmado ningún pedido.
Mientras el comprador edita el pago, PW_AbandonedCartUpdate se dispara de nuevo para el mismo pago y sobrescribe el carrito almacenado de PW_AbandonedCart. Los correos electrónicos de recordatorio que utilizan la fuente de Carrito recogen los últimos artículos en el momento del envío. No necesita un segundo disparador de recorrido solo para actualizar el carrito.
PW_AbandonedCart y PW_AbandonedCartUpdate establecen la etiqueta PW_AbandonedCartID en el comprador, que es lo que la fuente de Carrito lee en el momento del envío. PW_OrderCreated la borra de inmediato, por lo que un comprador que ya ha pagado se salta el bloque en lugar de recibir un recordatorio de un carrito que ya no tiene. Consulte Qué sucede cuando envía PW_OrderCreated para el comportamiento exacto de borrado.
Atributos de los eventos de pedido y pago
Anchor link toPW_OrderCreated y PW_AbandonedCart incluyen:
| Atributo | Descripción |
|---|---|
orderId | El identificador del pedido o del pago |
email | El correo electrónico del comprador |
totalPrice | El total del pedido o del carrito |
shippingAmount | El coste de envío |
taxAmount | El importe de los impuestos |
discountAmount | El importe del descuento |
currency | El código de la moneda |
items | Los artículos de línea del carrito |
customerId | Solo para clientes registrados, no presente para pagos de invitados |
orderUrl | La página de estado del pedido para PW_OrderCreated, o la URL de recuperación del pago abandonado para PW_AbandonedCart y PW_AbandonedCartUpdate. Úsela para construir un enlace o botón de “Complete su compra”. |
createdDate | Cuándo se creó el pedido o el pago |
abandonedDate | Solo PW_AbandonedCart y PW_AbandonedCartUpdate. Cuándo se tocó por última vez el carrito, no cuándo se creó por primera vez |
Los pagos de invitados todavía pueden enviar eventos de pedido y carrito, pero sin un ID de cliente registrado en el evento.
PW_AbandonedCartUpdate lleva los mismos atributos. Si su cuenta también tiene conectada la integración de Magento, sus pedidos y carritos abandonados se publican con estos mismos nombres de evento, por lo que un segmento o recorrido construido sobre PW_OrderCreated / PW_AbandonedCart captura ambas tiendas, y los tipos de atributos anteriores se aplican a ambas también. Magento no tiene un equivalente a PW_AbandonedCartUpdate, porque no rastrea las ediciones de pago en curso.
items en particular llega de Shopify con solo unos pocos campos rellenados.
Eventos de navegación en la tienda
Anchor link toUtilícelos para segmentos o recorridos de abandono de navegación, y para estrategias de recomendación por correo electrónico que necesiten vistas de productos (por ejemplo, Basado en lo que vieron). Consulte Cómo configurar recomendaciones de productos en el correo electrónico.
Ambos eventos son recopilados por el mismo embed del tema. No hay nada más que añadir al tema una vez que Push Init Embed está ACTIVADO:
PW_ProductViewed: el comprador abre una página de producto.PW_AddToCart: el comprador añade un artículo al carrito sin recargar la página, que es como lo hacen la mayoría de los temas de Shopify.
Atributos de los eventos de navegación en la tienda
Anchor link toAmbos eventos incluyen:
| Atributo | Descripción |
|---|---|
items | El/los producto(s) visto(s) o añadido(s), cada uno con productId, name, sku, quantity, price |
totalPrice | El precio combinado de items |
productUrl | La página en la que estaba el comprador |
currency | Solo cuando la tienda lo expone |
Un mensaje que muestra totalPrice necesita una alternativa para cuando falta currency, ya que el número por sí solo no dice en qué moneda está.
Ninguno de los eventos lleva email o customerId como atributo. El comprador se identifica de la misma manera que lo hace el resto del embed del tema, a través de la sesión del SDK vinculada al ID de usuario del metacampo (consulte la Parte 2), no a través de la carga útil del evento.
Los items de PW_ProductViewed y PW_AddToCart llevan los mismos campos que Shopify envía antes del enriquecimiento: productId, name, sku, quantity, price. Pushwoosh no rellena el resto de los campos del catálogo para estos dos eventos, como lo hace para los items de PW_AbandonedCart (consulte Los artículos del carrito se enriquecen desde su Catálogo de productos más arriba).
Una estrategia de recomendación que necesita detalles completos del producto, como Basado en lo que vieron, los busca en su Catálogo de productos por productId cuando se renderiza el mensaje. Consulte Cómo configurar recomendaciones de productos en el correo electrónico para saber qué necesita cada estrategia.
Eventos de los pasos de pago
Anchor link toUtilícelos para ver dónde abandonan las personas antes de la compra y para enviar mensajes a las personas que iniciaron el pago pero no llegaron a un pedido pagado.
PW_CheckoutContactInfo: el comprador introdujo su información de contacto.PW_PaymentInfoSubmitted: el comprador envió sus datos de pago.
Una venta completada es PW_OrderCreated de la sección anterior, no estos dos eventos.
PW_AbandonedCart solo le dice que se inició un pago. Estos dos eventos marcan dos puntos posteriores en el mismo pago, en ese orden: primero la información de contacto, segundo los detalles de pago. Un comprador que llegó a PW_PaymentInfoSubmitted y nunca recibió un PW_OrderCreated posterior llegó más lejos que uno que solo activó PW_AbandonedCart, por lo que un mensaje construido en esa etapa puede abordar un pago estancado específicamente, en lugar de un recordatorio de carrito genérico.
Atributos de los eventos de los pasos de pago
Anchor link toAmbos eventos incluyen:
| Atributo | Descripción |
|---|---|
items | Los artículos de línea del pago, cada uno con productId, name, sku, quantity, price |
orderId | El token de pago, o el ID de pedido de Shopify una vez que el pago tiene uno |
totalPrice | El total del pago |
email | Solo cuando el pago tiene uno. Un pago basado en el teléfono (sin correo electrónico introducido) envía el evento sin él. |
currency | Solo cuando el pago tiene uno |
Compruebe que funciona
Anchor link toRealice la acción correspondiente en la tienda y luego confirme que el nombre del evento aparece en Pushwoosh. El evento en sí se procesa en tiempo real, pero los dos lugares donde lo comprobaría reaccionan de manera diferente a un nombre que Pushwoosh no ha visto antes:
- En el menú desplegable Evento cuando crea un segmento por eventos, un nuevo nombre aparece de inmediato.
- En el menú desplegable Evento cuando añade un disparador de Customer Journey, un nuevo nombre puede tardar hasta 10 minutos en aparecer (ese menú desplegable está en caché). Si aún no lo ve, espere en lugar de asumir que la integración está rota.
| Acción de prueba | Evento |
|---|---|
| Pagar un pedido de prueba | PW_OrderCreated |
| Iniciar un pago | PW_AbandonedCart |
| Cambiar artículos en ese pago | PW_AbandonedCartUpdate |
| Abrir una página de producto (Push Init Embed ACTIVADO) | PW_ProductViewed |
| Añadir un artículo al carrito | PW_AddToCart |
| Introducir información de contacto en el pago | PW_CheckoutContactInfo |
| Enviar información de pago en el pago | PW_PaymentInfoSubmitted |
Utilice los eventos
Anchor link toDespués de saber qué evento necesita, úselo en dos lugares:
- Como disparador o condición de segmento: elíjalo en el menú desplegable Evento cuando cree un segmento por eventos o añada un disparador de Customer Journey.
- En el texto del mensaje: en el paso del mensaje, active Personalizar mensaje con atributos de evento y elija el atributo (por ejemplo, el total del pedido de
PW_OrderCreated). También puede insertar el atributo con un marcador de posición de Liquid. Consulte Contenido dinámico y plantillas Liquid en los recorridos.
Para los pedidos pagados, también puede mapear PW_OrderCreated como un evento de conversión para que las compras de Shopify alimenten la segmentación RFM, la atribución de recorridos y las estadísticas del bloque de Productos.
Campañas de ejemplo
Anchor link toCada una se dispara en un punto diferente del camino del comprador, por lo que llegan a diferentes audiencias: hasta dónde llegó alguien antes de abandonar, o si llegó al pago, decide cuál se aplica.
- Recordatorio de carrito abandonado. Atrapa a todos los compradores que iniciaron el pago, sin importar hasta dónde llegaron: la audiencia más amplia aquí. Constrúyalo como un Customer Journey: dispare en
PW_AbandonedCart, espere aPW_OrderCreated, luego envíe un correo electrónico con un bloque de fuente de Carrito a quien no haya pagado. Consulte Cómo configurar una campaña de carrito abandonado para la configuración completa. - Seguimiento para pagos estancados. Atrapa solo a los compradores que llegaron a introducir la información de contacto pero nunca pagaron, una porción más estrecha de la audiencia anterior. Segmente en
PW_CheckoutContactInfo, luego excluya a cualquiera que también tengaPW_PaymentInfoSubmittedoPW_OrderCreated. - Recuperación para un pago estancado. Atrapa a los compradores que llegaron al pago pero nunca completaron el pedido, más avanzados que el seguimiento anterior y mutuamente excluyentes con él. Segmente en
PW_PaymentInfoSubmitted, luego excluya a cualquiera que también tengaPW_OrderCreated. - Correo electrónico de recomendación de navegación. Atrapa a los compradores que miraron productos pero nunca iniciaron el pago, una audiencia diferente a los recordatorios anteriores. Utilice
PW_ProductViewedcon la estrategia Basado en lo que vieron del bloque de Productos. Consulte Cómo configurar recomendaciones de productos en el correo electrónico.
Parte 6. Cumplimiento de datos
Anchor link toShopify requiere que cada aplicación pública responda a sus webhooks obligatorios de GDPR/CCPA. Pushwoosh los maneja de la siguiente manera:
customers/redact: Cuando un comprador pide a la tienda que borre sus datos, Pushwoosh borra los registros de Pushwoosh coincidentes por los identificadores que Shopify envíe: 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 maneja la solicitud manualmente. Shopify requiere que las aplicaciones respondan a estas 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 vuelve a ejecutar la misma eliminación que desencadena la propia desinstalación, borrando cualquier sesión que quede y borrando el registro de integración de la tienda (clave API del dispositivo, código de aplicación e ID de facturación incluidos). Esto existe como una red de seguridad para el caso de que la desinstalación no haya limpiado completamente la primera vez.
Resumen de casos de uso
Anchor link toA continuación, utilice los nombres de los eventos anteriores en recorridos, segmentos o mapeo de conversiones. Ejemplos:
| Escenario | Herramienta utilizada |
|---|---|
| Seguimiento personalizado | Notificación por cliente |
| Recordatorio de abandono de carrito | Shopify Flow + acción de Pushwoosh, o Journey/segmento en PW_AbandonedCart / PW_AbandonedCartUpdate (consulte la Parte 5) |
| 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 del tema + Interruptor de inicialización de push |
| Atribución de ingresos y segmentación RFM | Eventos de pedido/pago mapeados a eventos de conversión |
| Análisis de abandono en el pago | Eventos PW_CheckoutContactInfo / PW_PaymentInfoSubmitted |
| Segmentos de abandono de navegación o carrito | Eventos de vista de producto / añadir al carrito de la tienda |