​

Windows 앱 설정

​

요구 사항

• Universal Windows Platform (UWP) 앱 - OneSignal은 현재 UWP 앱만 지원합니다
• Microsoft Store 앱 등록 - Package SID 및 Secret Key를 얻는 데 필요합니다
• OneSignal 계정 - 구성된 앱 및 플랫폼 설정이 있는 무료 계정

​

OneSignal 앱 및 플랫폼 구성

​

1단계: OneSignal 계정 설정

​

2단계: OneSignal 앱 생성 또는 구성

​

새 앱 만들기

1. 대시보드에서 New App/Website를 클릭합니다
2. 인식 가능한 앱 이름과 조직 이름을 선택합니다
3. 플랫폼으로 **Windows (UWP)**를 선택합니다
4. Next: Configure Your Platform을 클릭합니다

Windows 플랫폼으로 새 OneSignal 앱 만들기

​

기존 앱에 플랫폼 추가

1. 기존 앱을 선택합니다
2. 설정 > 푸시 및 인앱으로 이동합니다
3. Add Platform을 클릭하고 **Windows (UWP)**를 선택합니다

OneSignal 앱 설정 및 Windows 플랫폼 선택

​

3단계: 추가 플랫폼 구성 (선택 사항)

• Android: Firebase 자격 증명 설정
• iOS: p8 토큰(권장) 또는 p12 인증서
• Amazon: API 키 생성
• Huawei: OneSignal 권한 부여

​

4단계: 대상 SDK 선택

플랫폼별 문서에 액세스하려면 Windows UWP SDK 선택

​

5단계: 앱 ID 저장

앱 ID를 저장하고 액세스가 필요한 팀 구성원 초대

​

Windows 플랫폼 구성

​

Microsoft Store 자격 증명 가져오기

1. Microsoft Store에 게시 - 앱이 Microsoft Store에 등록되어 있어야 합니다(공개적으로 사용 가능하지 않더라도)
2. Package SID 및 Secret Key 얻기 - 이러한 자격 증명을 검색하려면 Microsoft의 상세 가이드를 따르세요
3. OneSignal 플랫폼 구성:
   • OneSignal 대시보드에서 **설정 > Windows (UWP)**로 이동합니다
   • Package SID 및 Secret Key를 붙여넣습니다
   • Save를 클릭하여 플랫폼을 활성화합니다

OneSignal 대시보드에서 Windows 플랫폼 자격 증명 구성

주의: Package SID 및 Secret Key는 앱이 Microsoft Store에 등록된 후에만 사용할 수 있습니다. 이러한 자격 증명 없이는 로컬에서 푸시 알림을 테스트할 수 없습니다.

​

SDK 통합

​

아키텍처 이해

1. Windows Push Notification Service (WNS) - Microsoft의 기본 푸시 서비스
2. OneSignal REST API - 사용자 관리 및 메시지 전송용
3. Notification Channel URI - 푸시 알림의 장치 토큰 역할

​

푸시 알림을 위한 사용자 등록

​

1단계: 알림 채널 요청

// Example: Getting notification channel URI
var channel = await PushNotificationChannelManager.CreatePushNotificationChannelForApplicationAsync();
string channelUri = channel.Uri; // This is your token for OneSignal

​

2단계: OneSignal 사용자 레코드 생성

• subscription.type: "WindowsPush"
• subscription.token: 1단계의 채널 URI

• identity.external_id: 사용자의 고유 식별자(예: 시스템의 사용자 ID)
• properties: 타겟팅을 위한 모든 사용자 지정 사용자 속성

{
  "identity": {
    "external_id": "your-user-id-123"
  },
  "subscriptions": [
    {
      "type": "WindowsPush",
      "token": "https://cloud.notify.windows.com/?token=..."
    }
  ],
  "properties": {
    "tags": {
      "user_type": "premium",
      "app_version": "1.2.0"
    }
  }
}

주의: 채널 URI는 만료되고 변경될 수 있습니다. 채널 URI를 주기적으로 새로 고치고 변경될 때 OneSignal 사용자 레코드를 업데이트하는 로직을 구현하세요.

​

채널 URI 변경 처리

channel.PushNotificationReceived += OnPushNotificationReceived;

// Check if channel URI has changed
if (channel.Uri != storedChannelUri) {
    // Update OneSignal user record with new URI
    await UpdateOneSignalUser(channel.Uri);
}

​

푸시 알림 전송

​

OneSignal 대시보드 사용

1. OneSignal 대시보드에서 메시지 > 푸시로 이동합니다
2. 새 푸시 알림을 만듭니다
3. Windows 플랫폼을 선택합니다
4. 메시지 콘텐츠와 타겟팅을 구성합니다
5. 즉시 전송하거나 나중에 예약합니다

​

OneSignal API 사용

{
  "app_id": "your-onesignal-app-id",
  "contents": {"en": "Your notification message"},
  "headings": {"en": "Notification Title"},
  "include_external_user_ids": ["your-user-id-123"],
  "channel_for_external_user_ids": "push"
}

​

다음 단계 및 모범 사례

​

통합 테스트

1. 알림 채널 생성 테스트 - 앱이 WNS 채널을 성공적으로 생성하고 유지 관리하는지 확인합니다
2. 사용자 등록 확인 - 사용자가 OneSignal 대시보드에 올바르게 등록되었는지 확인합니다
3. 테스트 알림 전송 - OneSignal 대시보드를 사용하여 테스트 메시지를 전송합니다
4. 알림 이벤트 처리 - 알림 수신, 열림 및 해제 이벤트에 대한 적절한 처리를 구현합니다

​

일반적인 문제 및 해결 방법

• Package SID 및 Secret Key가 올바르게 구성되었는지 확인합니다
• 앱이 Microsoft Store에 올바르게 등록되어 있는지 확인합니다
• 채널 URI가 만료되지 않았는지 확인합니다

• OneSignal 사용자 레코드가 성공적으로 생성되었는지 확인합니다
• OneSignal에서 Windows 플랫폼이 올바르게 구성되었는지 확인합니다
• Windows 알림 설정에서 알림이 차단되지 않았는지 확인합니다

• OneSignal 앱 ID가 올바른지 확인합니다
• 올바른 API 엔드포인트와 인증을 사용하고 있는지 확인합니다
• 문제 해결을 위해 API 응답 코드 및 오류 메시지를 검토합니다

​

프로덕션 고려 사항

• 모든 OneSignal API 호출에 대한 적절한 오류 처리를 구현합니다
• 채널 URI 새로 고침 실패에 대한 모니터링을 설정합니다
• 네트워크 문제 중 API 호출을 위한 오프라인 큐잉 구현을 고려합니다
• 최대 앱 사용 기간 동안 사용자 등록 확장을 계획합니다