Push Notifications SDK

플랫폼 지원

빠른 시작

Push Notifications 등록

1. 에디터에서 설정을 채웁니다. Project Settings > Services > Push Notifications에서 확인할 수 있습니다.
2. Unity 서비스를 초기화하면 필수 분석 이벤트가 Unity Analytics로 전송될 수 있습니다. 또한 필수 이벤트의 개인정보 보호 플로가 구현되어야 올바르게 전송될 수 있습니다.
3. 게임의 시작 코드에 알림을 등록하여 알림이 누락되지 않도록 합니다. 그러나 첫 등록 시 사용자에게 권한 요청이 표시되므로 이 호출이 게임 내에서 지장을 주지 않는 위치에 나타나도록 해야 합니다. SDK에서는 이미지, 제목, 메시지 본문 등의 알림 콘텐츠 표시를 처리합니다.

using Unity.Services.Analytics;using Unity.Services.Core;using Unity.Services.PushNotifications;...await UnityServices.InitializeAsync();bool userGaveConsent = ...;if (userGaveConsent){	AnalyticsService.Instance.StartDataCollection();}try{    string pushToken = await PushNotificationsService.Instance.RegisterForPushNotificationsAsync();    PushNotificationsService.Instance.OnNotificationReceived += notificationData =>    {        Debug.Log("Received a notification!");    };}catch (Exception e){    Debug.Log("Failed to retrieve a push notification token.");}

알림 수신 콜백

PushNotifications.OnNotificationReceived

Push Notifications 설정

• FirebaseWebApiKey: Android의 Firebase Cloud Messaging API에 사용되는 Firebase 프로젝트의 ‘Web API Key’입니다. 프로젝트에 표시되지 않으면 먼저 Firebase Authentication을 활성화해야 나타날 수도 있습니다.
• FirebaseProjectNumber: Android의 Firebase Cloud Messaging에 사용되는 ‘Project Number’입니다.
• FirebaseAppID: Android의 Firebase Cloud Messaging API에 사용되는 Firebase 애플리케이션의 ‘App ID’입니다.
• FirebaseProjectID: Android의 Firebase Cloud Messaging API에 사용되는 Firebase 프로젝트의 ‘Project ID’입니다.

1. 비활성화 상태인 Cloud Messaging API (Legacy) 옆의 점 세 개를 선택합니다.
2. ENABLE Cloud Messaging API (Legacy)를 선택합니다.
3. Firebase 콘솔을 새로 고칩니다.

Analytics

• notificationServices: 이 이벤트는 클라이언트에 새 토큰이 등록될 때마다 기록됩니다. 푸시 토큰을 예로 들 수 있으며, 이는 해당 토큰을 백엔드 서비스에 등록하고 Unity Dashboard에서 알림을 전송하는 데 사용됩니다. 본 제품이 제대로 작동하기 위해 필요합니다.
• notificationOpened: 이 이벤트는 사용자가 알림을 열 때마다 기록됩니다. 사용자가 포함되어 있는 캠페인과 집단, 알림에서 앱이 실행되었는지 여부에 관한 데이터가 여기에 포함됩니다.

Analytics 전용 모드

PushNotificationsService.Instance.Analytics

RecordPushTokenUpdated

PushNotificationsService.Instance.Analytics.RecordPushTokenUpdated(token);

RecordNotificationOpened

PushNotificationsService.Instance.Analytics.RecordNotificationOpened(notificationData);

SDK 연동 테스트

1. 앱에서 PushNotificationsService 토큰을 가져와 ‘Debug.Log’를 사용하여 로그에 기록합니다.
2. 타겟 플랫폼에 따라 Android용 디버그 가이드 또는 iOS용 빌드 및 실행 가이드를 참고하여 앱을 실행합니다.
3. 앱 로그를 읽고 로그 토큰을 가져옵니다.
   1. Android의 경우: Android Logcat 패키지를 사용합니다.
   2. iOS의 경우: 앱을 실행할 때 XCODE 내부의 로그를 확인합니다.
4. UGS 대시보드에서 기존 Push Notification Campaign으로 이동하거나 새 더미를 생성합니다.
5. ‘Content’ 단계에서 필요에 따라 알림을 생성하고 ‘Test on Device’로 이동합니다.

6. 타겟 디바이스를 선택하고 가져온 토큰을 입력합니다.

7. Send를 선택하고 디바이스에 알림이 수신되었는지 확인합니다.

EDM4U(External Dependency Manager for Unity) 지원

3.0.1-pre.1

Assets/Push Notifications/Editor/Android

Resolve

Force Resolve

Display Libraries

implementation 'com.google.firebase:firebase-messaging-ktx:22.0.0' // Assets/Push Notifications/Editor/Android/PushSDKDependencies.xml:9

Assets/Push Notifications/Editor/Android/PushSDKDependencies.xml:9

Assets/Push Notifications/Editor/Android

Force Resolve