메인 콘텐츠로 건너뛰기
이 페이지는 실제 앱 하나를 처음부터 끝까지 따라가는 예제 앱: OneSignal 전체 통합의 일부입니다. 앱은 공유 주택을 위한 청소 당번표 앱인 Clean Beans이며, Expo(React Native)와 Supabase 백엔드로 만들어졌습니다. 다른 모든 것은 네 가지가 올바르게 되어 있어야 동작합니다. SDK가 설치되어 있고, 앱이 시작될 때 SDK도 시작되고, 각 기기가 사용자와 연결되어 있고, 사람들이 받을 내용을 직접 제어할 수 있어야 합니다.

Expo 플러그인으로 설치하기 \

onesignal-expo-plugin은 빌드 시점에 네이티브 iOS 및 Android 프로젝트를 구성합니다. 이미지, 배지, 전송 확인을 위해 OneSignal에 필요한 푸시 capability, App Group, Notification Service Extension을 추가합니다.
app.json

루트에서 한 번만 초기화하기 \

Clean Beans는 루트 레이아웃에서 OneSignal을 초기화하므로, 앱을 실행할 때마다 어떤 화면보다도 먼저 한 번 실행됩니다.
app/_layout.tsx
첫 실행 시 권한을 요청하는 것이 가장 간단한 방법입니다. 먼저 이점을 설명하려면 시스템 프롬프트보다 앞서 인앱 메시지를 표시하세요. Clean Beans에는 바로 사용할 수 있는 메시지가 있습니다. 푸시 권한 사전 안내를 참조하세요.

각 기기를 사용자와 연결하기 \

누군가 로그인하면 앱은 Supabase 사용자 ID를 OneSignal.login()에 전달합니다. 이 ID가 External ID가 됩니다. 로그아웃하면 logout()이 기기 연결을 해제하므로, 다음에 로그인하는 사람이 이전 사용자의 메시지를 이어받지 않습니다.
app/_layout.tsx
두 메서드 중 어느 것을 호출하든 저장된 세션이 로드될 때까지 기다리세요. 콜드 스타트 시에는 로그인한 사용자를 잠시 알 수 없습니다. 이때 앱이 logout()을 호출하고 잠시 후 login()을 호출하면 기기의 푸시 구독이 익명 사용자에게 남아 External ID로 보낸 푸시가 휴대폰에 도달하지 않을 수 있습니다. logout()은 실제로 로그아웃할 때만 호출하세요.
이 한 번의 호출 덕분에 이 가이드의 모든 백엔드 전송이 가능합니다. 사용자의 데이터베이스 ID를 아는 함수는 그 사용자의 기기에 대해 아무것도 몰라도 메시지를 보낼 수 있습니다.

이메일 채널 추가하기 \

앱은 가입 시점부터 각 사용자의 이메일 주소를 알고 있으므로, 로그인할 때 이를 이메일 구독으로 등록합니다. OneSignal은 같은 주소로 반복되는 호출을 무시합니다.
src/lib/onesignalSync.ts
SMS도 addSms()로 같은 방식으로 추가하지만, 번호를 인증한 후에만 추가합니다. SMS: 인증 코드와 초대를 참조하세요.

받을 내용을 사용자가 제어하게 하기 \

알림 설정 화면에는 마스터 스위치와 메시지 유형별 스위치가 있습니다.
마스터 토글과 유형별 토글이 있는 알림 설정 화면

알림 설정: 마스터 스위치, 유형별 스위치, 일일 알림 시간.

마스터 스위치는 푸시 구독에서 optOut()과 optIn()을 호출하므로, OneSignal이 해당 기기로의 전송을 중지하거나 재개합니다.
app/notification-settings.tsx
모든 스위치는 사용자의 프로필 행에도 저장됩니다. 백엔드는 무언가를 보내기 전에 이 열을 읽으며, 이렇게 유형별 설정이 적용됩니다.
src/lib/database.ts
설정을 자체 데이터베이스에 저장하고 매번 보내기 전에 확인하면 로직을 한곳에 둘 수 있습니다. 다른 방법은 설정을 태그로 저장하고 OneSignal에서 태그로 필터링하는 것입니다. 세그먼트로 보낼 때는 이 방법이 잘 맞습니다. Clean Beans는 특정 사용자에게 보내므로 데이터베이스를 확인하는 편이 더 간단합니다.

모바일 SDK 레퍼런스

이 가이드에서 사용하는 모든 클라이언트 메서드.

사용자 및 External ID

ID가 채널과 기기 간에 구독을 연결하는 방식.