Desencadenantes personalizados de la tienda

Los desencadenantes integrados de la tienda online abarcan los eventos que recoge Shopify. Un desencadenante personalizado de la tienda online abarca todo lo demás que ocurre en tu tienda online: publicas un evento desde tu plantilla con una sola línea de JavaScript y este se convierte en un desencadenante que puedes utilizar en Shopify Flow.

El ejemplo más claro es el cajón del carrito. El evento «cart view» de Shopify se activa en la página /cart, y la mayoría de los temas modernos nunca navegan hasta allí, sino que, en su lugar, abren el cajón mediante un efecto de deslizamiento. Shopify no registra nada, por lo que ninguna aplicación puede verlo. Publicar tu propio evento cuando se abre el cajón permite subsanar esa carencia.

Otros usos que le dan las tiendas:

• Añadirlo a la lista de deseos o hacer clic en «Notificarme», acciones de las que Shopify no informa.
• Se ha abierto una guía de tallas o una política de devoluciones, como indicación sobre un producto.
• Un** cambio** en el selector, que no supone una nueva vista de la página (véase Condiciones de activación de Storefront).
• Cualquier dato que tu tema o una aplicación de terceros ya conozca y que Shopify no conozca.

Cómo funciona

1. Crea el disparador en la aplicación y asígnale un nombre de evento; por ejemplo, cart_drawer_opened. Al igual que todos los disparadores de Storefront, necesita el acceso a «Storefront Behaviour», que se concede una sola vez en la página «Permisos».
2. Copia el fragmento de código de una línea que te muestra la aplicación y pégalo en tu tema, en el lugar donde se produzca ese problema. Si no estás seguro de qué pegar o dónde, Generar código de activación con IA genera el fragmento de código para tu tema a partir de una descripción en lenguaje sencillo.
3. Escribe una transformación si quieres filtrar o modificar el contenido que se envía, o déjalo en blanco para reenviar todo.
4. Actívalo y, a continuación, añade un «Desencadenador de tienda personalizada» en Flow y crea una rama según el nombre del evento.

El fragmento de código es toda la integración por parte del tema:

Shopify.analytics.publish("cart_drawer_opened", {
  // anything you want the Flow to receive
  itemCount: 3,
  total: "129.90"
});

Nombre del evento

El nombre del evento es lo que determina las ramificaciones de tu flujo de trabajo en Flow, así que elige algo que sea fácil de entender y no lo modifiques una vez que los flujos de trabajo lo estén utilizando.

Los nombres pueden contener letras, números, guiones bajos y guiones; deben empezar por una letra o un número, y pueden tener hasta 64 caracteres. La aplicación convierte lo que escribes en un «slug», por lo que Cart drawer opened se convierte en cart_drawer_opened.

El nombre tiene un espacio de nombres interno, por lo que nunca puede solaparse con un evento de Shopify ni con un disparador personalizado de webhook del mismo nombre.

Filtrado y remodelación

Los datos que pasas como segundo argumento llegan a Flow como el output del disparador. Si eso es todo lo que necesitas, ya está.

Si quieres activar eventos solo en determinados casos, o enviar campos distintos a los que publica el tema, escribe una transformación - el mismo módulo de JavaScript que utiliza Desencadenantes personalizados - . Devuelve un objeto para activar el evento, y devuelve null para omitirlo:

export async function transform(payload, topic, shop, ctx) {
  // Anything you published is on `payload`.
  if ((payload.itemCount || 0) < 2) return null;

  return {
    itemCount: payload.itemCount,
    total: payload.total,
    // Present only when the shopper is signed in.
    customerId: payload.customerId,
  };
}

Cómo utilizarlo en Shopify Flow

Todos los «Custom Storefront Trigger» se importan a Flow con el mismo nombre: «Custom Storefront Trigger». Añádelo a un flujo de trabajo y, a continuación, añade una condición en la que «eventName» sea igual al nombre que hayas elegido.

Eso es lo que permite que un «Flow» active todos los eventos de tu tienda online. El activador también incluye el nombre que le has dado en la aplicación y el resultado de tu transformación.

Se ha separado deliberadamente de «Custom Trigger», que da soporte a los eventos de tienda (Desencadenantes personalizados) basados en webhooks. Ambos se diferencian en un aspecto que conviene conocer: un disparador personalizado de webhook se ejecuta en nuestros servidores y es fiable, mientras que un evento de tienda depende de que el navegador del comprador nos envíe la información y de su consentimiento para el uso de datos analíticos.

Qué no hay que enviar

El segundo argumento de la función publish está totalmente bajo tu control, lo que significa que es tu responsabilidad asegurarte de que no contenga datos personales.

Envía los identificadores y los datos: los ID del producto y de la variante, las cantidades, los precios y el nombre del incidente. El ID del cliente que ha iniciado sesión se añade automáticamente cuando existe, por lo que nunca tendrás que indicarlo tú mismo.

No envíes nombres, direcciones de correo electrónico, números de teléfono ni direcciones postales. Tu flujo de trabajo puede obtener cualquiera de esos datos a partir del identificador de cliente en Flow, por lo que no se gana nada al incluirlos en un evento de la tienda virtual, y hacerlo convierte un evento de análisis en uno que contiene datos personales.

Próximos pasos

• Condiciones de activación de Storefront - los activadores integrados de la tienda online y cómo funciona el píxel.
• Generar código de activación con IA - Deja que la IA redacte por ti el fragmento de tema o la transformación.
• Desencadenantes personalizados - La misma idea aplicada a los eventos de webhook de Shopify, con fiabilidad del lado del servidor.
• Planes y uso - qué se considera un evento.