메인 콘텐츠로 건너뛰기
대부분의 OneSignal 가이드는 한 번에 하나의 기능을 설명합니다. 이 가이드는 하나의 앱을 처음부터 끝까지 따라가며, 프로덕션에서 실행되는 코드와 함께 모든 메시징 기능이 어떻게 연결되었는지 보여줍니다. 앱은 공유 주택을 위한 청소 당번표 앱인 Clean Beans입니다. Expo(React Native)로 만들어졌으며 데이터베이스, 인증, 백엔드 함수에 Supabase를 사용합니다. 앱이 보내는 모든 메시지는 OneSignal이 처리합니다.
Clean Beans의 세 화면: 대시보드, 청소 세션, 주간 당번표

Clean Beans: 대시보드, 청소 세션, 주간 당번표.

Clean Beans가 하는 일 \

가구가 방을 추가하면 앱은 이를 적절한 빈도의 청소 작업 목록으로 바꿉니다. 당번표 생성기는 각 사람의 가용 시간에 맞춰 작업을 일주일에 걸쳐 배분합니다. 구성원들은 청소 세션을 진행하고, 작업을 체크하고, 매일 연속 기록을 쌓고, 서로 kudos를 보내고, 주간 순위표에서 경쟁합니다. 청소는 공유되고, 반복되며, 시간 제한이 있기 때문에 알림, 소셜 업데이트, 카운트다운, 요약, 코칭 등 거의 모든 종류의 메시지에 잘 맞습니다.

이 가이드가 있는 이유 \

이 가이드를 사용해 세 가지 질문에 답하세요.
  • 어떤 OneSignal 기능이 어떤 작업에 맞을까요? 각 페이지는 앱이 해야 했던 일에서 시작해 그 일을 하는 기능을 보여줍니다.
  • 코드는 어디에 둘까요? 어떤 작업은 앱에, 어떤 작업은 백엔드에, 어떤 작업은 OneSignal 대시보드에 속합니다. 각 예제에서 어디에 속하는지 알려줍니다.
  • 무엇이 잘못될 수 있을까요? 각 페이지의 경고와 참고에는 실제로 출시하면서 배운 내용이 담겨 있습니다. collapse_id 설정은 시도했다가 제거했으며, 안정적이고 올바르게 동작하는 푸시에서 그 이유를 설명합니다.

읽는 방법 \

이 가이드는 주제별로 한 페이지씩 구성되어 있습니다. 순서대로 읽을 필요는 없습니다. SDK 설정 및 사용자 ID는 다른 모든 내용의 기반입니다. 그 이후의 각 페이지는 독립적으로 읽을 수 있습니다. 대부분의 기능은 같은 방식으로 소개됩니다.
  1. 사용자에게 보이는 것, 보통 스크린샷과 함께 제공됩니다.
  2. 작동 방식, 누가 무엇을 하는지에 대한 짧은 흐름입니다.
  3. 코드, 앱에서 가져온 것입니다. 각 코드 블록의 제목은 원본 파일입니다.
  4. 대시보드 설정, 기능을 OneSignal에서 구성해야 하는 경우입니다.
제한 사항과 예상치 못한 동작은 해당 기능 옆의 경고와 참고에 표시되어 있습니다.
코드는 실제 코드이지만, 식별자는 YOUR_ONESIGNAL_APP_ID, YOUR_PROJECT_REF 같은 자리표시자로 바꿨습니다. 긴 파일은 중요한 줄만 남겼습니다. // ...만 있는 줄은 코드를 생략한 위치를 나타냅니다.

구성 요소가 함께 동작하는 방식 \

External ID가 이 세 가지를 연결합니다. Clean Beans는 로그인 시 External ID를 Supabase 사용자 ID로 설정하므로, 백엔드는 이미 저장하고 있는 ID로 누구에게나 메시지를 보낼 수 있습니다.
Expo 앱, Supabase 백엔드, OneSignal 대시보드를 보여주는 아키텍처 다이어그램

앱, 백엔드, 대시보드는 각각 OneSignal과 통신합니다. External ID가 이들을 한 사용자로 연결합니다.

기능 맵 \

필요한 것 \

  • iOS와 Android 푸시가 구성되어 있고 이메일과 SMS도 설정된 OneSignal 앱. 채널 설정을 참조하세요.
  • EAS Build로 빌드한 Expo 앱. OneSignal SDK에는 네이티브 코드가 필요하므로 Expo Go로는 충분하지 않습니다. Expo SDK 설정을 참조하세요.
  • App ID와 App API key. 키 및 ID를 참조하세요.
  • 일정에 따라, 그리고 요청에 응답해 코드를 실행할 수 있는 백엔드. Clean Beans는 Supabase Edge Functions와 pg_cron을 사용합니다. 같은 패턴은 어떤 백엔드에도 적용됩니다.

효과가 있었던 원칙 \

  • External ID를 먼저 설정하세요. 여기 나오는 거의 모든 기능이 External ID에 의존합니다. 백엔드가 이미 저장하고 있는 ID를 사용하세요.
  • 각 작업을 알맞은 곳에 두세요. 앱은 기기와 로그인한 사용자를 처리합니다. 백엔드는 일정과 데이터 변경을 처리합니다. 대시보드에는 릴리스 없이 바꾸고 싶은 모든 것을 둡니다.
  • 보내기 전에 확인하세요. 백엔드의 모든 전송은 사용자의 설정을 확인하고 전할 만한 내용이 있는지 확인합니다.
  • 예약 전송을 반복 실행해도 안전하게 만드세요. 유형, 수신자, 날짜로 만든 멱등성 키를 사용하면 재시도해도 아무 일도 일어나지 않습니다.
  • URL이 아니라 유형으로 라우팅하세요. data.type 필드가 있으면 화면이 옮겨져도 이전 알림이 계속 올바르게 동작합니다.
  • 호출자가 알려주는 내용을 검증하세요. 메시지를 보내는 함수는 먼저 자체 데이터베이스에서 사실을 확인해야 합니다.

전체 기능 한눈에 보기 \

시크릿 \

백엔드 함수는 이 값들을 환경 변수에서 읽습니다. 어떤 값도 앱에 포함되지 않습니다.
App API key는 모든 사용자에게 메시지를 보낼 수 있습니다. 백엔드에만 보관하세요. 앱 자체에는 App ID만 있으면 됩니다.