시작 단계

• UGS와 Analytics에 가입합니다.
• Unity 에디터 프로젝트에 대시보드를 연결합니다.
• 게임 코드에서 UGS를 초기화합니다.

가입

1. Unity Services Dashboard에 로그인합니다.
2. 측면 패널에서 Explore Services를 선택합니다.
3. 상단 배너에서 Sign Up을 선택한 후 표시되는 지침을 따릅니다.
4. Analytics 기술 자료를 확인합니다.

프로젝트 연결

1. Unity 에디터 메뉴에서 Edit > Project Settings로 이동한 후, Services 탭을 엽니다.
2. Unity ID로 로그인하지 않았다면 새 Unity ID를 생성하거나 기존 Unity ID로 로그인합니다.
3. 새 프로젝트를 생성하려면 조직을 선택하고 Create를 선택합니다. 기존 프로젝트에 연결하려면 I already have a Unity Project ID를 선택합니다.
4. 드롭다운에서 조직과 프로젝트를 선택하고 Link를 선택합니다.

연동

1. SDK 연동: 패키지를 연동하고 Push Notifications를 등록하여 설정 및 키를 입력합니다.
2. 키 업로드: 비공개 키(Firebase, Apple)를 찾아서 Unity Dashboard에 업로드합니다.
3. 연동 테스트: 디바이스로 테스트 알림을 전송하여 연동 완료 여부를 확인합니다.
4. 알림 캠페인 생성: Unity Dashboard에서 첫 알림을 생성하고 예약합니다.

1. Push Notifications SDK 연동

Push Notifications SDK 설치

1. Unity 레지스트리를 사용하여 임포트

1. Edit > Project Settings에서 Project Settings를 엽니다.
2. Enable Pre-release Packages는 Package Manager > Advanced Settings > Enable Pre-release Packages에서 활성화합니다.

   

3. Component > Package Manager에서 패키지 관리자를 엽니다.
4. Packages 드롭다운에서

   Unity Registry

   를 선택합니다.
5. 오른쪽 상단의 검색 바에서

   Push Notifications

   를 검색하여 Push Notifications 패키지를 확인합니다.

   

6. 오른쪽 상단에서

   Install

   을 선택합니다.

2. 이름으로 임포트

1. Component > Package Manager에서 패키지 관리자를 엽니다.
2. 왼쪽 상단에서 Add(+) 버튼을 선택하여 새 패키지를 추가하고 Add package by name... 을 선택합니다.

   

3. com.unity.services.push-notifications를 Git URL로 입력하고 Add를 선택합니다.

   

3. ‘manifest.json’ 파일을 사용하여 임포트

1. 다음 코드 스니핏을 복사하고 패키지 버전을 조정합니다.

   "com.unity.services.push-notifications": "4.0.0-pre.1"

2. 파일 탐색기에서 프로젝트 폴더의 루트로 이동한 다음, 패키지 폴더

   Packages/manifest.json

   으로 이동합니다.

3. manifest.json

   파일 끝에 복사한 코드와 필요에 따라 끝에 콤마(

   ,

   )를 추가합니다.

Push Notifications 등록

2. 서비스 키 업로드

Google

1. Firebase Console로 이동하여 프로젝트를 선택합니다.
2. Project Settings로 이동하고 상단에서 Service accounts를 선택합니다.
3. Create service account를 선택합니다.

   

4. Generate new private key를 선택합니다.

   

5. Generate key를 선택하여 키 파일을 다운로드합니다.

   

6. Unity Dashboard의 프로젝트에서 Liveops > Push Notifications > Settings로 이동한 다음, Google Keys로 이동한 후 ‘Google Key’ 열에서

   Add Key

   또는 편집 아이콘을 선택합니다.
7. 이전 단계에서 만든 비공개 키를 업로드하고 Finish를 선택합니다.

Apple

1. Apple Developer 콘솔에 로그인합니다.
2. Certificates, Identifiers & Profiles 페이지로 이동하여 Keys를 선택합니다.
3. + 기호를 선택하여 새 키를 생성합니다.
4. 키 이름을 지정하고 ‘Apple Push Notifications service (APNs)’ 옵션을 활성화하여 알림을 사용 설정합니다. 그런 다음 Continue를 선택합니다. 참고로 계정별로 키 두 개에만 이 기능을 활성화할 수 있습니다.

   

5. 다음 페이지에서 Register를 선택하여 확인합니다.
6. 생성된 키를 다운로드하고 나중에 필요할 수 있는 Key ID를 기록해 둡니다. 키 파일은 한 번만 다운로드할 수 있으며 분실되면 폐기하고 다시 생성해야 합니다.

   

7. Unity Dashboard의 프로젝트에서 Player Engagement > Notifications > Settings로 이동하여 상단의 Setup 배너에 있는

   Set Up Keys

   링크를 클릭합니다. 그런 다음 ‘Apple Key’ 열에서

   Add Key

   또는 편집 아이콘을 선택합니다.
8. 다음의 필드 5개를 작성해야 합니다.

• Key: 이전 단계에서 만든 키를 업로드합니다.
• Key ID 키를 등록할 때 제공되며 Apple Developer 콘솔에서 키를 선택하여 검색할 수도 있습니다.
• Team ID: Apple Developer 콘솔의 계정 이름에 표시되는 팀 ID입니다.
• Topic ID: 게임의 번들 ID로 채워집니다. Apple Developer 콘솔의 ‘Certificates, Identifiers & Profiles’ 페이지의 ‘Identifiers’에 명시된 것과 정확히 일치해야 합니다.
• Sandbox: 게임의 개발 및 디버그 빌드에서 플레이어에게 메시지를 보내려면 Sandbox 값을 True로 설정합니다. 프로덕션 빌드에서 사용자에게 메시지를 보내려면 False로 설정합니다.

  

9. Finish를 선택합니다. 편집 설정 페이지에 다시 들어가면 보안상의 이유로 이 파일이 표시되지 않습니다.
10. XCODE 내에서 애플리케이션을 빌드할 때 앱에 ‘Remote notification’ 기능이 추가되어야 알림을 받을 수 있습니다.

Failed to register for remote notifications: no valid “aps-environment” entitlement string found for application

3. 연동 테스트

4. 알림 캠페인 생성