메인 콘텐츠로 건너뛰기
이 페이지는 실제 앱 하나를 처음부터 끝까지 따라가는 예제 앱: OneSignal 전체 통합의 일부입니다. 앱은 공유 주택을 위한 청소 당번표 앱인 Clean Beans이며, Expo(React Native)와 Supabase 백엔드로 만들어졌습니다. 이 가이드의 메시지 대부분은 백엔드가 한 번에 하나의 요청으로 보냅니다. Journey는 다릅니다. OneSignal 대시보드에서 만드는 시퀀스로, 누구에게 언제 메시지를 보내고 다음에 무엇을 할지 스스로 결정합니다. Clean Beans는 몇 시간이나 며칠에 걸쳐 진행되는 일, 그리고 릴리스 없이 바꿀 수 있어야 하는 문구와 타이밍에 Journeys를 사용합니다. Clean Beans는 7개의 Journey를 운영합니다. 마지막 Journey 끝의 웹훅을 제외하면 어느 Journey도 자체 백엔드 코드가 없습니다. 앱이 할 일은 Journeys가 활용할 재료를 주는 것입니다.

앱이 Journey에 제공하는 것 \

Journey는 사람에 대해 세 가지를 볼 수 있습니다. 그 사람이 보낸 커스텀 이벤트, 그 사람의 태그, 그 사람이 속한 세그먼트입니다. 데이터베이스는 읽을 수 없습니다. Journey가 반응해야 하는 모든 것은 이 중 하나의 형태로 도착해야 합니다. 세션 이벤트는 태그, 커스텀 이벤트, Conversion Metrics에서 다룹니다. 나머지 두 이벤트는 Journey를 시작하기 위해서만 존재합니다. signed_up은 계정당 한 번만 발생합니다. 먼저 계정이 생성된 지 얼마나 되었는지 확인하므로, 새 휴대폰에 앱을 설치한 사람이 온보딩을 다시 거치지 않습니다.
src/lib/onesignalSync.ts
streak_milestone은 연속 기록 길이를 숫자로 담고 있어 메시지에 표시할 수 있습니다.
src/lib/onesignalSync.ts
Journey를 시작하는 이벤트는 OneSignal.login()을 호출한 뒤에만 보내세요. 로그인 전에 보낸 이벤트는 곧 로그인할 사람이 아니라 익명 사용자에게 기록됩니다. Clean Beans는 같은 effect에서 login() 바로 다음에 trackSignedUpOnce()를 호출합니다. SDK 설정 및 사용자 ID를 참조하세요.

온보딩: 목표가 있는 시퀀스 \

온보딩 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로 만든 이유는 대시보드에서 문구를 바꾸고, 테스트하고, 끌 수 있기 때문입니다.
Event Stream은 Journey 메시지를 작성된 그대로, Liquid가 남아 있는 상태로 보고합니다. Clean Beans 수신함은 웹훅이 렌더링하는 법을 익히기 전까지 {{ journey.first_event.properties.room_name }} cleaned를 표시했습니다. 저장하기 전에 Liquid 렌더링하기를 참조하세요.

방별 프로모션: 이벤트 속성으로 분기 \

이 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
함수는 무엇보다 먼저 시크릿을 확인합니다. OneSignal은 Supabase 토큰을 보내지 않으므로 이 함수는 Supabase의 토큰 확인 없이 배포됩니다. 따라서 공유 시크릿이 엔드포인트와 공개 인터넷 사이의 유일한 보호 장치입니다.
supabase/functions/journey-webhook/index.ts
그런 다음 그 주장을 직접 확인합니다. Journey는 구성원이 비활성이라고 말하지만, Journey가 아는 것은 앱 세션과 이벤트뿐입니다. 청소를 했는지는 데이터베이스가 압니다.
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를 설계하세요.