Ninguno tiene código de backend propio, salvo el webhook al final del último. La tarea de la app es dar a los Journeys algo con lo que trabajar.
Lo que la app da a un Journey para trabajar \
Un Journey puede ver tres cosas de una persona: los eventos personalizados que ha enviado, sus etiquetas y los segmentos a los que pertenece. No puede leer tu base de datos. Todo aquello a lo que un Journey deba reaccionar tiene que llegar de una de esas formas.
Los eventos de sesión se tratan en Etiquetas, eventos personalizados y Conversion Metrics. Los otros dos eventos existen solo para iniciar un Journey.
signed_up se dispara una vez por cuenta. Primero se comprueba la antigüedad de la cuenta, para que alguien que instala la app en un teléfono nuevo no pase por el onboarding una segunda vez.
src/lib/onesignalSync.ts
streak_milestone lleva la longitud de la racha como número, para que el mensaje pueda mostrarla.
src/lib/onesignalSync.ts
Onboarding: una secuencia con un objetivo \
El Journey de onboarding tiene un solo objetivo: llevar a un miembro nuevo a su primera sesión de limpieza. Todo se detiene en cuanto eso ocurre.1
La app envía signed_up
El miembro entra en el Journey. Cada miembro pasa por él una vez.
2
Un email de bienvenida y un recorrido in-app salen de inmediato
El email enumera tres pasos para empezar. El mensaje in-app se muestra la próxima vez que el miembro abre la app.
3
Siguen tres push los días 1, 3 y 6
Cada uno espera a una ventana de tiempo de 10:00 a 19:00 en la zona horaria del propio miembro.
4
Una sesión completada lo termina
La regla de salida del Journey es el evento
cleaning_session_completed. Nadie recibe un empujón para hacer algo que ya ha hecho.
Configuración en el panel. Crea el Journey con Custom Event como regla de entrada y
signed_up como evento. En las reglas de salida, elige salir cuando ocurra un evento personalizado y selecciona cleaning_session_completed. Coloca un paso Time Window antes de cada push para que una espera que termina a las 03:00 no envíe a las 03:00.
Recordatorio de sesión: empezar con un evento, cancelar con otro \
Si alguien empieza una sesión de limpieza y nunca la termina, su trabajo no se registra. Este Journey empieza concleaning_session_started, espera tres horas y envía un recordatorio. Su regla de salida es cleaning_session_completed, así que terminar la sesión cancela el recordatorio.
Este par de inicio y cancelación es el Journey útil más sencillo que existe. La misma forma sirve para una cesta abandonada, un formulario de registro sin terminar o un borrador que nunca se envió.
Comprueba el límite de la ventana de tiempo. Al principio la ventana cerraba a las 18:00. Una sesión iniciada a las 16:00 llegaba al final de su espera a las 19:00, encontraba la ventana cerrada y recibía “you didn’t finish” a las 08:00 de la mañana siguiente. Ahora la ventana cierra a las 21:00. Cuando un mensaje solo tiene sentido el mismo día, comprueba qué le pasa a alguien que llega justo después de que cierre la ventana.
Sesión completada: personalizar a partir del evento \
Cuando termina una sesión, quien ha limpiado recibe una breve confirmación con el nombre de la habitación. La habitación no es una etiqueta. Procede del evento que inició el Journey.Push template: Cleaning Session Completed
journey.first_event.properties lee una propiedad del evento de entrada. user_name por sí solo lee una etiqueta, y el filtro default cubre a cualquiera que no tenga la etiqueta.
Este Journey tiene un solo paso. Podría haber sido un envío del backend, como el push que avisa a los compañeros de casa de la misma sesión en Enviar push desde tu backend. Es un Journey porque así el texto puede cambiarse, probarse o desactivarse en el panel.
Promociones por habitación: ramificar según una propiedad del evento \
Este Journey envía un mensaje distinto según la habitación que se haya limpiado. Muestra dos cosas: retener a las personas hasta que ocurre un evento y ramificar según una propiedad de ese evento. Los miembros entran desde un segmento de personas activas en los últimos siete días. El primer paso es un Wait Until con tres ramas. Cada rama esperacleaning_session_completed con un room_name concreto.
Una sesión en cualquier otra habitación no coincide con ninguna rama, y el miembro sigue esperando. Se permite volver a entrar después de 30 minutos, así que el Journey responde a cada nueva sesión.
Los push de este Journey anuncian productos de limpieza inventados. Están ahí para mostrar el patrón. También son mensajes de marketing que los ajustes de notificaciones de la app no cubren, algo que hay que tener en cuenta en el diseño de una app real. Consulta Lo que los Journeys no pueden ver.
Hito de racha: un evento con un número \
La app decide cuándo una racha ha alcanzado un hito, porque acaba de guardar la nueva racha. Envíastreak_milestone con la longitud, y el Journey hace el resto.
Push template: Streak - Milestone reached
Dos Journeys, un mismo momento. Un hito siempre ocurre al final de una sesión, que es también cuando envía el Journey de sesión completada. Sin la espera de un minuto, los dos push llegarían a la vez. Cuando varios Journeys empiezan con la misma acción del usuario, revísalos juntos.
Racha a punto de romperse: el momento, una comprobación de segmento y textos variados \
Una racha termina a medianoche de cualquier día sin sesión. Este Journey avisa al miembro esa noche. Es el más complejo de los siete, y cada uno de sus pasos resuelve un problema distinto.
Llegar a la noche correcta. El aviso corresponde a la noche siguiente a la última sesión, sea cual sea la hora de esa sesión. Una espera de 22 horas seguida de una ventana de 18:00 a 22:00 siempre cae ahí. Una sesión a las 08:00 llega al paso de la ventana a las 06:00 del día siguiente y se retiene hasta las 18:00. Una sesión a las 23:00 llega a las 21:00 del día siguiente y se envía de inmediato.
Respetar un ajuste que el Journey no puede ver. Clean Beans tiene un interruptor “Streak reminders” en sus ajustes de notificaciones, guardado en la base de datos. La app lo replica como etiqueta.
src/lib/onesignalSync.ts
streak_count mayor que 1 y streak_reminders igual a on. Un miembro con una versión antigua no tiene ninguna etiqueta streak_reminders, así que queda fuera del segmento y no recibe el aviso.
Variar el texto. La misma frase cada noche deja de verse fácilmente. El paso Split envía a cada persona por una de cinco ramas al azar, y cada rama tiene su propia plantilla. La rama se vuelve a elegir cada vez que alguien entra, así que un miembro ve textos distintos en noches distintas.
Clean Beans también muestra un aviso de racha como Live Activity, descrito en Live Activities. Un miembro con las Live Activities activadas recibe ambos. El push cubre Android y a quien haya desactivado las Live Activities.
Reenganche y el webhook de Journey \
El último Journey se ocupa de los miembros que han dejado de abrir la app. Es el único que entra solo desde un segmento y el único que llama al backend.
Se permite volver a entrar después de 30 días. La entrada se limita a las personas que se unen al segmento después de que empiece el Journey. Sin eso, todos los que ya están inactivos el día en que se activa reciben el primer push de inmediato.
Avisa a tu backend cuando la secuencia se agota \
Un miembro que llega al final sin limpiar no ha respondido a cuatro mensajes. Es poco probable que un quinto ayude. En su lugar, Clean Beans avisa al hogar. Un paso Webhook llama a una función del backend, que marca al miembro como inactivo y notifica a los propietarios y administradores del hogar. Configuración en el panel. Crea un webhook de Journey con estos ajustes y selecciónalo en el último paso del Journey.Journey webhook
supabase/functions/journey-webhook/index.ts
supabase/functions/journey-webhook/index.ts
supabase/functions/journey-webhook/index.ts
Lo que los Journeys no pueden ver \
Cada envío del backend en esta guía comprueba los ajustes de notificaciones del miembro antes de enviar. Un Journey no puede hacerlo, porque los ajustes están en la base de datos de la app.
Solo el aviso de racha tiene un ajuste replicado. Los demás push de Journey van a cualquiera que tenga activadas las notificaciones push de la app. Si tu app tiene ajustes de notificaciones por tipo, replica cada uno que un Journey deba respetar.
Cosas que conviene saber \
- Busca Journeys que compartan audiencia. Clean Beans tuvo durante un tiempo dos Journeys de reenganche activos sobre el mismo segmento, lo que ponía a cada miembro inactivo en cola para ambas secuencias. Un segundo Journey sobre un segmento es fácil de activar y difícil de notar.
- Da a los push de Journey una URL y un
data.type. Las plantillas creadas en el panel no tienen ninguno de los dos por defecto, así que un toque solo abre la app. Clean Beans establece ambos en cada plantilla de Journey, para que se enruten como los push del backend. Consulta Deep links y clics en notificaciones. - Un Journey activo se puede editar, y el cambio puede afectar a quienes ya están en él. Clean Beans cambió una ventana de tiempo y añadió una espera en Journeys que estaban en marcha. Haz cambios así de forma deliberada.
- Los mensajes de Journey cuentan en la bandeja. Llegan por el mismo Event Stream que cualquier otro push, con su Liquid sin representar.
- Desactiva el seguimiento de clics en un email cuyo botón sea un Universal Link. El seguimiento reescribe los enlaces para que pasen por un dominio de seguimiento, y un enlace reescrito ya no abre la app. Consulta Abrir la app desde enlaces web normales.
Descripción general de Journeys
Reglas de entrada, pasos y cómo se ejecuta un Journey.
Ajustes de Journey
Quién entra, sale y vuelve a entrar.
Acciones de Journey
Wait, Wait Until, Yes/No, Split y Time Window.
Webhooks de Journey
Llama a tu propio servidor desde un paso de Journey.
Personalizar con eventos personalizados
Usa propiedades de eventos en los mensajes de Journey.
Journeys basados en eventos
Diseña Journeys que respondan al comportamiento.