앱에 대상 푸시 알림 구성

아티클
03/01/2024

파트너 센터의 푸시 알림 페이지에서 UWP(유니버설 Windows 플랫폼) 앱이 설치된 디바이스에 대상 푸시 알림을 보내 고객 참여를 직접 유도할 수 있습니다. 예를 들어 대상 푸시 알림을 사용하여 고객이 앱을 평가하거나 새 기능을 시도하는 등의 작업을 수행하도록 장려할 수 있습니다. 알림 메시지, 타일 알림 및 원시 XML 알림을 포함하여 여러 가지 유형의 푸시 알림을 보낼 수 있습니다. 푸시 알림으로 인한 앱 시작 속도를 추적할 수도 있습니다. 이 기능에 대한 자세한 내용은 앱 고객에게 푸시 알림 보내기를 참조하세요 .

파트너 센터에서 고객에게 대상 푸시 알림을 보내려면 먼저 Microsoft Store Services SDK에서 StoreServicesEngagementManager 클래스의 메서드를 사용하여 알림을 받도록 앱을 등록해야 합니다. 이 클래스에서 별도의 메서드를 사용하여 대상 푸시 알림에 대한 응답으로 앱이 시작되었음을 파트너 센터에 알리고(알림으로 발생한 앱 실행 속도를 추적하려는 경우) 알림 수신을 중지할 수 있습니다.

프로젝트 구성

코드를 작성하기 전에 다음 단계에 따라 프로젝트에서 Microsoft Store Services SDK에 대한 참조를 추가합니다.

아직 설치하지 않은 경우 개발 컴퓨터에 Microsoft Store Services SDK를 설치합니다.
Visual Studio에서 새 프로젝트를 엽니다.
솔루션 탐색기에서 프로젝트 참조 노드를 마우스 우클릭하고 참조 추가를 클릭합니다.
참조 관리자에서 유니버설 Windows를 확장하고 확장을 클릭합니다.
SDK 목록에서 Microsoft Engagement Framework 옆에 있는 검사 상자를 클릭하고 확인을 클릭합니다.

푸시 알림 등록

앱에서 파트너 센터의 대상 푸시 알림을 수신하도록 등록하려면

프로젝트에서, 시작 시 실행되는 코드에서 알림을 받도록 앱을 등록할 수 있는 섹션을 찾습니다.
다음 문을 코드 파일의 맨 위에 추가합니다.
```
using Microsoft.Services.Store.Engagement;
```
StoreServicesEngagementManager 개체를 가져오고 앞에서 식별한 시작 코드에서 RegisterNotificationChannelAsync 오버로드 중 하나를 호출합니다. 이 메서드는 앱이 시작될 때마다 호출되어야 합니다.

파트너 센터에서 알림에 대한 고유한 채널 URI를 만들게 하려면 RegisterNotificationChannelAsync() 오버로드를 호출합니다.
```
StoreServicesEngagementManager engagementManager = StoreServicesEngagementManager.GetDefault();
await engagementManager.RegisterNotificationChannelAsync();
```
중요

앱에서 CreatePushNotificationChannelForApplicationAsync를 호출하여 WNS에 대한 알림 채널도 만드는 경우 코드에서 CreatePushNotificationChannelForApplicationAsync 및 RegisterNotificationChannelAsync() 오버로드를 동시에 호출하지 않도록 합니다. 이러한 두 메서드를 모두 호출해야 하는 경우 순차적으로 호출하고 다른 메서드를 호출하기 전에 한 메서드의 반환을 기다리고 있는지 확인합니다.
파트너 센터의 대상 푸시 알림에 사용할 채널 URI를 지정하려면 RegisterNotificationChannelAsync(StoreServicesNotificationChannelParameters) 오버로드를 호출합니다. 예를 들어 앱에서 이미 WNS(Windows 푸시 알림 서비스)를 사용하고 동일한 채널 URI를 사용하려는 경우 이 작업을 수행할 수 있습니다. 먼저 StoreServicesNotificationChannelParameters 개체를 만들고 CustomNotificationChannelUri 속성을 채널 URI에 할당해야 합니다.
```
StoreServicesNotificationChannelParameters parameters =
    new StoreServicesNotificationChannelParameters();
parameters.CustomNotificationChannelUri = "Assign your channel URI here";

StoreServicesEngagementManager engagementManager = StoreServicesEngagementManager.GetDefault();
await engagementManager.RegisterNotificationChannelAsync(parameters);
```

참고 항목

RegisterNotificationChannelAsync 메서드를 호출하면 앱의 로컬 앱 데이터 저장소(ApplicationData.LocalFolder 속성이 반환하는 폴더)에 MicrosoftStoreEngagementSDKId.txt라는 파일이 생성됩니다. 이 파일에는 대상 푸시 알림 인프라에서 사용하는 ID가 포함되어 있습니다. 앱에서 이 파일을 수정하거나 삭제하지 않도록 합니다. 그러지 않으면 사용자가 여러 개의 알림을 받거나, 알림이 다른 면에서 제대로 동작하지 않을 수 있습니다.

대상 푸시 알림이 고객에게 라우팅되는 방법

앱에서 RegisterNotificationChannelAsync를 호출하면 이 메서드가 현재 디바이스에 로그인되어 있는 고객의 Microsoft 계정을 수집합니다. 나중에 이 고객이 포함된 세그먼트로 대상 푸시 알림을 보내면 파트너 센터에서 이 고객의 Microsoft 계정과 연결된 디바이스로 알림을 보냅니다.

앱을 시작한 고객이 Microsoft 계정으로 여전히 디바이스에 로그인된 상태에서 다른 사람에게 디바이스를 사용하라고 줄 경우 다른 사람이 원래 고객을 대상으로 하는 알림을 볼 수 있다는 점에 유의하세요. 이로 인해 의도치 않은 결과가 초래될 수 있으며, 고객이 로그인 후 사용하는 서비스를 제공하는 앱의 경우 특히 유의해야 합니다. 이 시나리오에서 다른 사용자가 대상 알림을 보지 못하도록 방지하려면 고객이 앱에서 로그아웃할 때 UnregisterNotificationChannelAsync 메서드를 호출합니다. 자세한 내용은 이 문서의 뒷부분에 나오는 푸시 알림 등록 취소를 참조하세요.

사용자가 앱을 시작할 때 앱의 응답 방식

앱에서 알림을 수신하도록 등록한 뒤, 파트너 센터에서 앱 고객에게 푸시 알림을 전송하고 나면 사용자가 푸시 알림에 대한 응답으로 앱을 시작할 때 앱에서 다음 진입점 중 하나가 호출됩니다. 사용자가 앱을 실행할 때 실행하려는 코드가 있는 경우 앱에서 이러한 진입점 중 하나에 코드를 추가할 수 있습니다.

푸시 알림에 포그라운드 활성화 유형이 있는 경우 프로젝트에서 App 클래스의 OnActivated 메서드를 재정의하고 이 메서드에 코드를 추가합니다.
푸시 알림에 백그라운드 활성화 유형이 있는 경우 백그라운드 작업의 Run 메서드에 코드를 추가합니다.

예를 들어 앱에서 유료 추가 기능을 구매한 앱 사용자에게 무료 추가 기능을 부여하여 보상할 수 있습니다. 이 경우 이러한 사용자를 대상으로 하는 고객 세그먼트에 푸시 알림을 보낼 수 있습니다. 그런 다음 위에 나열된 진입점 중 하나에서 무료 앱 내 구매를 부여하는 코드를 추가할 수 있습니다.

앱 시작 파트너 센터 알림

파트너 센터의 대상 푸시 알림에 대해 앱 시작 속도 추적 옵션을 선택한 경우 앱의 적절한 진입점에서 ParseArgumentsAndTrackAppLaunch 메서드를 호출하여 푸시 알림에 대한 응답으로 앱이 시작되었음을 파트너 센터에 알립니다.

이 메서드는 앱의 원래 시작 인수도 반환합니다. 푸시 알림에 대해 앱 시작 속도를 추적하도록 선택하고 나면 불특정 추적 ID가 시작 인수에 추가되어 파트너 센터에서 앱 시작 추적이 지원됩니다. 앱에 대한 실행 인수는 ParseArgumentsAndTrackAppLaunch 메서드에 전달해야 합니다. 그러면 이 메서드는 파트너 센터에 추적 ID를 보내고, 시작 인수에서 추적 ID를 제거하고, 코드에 원래 실행 인수를 반환합니다.

이 메서드를 호출하는 방법은 푸시 알림의 활성화 유형에 따라 다릅니다.

푸시 알림에 포그라운드 활성화 유형이 있는 경우 앱의 OnActivated 메서드 재정의에서 이 메서드를 호출하고 이 메서드에 전달되는 ToastNotificationActivatedEventArgs 개체에서 사용할 수 있는 인수를 전달합니다. 다음 코드 예제에서는 코드 파일에 Microsoft.Services.Store.Engagement 및 Windows.ApplicationModel.Activation 네임스페이스에 대한 using 문이 있다고 가정합니다.

protected override void OnActivated(IActivatedEventArgs args)
{
    base.OnActivated(args);

    if (args is ToastNotificationActivatedEventArgs)
    {
        var toastActivationArgs = args as ToastNotificationActivatedEventArgs;

        StoreServicesEngagementManager engagementManager = StoreServicesEngagementManager.GetDefault();
        string originalArgs = engagementManager.ParseArgumentsAndTrackAppLaunch(
            toastActivationArgs.Argument);

        // Use the originalArgs variable to access the original arguments
        // that were passed to the app.
    }
}

푸시 알림에 백그라운드 활성화 유형이 있는 경우 백그라운드 작업에 대한 Run 메서드에서 이 메서드를 호출하고 이 메서드에 전달되는 ToastNotificationActionTriggerDetail 개체에서 사용할 수 있는 인수를 전달합니다. 다음 코드 예제의 코드 파일에 Microsoft.Services.Store.Engagement, Windows.ApplicationModel.Background 및 Windows.UI.Notifications 네임스페이스에 대한 using 문이 있다고 가정합니다.

public void Run(IBackgroundTaskInstance taskInstance)
{
    var details = taskInstance.TriggerDetails as ToastNotificationActionTriggerDetail;

    if (details != null)
    {
        StoreServicesEngagementManager engagementManager = StoreServicesEngagementManager.GetDefault();
        string originalArgs = engagementManager.ParseArgumentsAndTrackAppLaunch(details.Argument);

        // Use the originalArgs variable to access the original arguments
        // that were passed to the app.
    }
}

푸시 알림 등록 취소

앱에서 파트너 센터의 대상 푸시 알림 수신을 중지하려면 UnregisterNotificationChannelAsync 메서드를 호출합니다.

StoreServicesEngagementManager engagementManager = StoreServicesEngagementManager.GetDefault();
await engagementManager.UnregisterNotificationChannelAsync();

이 메서드는 앱이 모든 서비스에서 더 이상 푸시 알림을 받지 않도록 알림에 사용되는 채널을 무효화합니다. 알림이 종료되면 파트너 센터의 대상 푸시 알림 및 WNS를 사용하는 다른 알림을 포함한 어떤 서비스에도 채널을 다시 사용할 수 없습니다. 이 앱에 푸시 알림 보내기를 다시 시작하려면 앱에서 새 채널을 요청해야 합니다.

앱에 대상 푸시 알림 구성

프로젝트 구성

푸시 알림 등록

대상 푸시 알림이 고객에게 라우팅되는 방법

사용자가 앱을 시작할 때 앱의 응답 방식

앱 시작 파트너 센터 알림

푸시 알림 등록 취소

피드백

피드백

추가 리소스

앱에 대상 푸시 알림 구성

프로젝트 구성

푸시 알림 등록

대상 푸시 알림이 고객에게 라우팅되는 방법

사용자가 앱을 시작할 때 앱의 응답 방식

앱 시작 파트너 센터 알림

푸시 알림 등록 취소

관련 항목

피드백

피드백

추가 리소스