메인 콘텐츠로 건너뛰기
이 페이지는 실제 앱 하나를 처음부터 끝까지 따라가는 예제 앱: OneSignal 전체 통합의 일부입니다. 앱은 공유 주택을 위한 청소 당번표 앱인 Clean Beans이며, Expo(React Native)와 Supabase 백엔드로 만들어졌습니다. 알림은 탭했을 때 올바른 곳으로 이동해야 쓸모가 있습니다. Clean Beans는 앱에 들어오는 네 가지 경로를 처리합니다. 탭한 푸시, 푸시에서 탭한 버튼, 커스텀 스킴 링크, 일반 웹 링크입니다.

탭한 푸시 라우팅하기 \

모든 푸시에는 data.type 필드가 있습니다. 앱은 탭을 감지해 유형을 읽고 해당 화면을 엽니다.
app/_layout.tsx
이 중 두 유형은 이 가이드에서 다루지 않는 Journeys에서 옵니다. reengagement는 대시보드에서 만든 재참여 Journey의 푸시에 설정됩니다. member_lapsed는 가구의 소유자와 관리자에게 보내는 푸시로, 해당 Journey가 구성원이 청소를 멈췄다고 보고하면 백엔드가 보냅니다. 이들도 다른 푸시처럼 여기서 라우팅됩니다.
직접 관리하는 유형으로 라우팅하는 것이 URL을 파싱하는 것보다 견고합니다. 화면이 옮겨지면 switch 문 하나만 바꾸면 되고, 변경 전에 보낸 모든 푸시도 계속 올바르게 열립니다.

액션 버튼: 탭할 수 있는 곳 늘리기 \

푸시에는 버튼을 넣을 수 있습니다. 작업 푸시에는 Start cleaning과 Snooze 1h가 있고, “하우스메이트가 청소를 마침” 푸시에는 Send kudos가 있습니다. 알림을 펼치면 버튼이 나타나며, iOS에서는 길게 누르면 됩니다.
Start cleaning과 Snooze 1h 버튼이 있는 펼친 푸시 알림

두 개의 액션 버튼이 있는 펼친 알림.

백엔드가 요청에 버튼을 추가합니다. 각 버튼에는 id와 레이블이 있습니다.
supabase/functions/_shared/buttons.ts
버튼을 탭하면 앱이 열리고, 위에 나온 클릭 리스너가 버튼의 id를 event.result.actionId로 받습니다. 알림 자체를 탭하면 actionId가 없습니다. 앱은 먼저 버튼인지 확인하고, 아니면 일반 라우팅으로 넘어갑니다.
src/lib/pushActions.ts
앱은 푸시를 보낼 수 없으므로 다시 알림에는 백엔드가 필요합니다. 앱은 send_after로 다음 알림을 예약하는 함수를 호출합니다. OneSignal이 그 시간까지 메시지를 보관하므로 한 시간 동안 무언가를 계속 실행할 필요가 없습니다.
supabase/functions/snooze-reminder/index.ts
모든 버튼 탭은 커스텀 이벤트 push_action_clicked로도 기록됩니다. Journey는 버튼에 따라 직접 분기할 수 없지만, 이 이벤트를 기다렸다가 action_id 속성으로 분기할 수 있습니다.
버튼을 탭하면 기본적으로 앱이 열립니다. 앱을 열지 않고 탭을 처리하려면 네이티브 코드가 필요합니다. iOS에서는 알림 카테고리, Android에서는 notification service extension입니다.
앱 밖에서 오는 링크는 /clean 같은 짧은 경로를 사용합니다. Expo Router의 native intent 훅이 이동 전에 이를 앱의 실제 경로로 재작성하므로, 앱 밖의 어떤 것도 화면 구성을 알 필요가 없습니다.
app/+native-intent.tsx
cleaning-rota:// 같은 커스텀 스킴은 앱이 설치된 경우에만 동작하며, 많은 앱이 이를 탭할 수 있게 만들지 않습니다. iOS의 Universal Links와 Android의 App Links가 이 문제를 해결합니다. 이들은 앱이 설치되어 있으면 앱을, 그렇지 않으면 웹사이트를 여는 일반 https:// 링크입니다. 그래서 이메일, SMS, 공유 메시지의 링크에 적합합니다. 설정하려면 양쪽에 선언이 필요합니다. 앱은 자신이 속한 도메인을 선언하고, 웹사이트는 어떤 앱이 자신의 링크를 열 수 있는지 선언합니다.
1

앱에 도메인 선언하기

app.json
2

Apple 연결 파일 게시하기

/.well-known/apple-app-site-association에 HTTPS로, JSON 형식으로 호스팅하세요. 앱 ID는 Apple Team ID 뒤에 번들 식별자를 붙인 것입니다.
website/.well-known/apple-app-site-association
3

Android 연결 파일 게시하기

/.well-known/assetlinks.json에 호스팅하세요. 지문은 앱의 서명 인증서에서 가져옵니다. EAS에서는 eas credentials -p android를 실행해 확인할 수 있습니다.
website/.well-known/assetlinks.json
4

링크 사용하기

가구 화면은 초대 링크를 공유합니다. 링크를 탭하면 코드가 미리 입력된 상태로 가입 화면이 열립니다.
app/household.tsx
app/join-household.tsx
Clean Beans는 앱이 보여줄 수 있는 경로만 처리합니다. 홈페이지는 대상에서 제외하므로 마케팅 사이트는 계속 브라우저에서 열립니다. iOS는 앱을 설치하거나 업데이트할 때 연결 파일을 읽으므로, 빌드를 출시하기 전에 파일을 게시하세요.

딥 링크

OneSignal이 플랫폼별로 URL을 처리하는 방식.

알림 페이로드

클릭 리스너에서 사용할 수 있는 모든 필드.

액션 버튼

플랫폼 제한, 아이콘, 탭 처리.