메인 콘텐츠로 건너뛰기
OneSignal 모바일 SDK는 iOS, Android, Huawei 및 Amazon 앱에서 푸시 알림, 인앱 메시지, Live Activities를 활성화합니다. 설정은 두 단계로 이루어집니다:
  1. 플랫폼 자격 증명 구성 — FCM, APNs, HMS 또는 ADM 자격 증명을 OneSignal에 연결
  2. SDK 통합 — 플랫폼용 OneSignal SDK를 설치하고 앱에서 초기화
웹사이트의 경우 Web SDK 설정을 참조하세요.

플랫폼 자격 증명 구성

각 플랫폼에는 고유한 푸시 자격 증명이 필요합니다. SDK를 통합하기 전에 앱이 지원하는 모든 플랫폼의 자격 증명을 구성하세요.

OneSignal 앱 및 플랫폼 구성

지원하는 플랫폼(Apple (APNs), Google (FCM), Huawei (HMS), Amazon (ADM))으로 OneSignal 앱을 구성하세요.
조직에 이미 OneSignal 계정이 있는 경우 조직에 초대를 요청하세요. 그렇지 않은 경우 무료 계정에 가입하여 시작하세요.
1

앱 만들기 또는 선택

New App/Website를 클릭하여 새 앱을 만들거나 설정 > 푸시 및 인앱에서 기존 앱에 플랫폼을 추가합니다. 구성하려는 플랫폼을 선택하고 Next: Configure Your Platform을 클릭합니다.
조직 이름, 앱 이름 및 채널 선택을 포함한 새 앱 설정 흐름을 보여주는 OneSignal 대시보드
2

플랫폼 자격 증명 구성

플랫폼에 대한 자격 증명을 입력합니다:자격 증명을 입력한 후 Save & Continue를 클릭합니다.
3

앱 ID를 저장하고 SDK 설치

앱 ID가 최종 화면에 표시됩니다. 복사하고 저장하세요 — SDK를 초기화할 때 필요합니다. SDK 플랫폼을 선택한 다음 설정 가이드를 따릅니다.
설정 후 앱 ID와 팀 초대 옵션을 보여주는 OneSignal 대시보드

SDK 통합

기타 통합


SDK 버전


FAQ

SDK가 필수인가요?

아니요, 하지만 적극 권장됩니다 — GitHub에서 오픈 소스로 제공됩니다. REST API만 사용하여 OneSignal을 통합할 수 있지만, SDK를 사용하면 특히 플랫폼 전반에서 푸시 알림을 처리하는 프로세스가 크게 단순화됩니다.

SDK 없이 할 수 있는 작업은?

다음 API를 직접 사용할 수 있습니다:
인앱 메시지Live Activities는 SDK가 필요합니다 — API만으로는 전달할 수 없습니다.

SDK 사용을 권장하는 이유는?

푸시 알림에는 SDK가 처리하는 플랫폼별 요구 사항이 있습니다:
  • Android, iOS, Huawei 및 웹에서 푸시 토큰 가져오기
  • 구독 상태 및 사용자 옵트인 프롬프트 관리
  • 클라이언트에서 푸시 알림 표시 및 처리
Apple의 APNs와 Google의 FCM은 서로 다른 페이로드 형식을 사용합니다. OneSignal SDK는 사용자 지정 페이로드를 파싱하여 메시지를 정확하게 표시하고 추적합니다. 이를 수동으로 유지 관리하면 상당한 복잡성이 추가됩니다. 자세히 알아보기: Build vs. Buy: What Goes Into Building a Push Notification Platform

iOS와 Android에 별도의 OneSignal 앱이 필요한가요?

아니요. 단일 OneSignal 앱이 여러 플랫폼 — iOS, Android, Huawei, Amazon 및 웹 — 을 지원합니다. 설정 > 푸시 및 인앱에서 각 플랫폼의 자격 증명을 구성하면 모두 동일한 앱, 사용자 및 세그먼트를 공유합니다.

중국 또는 Huawei 기기가 푸시 알림을 받을 수 있나요?

기기에 Google Play 서비스가 있으면 FCM을 통해 푸시를 받습니다. 앱이 Huawei AppGallery에서 다운로드된 경우(Android를 실행하는 비-HarmonyOS Huawei 기기 포함) HMS를 통해 푸시를 받습니다 — 이를 활성화하려면 Huawei SDK를 설정하세요. OneSignal은 HMS와 FCM을 모두 지원하는 기기에는 기본적으로 FCM을 사용합니다. 필요한 경우 FCM보다 HMS를 선호하도록 설정할 수 있습니다.