Saltar al contenido

Integración con Shopify

Resumen de la integración

Anchor link to

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, 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_orders para eventos de pedido/carrito, y write_pixels más read_customer_events para 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/create y checkouts/update 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 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
ClienteUser ID
webhook orders/paidEvento PW_OrderCreated — compartido con otras integraciones de comercio electrónico (por ejemplo, Magento)
webhook checkouts/createEvento PW_AbandonedCart — mismo evento compartido, también utilizado por la fuente de Carrito del bloque de Productos
webhook checkouts/updateEvento PW_AbandonedCartUpdate — se dispara mientras el comprador sigue editando el mismo pago, sobrescribiendo el carrito almacenado de PW_AbandonedCart
Vista de página de productoEvento PW_ProductViewed
Añadir al carrito (sin recargar la página)Evento PW_AddToCart
Web Pixel checkout_contact_info_submittedEvento PW_CheckoutContactInfo
Web Pixel payment_info_submittedEvento PW_PaymentInfoSubmitted

Cómo funciona la integración

Anchor link to

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

Anchor link to
  1. 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.

  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, correo electrónico, SMS, WhatsApp) basándose en eventos de Shopify, como:

    • Nuevo pedido realizado
    • Etiqueta aplicada al cliente
    • Abandono de 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 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 to

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

Anchor link to
Datos de clientes y eventos de Shopify
↓
API de Pushwoosh (a través de la aplicación)
↓
ID de usuario → 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

Anchor link to

Inicie sesión en Shopify

Anchor link to
  1. Vaya a Shopify Admin
  2. Seleccione su tienda desde el panel de control

Instale la aplicación Pushwoosh

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

Conecte su aplicación Pushwoosh

Anchor link to

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

  1. Haga clic en Conectar.

Haga clic en el botón Conectar

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

Conecte su aplicación Pushwoosh

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

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
  1. Haga clic en Actualizar suscripción
  2. Se mostrará un único plan basado en el uso.
  3. Confirme la facturación.

Suscríbase a un plan

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

Anchor link to

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

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

Añadir definición

  1. Haga clic en Añadir definición y utilice estos valores:
CampoValor
Espacio de nombres y clavecustom.pushwoosh_userid
Espacio de nombrescustom
TipoTexto de una sola línea
ValidaciónNinguna
Acceso a la cuenta del clienteLectura y escritura
Acceso a la API de la tiendaHabilitado

Añadir definición

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

Añadir definición

Parte 3. Uso de las extensiones de Pushwoosh

Anchor link to

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

Caso de uso

Anchor link to

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

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

Extensión 2. Notificación por segmento

Anchor link to

Caso de uso

Anchor link to

Dirigirse a grupos de clientes: carritos abandonados, compradores primerizos, grandes gastadores.

  1. Vaya a Clientes → Segmentos

  2. Elija un segmento → Haga clic en Usar segmento

Usar segmento

  1. Seleccione Notificación por segmento Notificación por segmento
  2. Seleccione el canal de comunicación deseado y el preajuste de mensaje. Haga clic en Enviar. Rellene el formulario de mensaje

Extensión 3. Pushwoosh en Shopify Flow

Anchor link to

Caso de uso

Anchor link to

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

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

Acción de flujo de Pushwoosh

  1. Configure el mensaje y los campos dinámicos

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 to

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

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

Active Push Init Embed

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

Anchor link to

Despué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_pixels y read_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 to

Utilí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 PushwooshCuándo se dispara
PW_OrderCreatedSe paga un pedido
PW_AbandonedCartUn comprador inicia el pago
PW_AbandonedCartUpdateEl 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 construirQué 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 carritoCustomer Journey o segmento en PW_AbandonedCart / PW_AbandonedCartUpdate
Mostrar los artículos del carrito del comprador dentro de un correo electrónicoBloque 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 to

PW_OrderCreated y PW_AbandonedCart incluyen:

AtributoDescripción
orderIdEl identificador del pedido o del pago
emailEl correo electrónico del comprador
totalPriceEl total del pedido o del carrito
shippingAmountEl coste de envío
taxAmountEl importe de los impuestos
discountAmountEl importe del descuento
currencyEl código de la moneda
itemsLos artículos de línea del carrito
customerIdSolo para clientes registrados, no presente para pagos de invitados
orderUrlLa 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”.
createdDateCuándo se creó el pedido o el pago
abandonedDateSolo 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 to

Utilí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 to

Ambos eventos incluyen:

AtributoDescripción
itemsEl/los producto(s) visto(s) o añadido(s), cada uno con productId, name, sku, quantity, price
totalPriceEl precio combinado de items
productUrlLa página en la que estaba el comprador
currencySolo 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 to

Utilí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 to

Ambos eventos incluyen:

AtributoDescripción
itemsLos artículos de línea del pago, cada uno con productId, name, sku, quantity, price
orderIdEl token de pago, o el ID de pedido de Shopify una vez que el pago tiene uno
totalPriceEl total del pago
emailSolo cuando el pago tiene uno. Un pago basado en el teléfono (sin correo electrónico introducido) envía el evento sin él.
currencySolo cuando el pago tiene uno

Compruebe que funciona

Anchor link to

Realice 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 pruebaEvento
Pagar un pedido de pruebaPW_OrderCreated
Iniciar un pagoPW_AbandonedCart
Cambiar artículos en ese pagoPW_AbandonedCartUpdate
Abrir una página de producto (Push Init Embed ACTIVADO)PW_ProductViewed
Añadir un artículo al carritoPW_AddToCart
Introducir información de contacto en el pagoPW_CheckoutContactInfo
Enviar información de pago en el pagoPW_PaymentInfoSubmitted

Utilice los eventos

Anchor link to

Después de saber qué evento necesita, úselo en dos lugares:

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 to

Cada 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 a PW_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 tenga PW_PaymentInfoSubmitted o PW_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 tenga PW_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_ProductViewed con 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 to

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

A continuación, utilice los nombres de los eventos anteriores en recorridos, segmentos o mapeo de conversiones. Ejemplos:

EscenarioHerramienta utilizada
Seguimiento personalizadoNotificación por cliente
Recordatorio de abandono de carritoShopify Flow + acción de Pushwoosh, o Journey/segmento en PW_AbandonedCart / PW_AbandonedCartUpdate (consulte la Parte 5)
Promoción basada en segmentosNotificación por segmento
Mensaje de bienvenida después de registrarseFlow + Seguimiento de metacampos
Suscripción a notificaciones pushEmbed del tema + Interruptor de inicialización de push
Atribución de ingresos y segmentación RFMEventos de pedido/pago mapeados a eventos de conversión
Análisis de abandono en el pagoEventos PW_CheckoutContactInfo / PW_PaymentInfoSubmitted
Segmentos de abandono de navegación o carritoEventos de vista de producto / añadir al carrito de la tienda