메인 콘텐츠로 건너뛰기

​
개요

다음 가이드는 모바일 앱에서 OneSignal SDK를 설정하는 데 도움이 됩니다. 웹사이트의 경우 웹 설정을 참조하세요. 모바일 앱이 지원하는 각 플랫폼에 대해 FCM(Android), APNS(iOS), HMS(Huawei) 및/또는 ADM(Amazon)과의 연결을 설정해야 합니다. 아래 옵션을 사용하여 OneSignal 앱 및 플랫폼을 구성하세요.

​
OneSignal 앱 및 플랫폼 구성

푸시 알림에 필요한 설정 OneSignal로 푸시 알림 전송을 시작하려면 먼저 지원하는 모든 플랫폼(Apple (APNs), Google (FCM), Huawei (HMS) 및/또는 Amazon (ADM))으로 OneSignal 앱을 구성해야 합니다.
조직에 이미 OneSignal 계정이 있는 경우 관리자 역할로 초대를 요청하여 앱을 구성하세요. 그렇지 않은 경우 무료 계정에 가입하여 시작하세요.
단일 OneSignal 앱에서 여러 플랫폼(iOS, Android, Huawei, Amazon, Web)을 관리할 수 있습니다.
1

앱 만들기 또는 선택

  • 기존 앱에 플랫폼을 추가하려면 OneSignal 대시보드에서 설정 > 푸시 및 인앱으로 이동합니다.
  • 처음부터 시작하려면 New App/Website를 클릭하고 프롬프트를 따릅니다.

새 앱 만들기를 보여주는 예제.

2

플랫폼 설정 및 활성화

  • 앱 및 조직에 대해 명확하고 인식 가능한 이름을 선택합니다.
  • 구성하려는 플랫폼(iOS, Android 등)을 선택합니다.
  • Next: Configure Your Platform을 클릭합니다.

첫 번째 OneSignal 앱, 조직 및 채널 설정 예제.

3

플랫폼 자격 증명 구성

플랫폼에 따라 프롬프트를 따릅니다:자격 증명을 입력한 후 Save & Continue를 클릭합니다.
4

대상 SDK 선택

개발 플랫폼(예: iOS, Android, React Native, Unity)과 일치하는 SDK를 선택한 다음 Save & Continue를 클릭합니다.

문서로 이동할 사용 중인 SDK 선택.

5

SDK 설치 및 앱 ID 저장

플랫폼이 구성되면 OneSignal 앱 ID가 표시됩니다. 이 ID를 복사하고 저장하세요. SDK를 설치하고 초기화할 때 필요합니다.다른 사람과 협업하는 경우 Invite 버튼을 사용하여 개발자 또는 팀 구성원을 추가한 다음 Done을 클릭하여 설정을 완료합니다.

앱 ID를 저장하고 추가 팀 구성원을 초대합니다.

완료되면 선택한 플랫폼에 대한 SDK 설치 가이드를 따라 OneSignal 통합을 완료합니다.

​
SDK 설정 가이드

Google Android Native
FCM을 사용하여 네이티브 Android 앱에 OneSignal을 통합하는 가이드입니다.

iOS Native
Apple의 APNS 서비스를 사용하는 네이티브 iOS SDK 설정입니다.

Huawei Android Native
HMS 푸시 서비스를 사용하는 Huawei 장치용 SDK 설정입니다.

Unity
Unity 기반 모바일 앱용 크로스 플랫폼 SDK 가이드입니다.

React Native & Expo
React Native 및 Expo 환경에 대한 설정 지침입니다.

Cordova
이전 프레임워크를 사용하는 Cordova 앱용 레거시 SDK 가이드입니다.

Ionic & Ionic Capacitor
Ionic 및 Capacitor 하이브리드 모바일 앱 설정입니다.

Flutter
Dart를 사용하는 Flutter 앱용 SDK 가이드입니다.

.NET MAUI
.NET MAUI 앱과 통합하는 가이드입니다.

​
통합

​
FAQ

​
SDK가 필수인가요?

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

​
SDK 없이 할 수 있는 작업:

다음 API를 직접 사용할 수 있습니다:
In-app 메시지를 사용할 계획이라면 SDK가 필수입니다.

​
SDK 사용을 권장하는 이유:

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

​
중국의 장치가 푸시 알림을 받을 수 있나요?

장치에 Google Play Services/Store가 있는 경우 FCM(Firebase Cloud Messaging)을 통해 푸시 알림을 받습니다. Huawei AppGallery에서 앱을 다운로드한 경우 HMS(Huawei Messaging Service)를 통해 푸시 알림을 받습니다. Huawei SDK를 설정해야 합니다. OneSignal은 HMS와 FCM을 모두 지원하는 장치의 경우 기본적으로 FCM을 사용합니다. Huawei SDK를 설정하여 FCM보다 HMS를 선호할 수 있습니다.

​
Android를 실행하는 non-HarmonyOS Huawei 장치가 OneSignal에서 푸시를 받을 수 있나요?

예, Android를 실행하는 non-HarmonyOS Huawei 장치는 여전히 Huawei SDK를 사용할 수 있습니다.