Eventos y campañas de Shopify

Después de conectar la app y aprobar los permisos que Shopify solicita para el seguimiento de pedidos, carritos y checkout (read_orders, write_pixels, read_customer_events), los eventos de pedido, checkout y pasos de checkout comienzan a llegar sin una pantalla de seguimiento de Pushwoosh independiente. Consulte Requisitos previos y la Parte 1 para el paso de aprobación. La navegación en el storefront (vistas de producto y añadir al carrito) también requiere Push Init Embed activado.

El seguimiento cubre tres grupos de eventos independientes. Cada uno necesita un acceso diferente, por lo que desactivar uno no pausa los demás:

• Pedido pagado y checkout: llegan desde Shopify incluso si el embed del tema está desactivado
• Navegación en el storefront (vistas de producto y añadir al carrito): necesitan el embed del tema activado
• Pasos de checkout: necesitan los permisos de seguimiento de checkout 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 app, revise cómo maneja Pushwoosh los tipos de atributo 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 checkout

Use estos para mensajería posterior a la compra (PW_OrderCreated), journeys o segmentos de checkout abandonado (PW_AbandonedCart / PW_AbandonedCartUpdate), y mapeo de conversión de compra. Llegan desde Shopify incluso si el comprador bloquea el seguimiento del navegador:

Requiere la app conectada y read_orders aprobado

No se necesita ningún interruptor adicional además de eso: conecte la app en la Parte 1 y apruebe el permiso de seguimiento de pedidos de Shopify (read_orders). A diferencia de la navegación en el storefront, estos eventos no dependen de que el embed del tema esté activado.

Nombre del evento en Pushwoosh	Cuándo se dispara
PW_OrderCreated	Se paga un pedido
PW_AbandonedCart	Un comprador inicia el checkout
PW_AbandonedCartUpdate	El comprador añade, elimina o cambia artículos durante un checkout existente

Estos corresponden a las notificaciones de pedido y checkout que Shopify envía automáticamente a Pushwoosh (los webhooks orders/paid, checkouts/create y checkouts/update, listados en Entidades sincronizadas).

La propia condición de Shopify Flow, el webhook checkouts/create y la fuente Cart del bloque Products son tres cosas diferentes a las que todas se les llama abandono de carrito. Elija la que coincida con lo que está creando, usando la siguiente tabla.

Lo que quiere crear	Qué usar
Recordatorio desde Shopify Flow (la propia condición Cart abandonment de Shopify)	Shopify Flow + acción Pushwoosh send notification. No los nombres de evento PW_AbandonedCart.
Recordatorio o segmento en Pushwoosh por checkout iniciado o carrito modificado	Customer Journey o segmento por PW_AbandonedCart / PW_AbandonedCartUpdate
Mostrar los artículos del carrito del comprador dentro de un email	Fuente Cart del bloque Products (usa el tag PW_AbandonedCartID en el momento del envío). Independiente de qué disparador inició el journey.

Cómo se comportan estos eventos. checkouts/create solo significa que se inició un checkout. Shopify aún no ha decidido que esté abandonado, y tampoco se ha confirmado ningún pedido.

Mientras el comprador edita el checkout, PW_AbandonedCartUpdate se dispara de nuevo para el mismo checkout y sobrescribe el carrito almacenado desde PW_AbandonedCart. Los emails de recordatorio que usan la fuente Cart obtienen los artículos más recientes en el momento del envío. No necesita un segundo disparador de journey solo para actualizar el carrito.

PW_AbandonedCart y PW_AbandonedCartUpdate establecen el tag PW_AbandonedCartID en el comprador, que es lo que la fuente Cart lee en el momento del envío. PW_OrderCreated lo borra de inmediato, por lo que un comprador que ya completó el checkout 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.

Un comprador que inicia el checkout dos veces solo vuelve a entrar en el journey si usted lo permite

Por defecto, un Customer Journey no permite que alguien que ya está en él vuelva a entrar, por lo que un segundo checkouts/create del mismo comprador mientras su primer journey de carrito abandonado sigue en ejecución se ignora, no se reinicia. Active Allow re-entry en el disparador si quiere que cada nuevo checkout reinicie el temporizador del recordatorio. Consulte Controlar si los usuarios pueden volver a entrar en la campaña.

Atributos de los eventos de pedido y checkout

PW_OrderCreated y PW_AbandonedCart incluyen:

Atributo	Descripción
orderId	El identificador del pedido o checkout
email	El email del comprador
totalPrice	El total del pedido o carrito
shippingAmount	El costo de envío
taxAmount	El monto del impuesto
discountAmount	El monto del descuento
currency	El código de moneda
items	Las líneas de producto del carrito
customerId	Solo para clientes registrados, no está presente en checkouts de invitado
orderUrl	La página de estado del pedido para PW_OrderCreated, o la URL de recuperación del checkout abandonado para PW_AbandonedCart y PW_AbandonedCartUpdate. Úsela para crear un enlace o botón de «Completar su compra».
createdDate	Cuándo se creó el pedido o checkout
abandonedDate	Solo para PW_AbandonedCart y PW_AbandonedCartUpdate. Cuándo se tocó el carrito por última vez, no cuándo se creó por primera vez

Obtenga los tipos de atributo de dinero y fecha correctos

Pushwoosh infiere el tipo de cada atributo a partir del primer evento que ve, y esa inferencia no es fiable para campos de dinero y fecha como totalPrice, shippingAmount, taxAmount, discountAmount y createdDate/abandonedDate anteriores. Un precio de número entero como 129 se infiere como entero, lo que luego trunca 129.90 a 129 en cada evento posterior.

¿Aún no ha conectado la app? Declare PW_AbandonedCart y PW_OrderCreated con los tipos correctos antes de hacerlo, usando la tabla en Cree los eventos en su Control Panel. Omita el paso Send the events from your backend de esa guía. La integración de Shopify ya los envía por usted.

¿Ya está conectado? Compruebe los tipos ahora: vaya a Audience → Events en el Control Panel, abra PW_AbandonedCart y PW_OrderCreated, y compare cada atributo con la misma tabla. Corregir un tipo incorrecto allí lo corrige de ahí en adelante, pero cualquier valor ya enviado con el tipo incorrecto se pierde para siempre.

Los checkouts de invitado también 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 journey construido sobre PW_OrderCreated / PW_AbandonedCart captura ambas tiendas, y los tipos de atributo anteriores también se aplican a ambas. Magento no tiene equivalente a PW_AbandonedCartUpdate, porque no rastrea las ediciones de checkout en curso.

items en particular llega desde Shopify con solo unos pocos campos rellenados.

Los artículos del carrito se enriquecen desde su Catálogo de productos

Los items que Shopify envía en PW_AbandonedCart y PW_AbandonedCartUpdate llevan solo productId, name, sku, quantity y price. Pushwoosh completa cualquier otro campo que le falte a ese artículo, como description, imageUrl, productUrl, category y otros campos del catálogo, a partir del producto correspondiente en su Catálogo de productos conectado (consulte Conexión automática del catálogo de productos), siempre que un productId coincida. No hay nada adicional que enviar para esto. Un producto ausente del catálogo simplemente sigue mostrándose con los campos que envió Shopify.

Eventos de navegación en el storefront

Use estos para segmentos o journeys de abandono de navegación, y para estrategias de recomendación de email que necesiten vistas de producto (por ejemplo, Based on what they viewed). Consulte Cómo configurar recomendaciones de producto en email.

Requiere Push Init Embed activado

Active Push Init Embed en la Parte 4. El mismo embed del tema que para web push. No hay nada más que añadir al tema.

Si el embed está desactivado, o un comprador bloquea su script, solo pierde las vistas de producto y añadir al carrito. PW_OrderCreated y PW_AbandonedCart siguen llegando desde Shopify.

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.

Dos cosas que comprobar antes de construir sobre estos eventos

• PW_ProductViewed cuenta cada carga de página, sin filtrado. Las recargas, las vistas repetidas en la misma visita e incluso el tráfico de bots cuentan igual que una vista de producto real. Una estrategia de recomendación basada en este evento hereda ese ruido.
• PW_AddToCart solo se dispara si el botón Add to cart de su tienda no recarga la página. Pruébelo usted mismo: haga clic en Add to cart en su tienda y observe qué sucede. ¿Solo se actualiza el contador del carrito, o se recarga toda la página? La mayoría de los temas de Shopify hacen lo primero, actualizando el contador sin recargar (una solicitud en segundo plano a /cart/add). Si su tema recarga la página en su lugar, PW_AddToCart nunca se disparará, pero PW_ProductViewed y los eventos de pedido/checkout seguirán funcionando bien de todos modos.

Atributos de los eventos de navegación en el storefront

Ambos eventos incluyen:

Atributo	Descripción
items	El producto o productos 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 el storefront lo expone

Un mensaje que muestre totalPrice necesita un valor alternativo para cuando falte currency, ya que el número por sí solo no indica en qué moneda está.

Ninguno de los dos eventos lleva email ni customerId como atributo. El comprador se identifica de la misma manera que lo hace el resto del embed del tema, mediante la sesión del SDK vinculada al User ID del metacampo (consulte la Parte 2), no mediante el payload del evento.

Los items de PW_ProductViewed y PW_AddToCart llevan los mismos campos que envía Shopify antes del enriquecimiento: productId, name, sku, quantity, price. Pushwoosh no completa el resto de los campos del catálogo para estos dos eventos, como sí lo hace con 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 necesite detalles completos del producto, como Based on what they viewed, los busca en su Catálogo de productos por productId cuando se renderiza el mensaje. Consulte Cómo configurar recomendaciones de producto en email para saber qué necesita cada estrategia.

Eventos de pasos de checkout

Use estos para ver dónde abandonan las personas antes de la compra, y para enviar mensajes a personas que iniciaron el checkout pero no llegaron a un pedido pagado.

Requiere permisos de app relacionados con pixels

Apruebe los permisos de seguimiento de checkout que Shopify solicita al conectar la app (write_pixels y read_customer_events). Consulte la Parte 1 para ese paso. No hay paso de embed del tema. Shopify informa estos hitos automáticamente una vez aprobados esos permisos (técnicamente, a través del Web Pixel de Shopify).

• 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 indica que se inició un checkout. Estos dos eventos marcan dos puntos posteriores del mismo checkout, en este orden: primero la información de contacto, luego los datos de pago. Un comprador que llegó a PW_PaymentInfoSubmitted y nunca obtuvo un PW_OrderCreated posterior llegó más lejos que uno que solo disparó PW_AbandonedCart, por lo que un mensaje construido sobre esa etapa puede abordar específicamente un pago estancado, en lugar de un recordatorio de carrito genérico.

Atributos de los eventos de pasos de checkout

Ambos eventos incluyen:

Atributo	Descripción
items	Las líneas de producto del checkout, cada una con productId, name, sku, quantity, price
orderId	El token de checkout, o el ID de pedido de Shopify una vez que el checkout tiene uno
totalPrice	El total del checkout
email	Solo cuando el checkout tiene uno. Un checkout basado en teléfono (sin email introducido) envía el evento sin él.
currency	Solo cuando el checkout tiene una

Compruebe que funciona

Realice la acción correspondiente en la tienda, 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 forma diferente ante un nombre que Pushwoosh no ha visto antes:

• En el desplegable Event al crear un segmento por eventos, un nombre nuevo aparece de inmediato.
• En el desplegable Event al añadir un disparador de Customer Journey, un nombre nuevo puede tardar hasta 10 minutos en aparecer (ese 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 checkout	PW_AbandonedCart
Cambiar artículos en ese checkout	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 checkout	PW_CheckoutContactInfo
Enviar información de pago en el checkout	PW_PaymentInfoSubmitted

Use los eventos

Una vez que sepa qué evento necesita, úselo en dos lugares:

• Como disparador o condición de segmento: elíjalo en el desplegable Event al crear un segmento por eventos o al añadir un disparador de Customer Journey.
• En el texto del mensaje: en el paso del mensaje, active Personalize message with event attributes 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 Liquid. Consulte Contenido dinámico y plantillas Liquid en journeys.

Para 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 journey y las estadísticas del bloque Product.

Ejemplos de campañas

Cada una se dispara en un punto diferente del recorrido del comprador, por lo que alcanzan audiencias diferentes: cuán lejos llegó alguien antes de abandonar, o si llegó al checkout, decide cuál aplica.

• Recordatorio de carrito abandonado. Captura a todo comprador que inició el checkout, sin importar cuán lejos llegara: la audiencia más amplia aquí. Constrúyalo como un Customer Journey: dispare con PW_AbandonedCart, espere PW_OrderCreated, luego envíe un email con un bloque de fuente Cart a quien no haya pagado. Consulte Cómo configurar una campaña de carrito abandonado para la configuración completa.
• Seguimiento para checkouts estancados. Captura solo a compradores que llegaron a introducir información de contacto pero nunca pagaron, un segmento más estrecho de la audiencia anterior. Segmente por PW_CheckoutContactInfo, luego excluya a cualquiera que también tenga PW_PaymentInfoSubmitted o PW_OrderCreated.
• Recuperación de un pago estancado. Captura a compradores que llegaron al pago pero nunca completaron el pedido, más avanzados que el seguimiento anterior y mutuamente excluyentes con él. Segmente por PW_PaymentInfoSubmitted, luego excluya a cualquiera que también tenga PW_OrderCreated.
• Email de recomendación de navegación. Captura a compradores que vieron productos pero nunca iniciaron el checkout, una audiencia diferente de los recordatorios anteriores. Use PW_ProductViewed con la estrategia Based on what they viewed del bloque Products. Consulte Cómo configurar recomendaciones de producto en email.