마지막 Journey 끝의 웹훅을 제외하면 어느 Journey도 자체 백엔드 코드가 없습니다. 앱이 할 일은 Journeys가 활용할 재료를 주는 것입니다.
앱이 Journey에 제공하는 것 \
Journey는 사람에 대해 세 가지를 볼 수 있습니다. 그 사람이 보낸 커스텀 이벤트, 그 사람의 태그, 그 사람이 속한 세그먼트입니다. 데이터베이스는 읽을 수 없습니다. Journey가 반응해야 하는 모든 것은 이 중 하나의 형태로 도착해야 합니다.
세션 이벤트는 태그, 커스텀 이벤트, Conversion Metrics에서 다룹니다. 나머지 두 이벤트는 Journey를 시작하기 위해서만 존재합니다.
signed_up은 계정당 한 번만 발생합니다. 먼저 계정이 생성된 지 얼마나 되었는지 확인하므로, 새 휴대폰에 앱을 설치한 사람이 온보딩을 다시 거치지 않습니다.
src/lib/onesignalSync.ts
streak_milestone은 연속 기록 길이를 숫자로 담고 있어 메시지에 표시할 수 있습니다.
src/lib/onesignalSync.ts
온보딩: 목표가 있는 시퀀스 \
온보딩 Journey의 목표는 하나, 새 구성원이 첫 청소 세션을 하도록 만드는 것입니다. 그 일이 일어나는 순간 모든 것이 멈춥니다.1
앱이 signed_up을 보냄
구성원이 Journey에 진입합니다. 각 구성원은 한 번만 거칩니다.
2
환영 이메일과 인앱 안내가 즉시 발송됨
이메일에는 시작하기 위한 세 단계가 나와 있습니다. 인앱 메시지는 구성원이 다음에 앱을 열 때 표시됩니다.
3
1일, 3일, 6일에 푸시 3회가 이어짐
각 푸시는 구성원 자신의 시간대 기준 10:00~19:00 시간 창을 기다립니다.
4
세션을 완료하면 종료됨
Journey의 종료 규칙은
cleaning_session_completed 이벤트입니다. 이미 한 일을 하라고 재촉받는 사람은 없습니다.
대시보드 설정. 진입 규칙을 Custom Event로, 이벤트를
signed_up으로 지정해 Journey를 만드세요. 종료 규칙에서 커스텀 이벤트가 발생하면 종료하도록 선택하고 cleaning_session_completed를 고르세요. 각 푸시 앞에 Time Window 단계를 두어, 03:00에 끝나는 대기가 03:00에 발송되지 않게 하세요.
세션 알림: 한 이벤트로 시작하고 다른 이벤트로 취소 \
누군가 청소 세션을 시작하고 끝내지 않으면 그 작업은 기록되지 않습니다. 이 Journey는cleaning_session_started로 시작해 3시간을 기다린 뒤 알림을 보냅니다. 종료 규칙이 cleaning_session_completed이므로 세션을 마치면 알림이 취소됩니다.
이 시작과 취소의 쌍은 쓸모 있는 Journey 중 가장 단순한 형태입니다. 같은 구조를 버려진 장바구니, 끝내지 않은 가입 양식, 보내지 않은 임시 저장 글에도 쓸 수 있습니다.
시간 창의 경계를 확인하세요. 원래 시간 창은 18:00에 닫혔습니다. 16:00에 시작한 세션은 19:00에 대기가 끝나 시간 창이 닫혀 있는 것을 확인하고, 다음 날 아침 08:00에 “you didn’t finish”라는 메시지를 받았습니다. 이제 시간 창은 21:00에 닫힙니다. 메시지가 같은 날에만 의미가 있다면, 시간 창이 닫힌 직후에 도착하는 사람에게 어떤 일이 생기는지 확인하세요.
세션 완료: 이벤트로 개인화 \
세션이 끝나면 청소한 사람은 방 이름이 담긴 짧은 확인 메시지를 받습니다. 방은 태그가 아닙니다. Journey를 시작한 이벤트에서 가져옵니다.Push template: Cleaning Session Completed
journey.first_event.properties는 진입 이벤트의 속성을 읽습니다. user_name만 쓰면 태그를 읽고, default 필터는 태그가 없는 사람을 처리합니다.
이 Journey는 한 단계뿐입니다. 백엔드에서 푸시 보내기에서 같은 세션을 집안 사람들에게 알리는 푸시처럼 백엔드에서 보낼 수도 있었습니다. Journey로 만든 이유는 대시보드에서 문구를 바꾸고, 테스트하고, 끌 수 있기 때문입니다.
방별 프로모션: 이벤트 속성으로 분기 \
이 Journey는 어떤 방을 청소했는지에 따라 다른 메시지를 보냅니다. 두 가지를 보여 줍니다. 이벤트가 일어날 때까지 사람을 대기시키는 것, 그리고 그 이벤트의 속성으로 분기하는 것입니다. 구성원은 최근 7일 동안 활동한 사람들의 세그먼트에서 진입합니다. 첫 단계는 브랜치가 세 개인 Wait Until입니다. 각 브랜치는 특정room_name이 담긴 cleaning_session_completed를 기다립니다.
다른 방에서 한 세션은 어느 브랜치와도 일치하지 않으며, 구성원은 계속 대기합니다. 30분 후 재진입이 허용되므로 Journey는 새 세션마다 반응합니다.
이 Journey의 푸시는 가상의 청소 제품을 광고합니다. 패턴을 보여 주기 위한 것입니다. 또한 앱의 알림 설정이 다루지 않는 마케팅 메시지이므로, 실제 앱에서는 이 점을 설계에 반영해야 합니다. Journeys가 볼 수 없는 것을 참조하세요.
연속 기록 마일스톤: 숫자가 담긴 이벤트 \
연속 기록이 마일스톤에 도달했는지는 앱이 판단합니다. 방금 새 연속 기록을 저장했기 때문입니다. 앱은 길이와 함께streak_milestone을 보내고, 나머지는 Journey가 처리합니다.
Push template: Streak - Milestone reached
두 개의 Journey, 하나의 순간. 마일스톤은 항상 세션이 끝날 때 발생하며, 이때는 세션 완료 Journey가 발송하는 시점이기도 합니다. 1분 대기가 없으면 두 푸시가 동시에 도착합니다. 여러 Journey가 같은 사용자 행동으로 시작된다면 나란히 놓고 살펴보세요.
연속 기록 끊김 임박: 타이밍, 세그먼트 확인, 다양한 문구 \
세션이 없는 날에는 자정에 연속 기록이 끝납니다. 이 Journey는 그날 저녁 구성원에게 경고합니다. 7개 중 가장 복잡하며, 각 단계가 서로 다른 문제를 해결합니다.
알맞은 저녁에 도착하기. 경고는 마지막 세션이 몇 시였든 그다음 날 저녁에 도착해야 합니다. 22시간 대기 후 18:00~22:00 시간 창을 두면 항상 그 시점에 도착합니다. 08:00 세션은 다음 날 06:00에 시간 창 단계에 도달해 18:00까지 대기합니다. 23:00 세션은 다음 날 21:00에 도달해 바로 발송됩니다.
Journey가 볼 수 없는 설정 존중하기. Clean Beans의 알림 설정에는 데이터베이스에 저장되는 “Streak reminders” 스위치가 있습니다. 앱은 이를 태그로 미러링합니다.
src/lib/onesignalSync.ts
streak_count가 1보다 크고 streak_reminders가 on이어야 합니다. 이전 빌드를 쓰는 구성원에게는 streak_reminders 태그가 아예 없으므로 세그먼트에서 빠지고 경고를 받지 않습니다.
문구 다양화하기. 매일 저녁 같은 문장이면 쉽게 눈에 들어오지 않게 됩니다. Split 단계는 각 사람을 다섯 브랜치 중 하나로 무작위로 보내며, 브랜치마다 자체 템플릿이 있습니다. 진입할 때마다 브랜치를 다시 고르므로 구성원은 저녁마다 다른 문구를 보게 됩니다.
Clean Beans는 Live Activities에서 설명하는 Live Activity로도 연속 기록 경고를 표시합니다. Live Activities를 켠 구성원은 둘 다 받습니다. 푸시는 Android 사용자와 Live Activities를 끈 사람을 위한 것입니다.
재참여와 Journey 웹훅 \
마지막 Journey는 앱을 더 이상 열지 않는 구성원을 다룹니다. 세그먼트만으로 진입하는 유일한 Journey이자 백엔드를 호출하는 유일한 Journey입니다.
30일 후 재진입이 허용됩니다. 진입은 Journey가 시작된 뒤 세그먼트에 들어온 사람으로 제한됩니다. 이 제한이 없으면 Journey를 켠 날 이미 비활성 상태인 모든 사람이 첫 푸시를 즉시 받습니다.
시퀀스가 끝나면 백엔드에 알리기 \
청소하지 않고 끝까지 도달한 구성원은 메시지 네 개에 반응하지 않은 것입니다. 다섯 번째 메시지가 도움이 될 가능성은 낮습니다. 대신 Clean Beans는 가구에 알립니다. Webhook 단계가 백엔드 함수를 호출하고, 이 함수는 구성원을 비활성으로 표시한 뒤 가구의 소유자와 관리자에게 알립니다. 대시보드 설정. 다음 설정으로 Journey 웹훅을 만들고 Journey의 마지막 단계에서 선택하세요.Journey webhook
supabase/functions/journey-webhook/index.ts
supabase/functions/journey-webhook/index.ts
supabase/functions/journey-webhook/index.ts
Journeys가 볼 수 없는 것 \
이 가이드의 모든 백엔드 전송은 보내기 전에 구성원의 알림 설정을 확인합니다. 설정이 앱의 데이터베이스에 있으므로 Journey는 그렇게 할 수 없습니다.
미러링된 설정이 있는 것은 연속 기록 경고뿐입니다. 다른 Journey 푸시는 앱의 푸시 알림을 켠 모든 사람에게 갑니다. 앱에 유형별 알림 설정이 있다면 Journey가 존중해야 하는 설정을 각각 미러링하세요.
알아 둘 점 \
- 대상이 겹치는 Journey를 찾아보세요. Clean Beans에서는 한때 같은 세그먼트에 재참여 Journey 두 개가 동시에 운영되어, 비활성 구성원 모두가 두 시퀀스의 대상이 되었습니다. 세그먼트에 두 번째 Journey를 켜기는 쉽지만 알아차리기는 어렵습니다.
- Journey 푸시에 URL과
data.type을 지정하세요. 대시보드에서 만든 템플릿에는 기본적으로 둘 다 없으므로, 탭해도 앱만 열립니다. Clean Beans는 모든 Journey 템플릿에 둘 다 설정해 백엔드 푸시처럼 라우팅되게 합니다. 딥 링크 및 알림 클릭을 참조하세요. - 활성 Journey는 편집할 수 있으며, 편집 내용이 이미 진행 중인 사람에게 영향을 줄 수 있습니다. Clean Beans는 실행 중인 Journey의 시간 창을 바꾸고 대기를 추가했습니다. 이런 변경은 신중하게 하세요.
- Journey 메시지도 수신함에 들어갑니다. 다른 모든 푸시와 같은 Event Stream을 통해, Liquid가 렌더링되지 않은 상태로 도착합니다.
- 버튼이 Universal Link인 이메일에서는 클릭 추적을 끄세요. 추적은 링크가 추적 도메인을 거치도록 다시 쓰며, 다시 쓰인 링크로는 더 이상 앱이 열리지 않습니다. 일반 웹 링크로 앱 열기를 참조하세요.
Journeys 개요
진입 규칙, 단계, Journey가 실행되는 방식.
Journey 설정
누가 진입하고, 종료하고, 재진입하는지.
Journey 액션
Wait, Wait Until, Yes/No, Split, Time Window.
Journey 웹훅
Journey 단계에서 자체 서버를 호출하세요.
커스텀 이벤트로 개인화
Journey 메시지에서 이벤트 속성을 사용하세요.
이벤트 기반 Journeys
행동에 반응하는 Journeys를 설계하세요.