SaaS 제품에 대한 Amazon SNS 알림

알림을 받으려면 제품을 생성할 때 제공된 AWS Marketplace Amazon Simple Notification Service(SNS) 주제를 구독해야 합니다. 이 주제는 고객의 제품 구독 및 계약 권한 변경 사항에 대한 알림을 제공합니다. 이를 통해 특정 고객에 대한 액세스가 제공 및 취소된 시기를 알 수 있습니다.

참고

판매자는 제품 생성 프로세스 중에 SNS 주제에 대한 실제 Amazon 리소스 이름(ARN)을 받게 됩니다. 예: arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE

서비스형 소프트웨어(SaaS) 제품에 제공되는 Amazon SNS 주제는 다음과 같습니다.

• Amazon SNS 주제: aws-mp-entitlement-notification - 이 주제는 구매자가 새 계약을 생성하거나, 기존 계약을 업그레이드 또는 갱신하거나, 계약이 만료될 때 알림을 제공합니다. 계약(SaaS 계약 및 소비가 포함된 SaaS 계약(초과분)이라고도 함)이 포함된 요금 모델을 사용하는 제품에만 제공됩니다.

• Amazon SNS 주제: aws-mp-subscription-notification - 이 주제는 구매자가 제품을 구독하거나 구독 해지할 때 알림을 제공하며, 비공개 제안의 offer-identifier 및 SaaS 무료 평가판의 무료 평가판 플래그를 포함하고 있습니다. 계약 및 구독(SaaS 구독, SaaS 계약 및 소비가 포함된 SaaS 계약(초과분)이라고도 함)을 포함한 모든 요금 모델에 제공됩니다.

이러한 알림에 응답하는 시나리오에 대한 자세한 내용은 다음 주제를 참조하세요.

• SaaS 구독 제품 통합

• SaaS 계약 제품 통합

• SaaS 계약을 사용한 만큼만 지불 제품과 통합

Amazon SNS 주제: aws-mp-entitlement-notification

aws-mp-entitlement-notification 주제의 각 메시지는 다음과 같은 형식입니다.

{
    "action": "<action-name>",
    "customer-identifier": " X01EXAMPLEX",
    "product-code": "n0123EXAMPLEXXXXXXXXXXXX",
}

<action-name>은 항상 entitlement-updated입니다.

참고

• 권한 메시지의 경우 작업(신규, 업그레이드, 갱신 또는 만료)에 관계없이 메시지는 동일합니다. 업데이트 내용을 검색하려면 후속 GetEntitlement 호출이 필요합니다.

• 소비가 포함된 SaaS 계약(초과분)의 경우 판매자에게 aws-mp-subscription-notification SNS 주제가 제공됩니다. 판매자가 초과 요금을 추가할 때 받게 되는 추가 알림입니다. 판매자는 entitlement-updated만 얻는 대신 신규 고객을 확보하면(모든 종류의 조치를 의미할 수 있음) 고객이 신규 고객이라는 것을 알리는 구독 메시지를 받게 됩니다.

• 미래 계약 (FDA) 의 경우 이 항목은 계약 서명일이 아닌 계약 시작일에 시작됩니다. 또한 계약의 취소, 교체, 갱신 또는 만료와 같이 자격에 대한 후속 변경이 발생할 때도 시작됩니다.

계약 가격 책정 (계약 포함 pay-as-you-go) 이 적용된 제품은 이러한 메시지에 응답해야 합니다. 응답 방법에 대한 자세한 내용은 시나리오: 사용자 구독 변경 사항 모니터링 섹션을 참조하세요.

Amazon SNS 주제: aws-mp-subscription-notification

aws-mp-subscription-notification 주제의 각 메시지는 다음과 같은 형식입니다.

{
    "action": "<action-name>",
    "customer-identifier": " X01EXAMPLEX",
    "product-code": "n0123EXAMPLEXXXXXXXXXXXX",
    "offer-identifier": "offer-abcexample123",
    "isFreeTrialTermPresent":"true"
}

제안이 비공개 제안인 경우 알림에 offer-identifier만 표시됩니다.

isFreeTrialTermPresent 속성 정보는 구매자의 구독이 무료 평가판인지 여부를 나타냅니다. 이 속성의 JSON 값은 부울 데이터 유형이 아닙니다. 그 대신 값이 문자열 데이터 유형으로 변환됩니다. 자세한 내용은 SaaS 무료 평가판을 참조하세요.

<action-name>은 알림에 따라 달라집니다. 가능한 작업은 다음과 같습니다.

• subscribe-success - 판매자가 측정 기록을 전송할 수 있게 되면 subscribe-success 메시지가 그 사실을 알려줍니다.

• subscribe-fail - subscribe-fail 메시지가 생성되면 구매자가 이미 AWS Marketplace에서 판매자의 SaaS 랜딩 페이지로 전환했어도 결제가 실패했을 수 있습니다. 판매자는 subscribe-success 메시지를 기다렸다가 제품 사용을 허용해야 합니다.

• unsubscribe-pending - 구매자가 구독을 해지하면 가장 먼저 unsubscribe-pending 메시지가 전송됩니다. 구독이 완전히 취소되기 전까지 제한된 시간(약 1시간) 동안 판매자가 최종 측정 기록을 받을 수 있음을 나타냅니다.

• unsubscribe-success - unsubscribe-success는 취소 완료를 알리는 메시지이며, 취소 완료 후에는 더 이상 측정 기록이 수락되지 않습니다.

참고

• 구매자가 구독을 해지한 후 최종 unsubscribe-success 메시지가 전송되기 전에 즉시 다시 구독하면 최종 unsubscribe-success 메시지가 전송되지 않고 subscribe-success 메시지가 대신 전송됩니다.

• 미래형 계약 (FDA) 의 경우 구독 성공 조치는 계약 서명일이 아닌 계약 시작일에 시작됩니다.

구독 가격이 적용되는 제품 (계약 포함 pay-as-you-go) 은 이러한 메시지에 응답해야 합니다. 응답 방법에 대한 자세한 내용은 다음 주제를 참조하세요.

• SaaS 구독 제품 통합

• SaaS 계약을 사용한 만큼만 지불 제품과 통합

SNS 주제에 대한 SQS 대기열 구독

Amazon SQS 대기열을 제공된 SNS 주제에 구독하는 것이 좋습니다. SQS 대기열을 생성하고 대기열을 주제에 구독하는 방법에 대한 자세한 지침은 Amazon Simple Notification Service 개발자 안내서의 Amazon SQS 대기열을 Amazon SNS 주제에 구독을 참조하세요.

참고

제품 판매에 사용한 AWS 계정에서 AWS Marketplace SNS 주제만 구독할 수 있습니다. 하지만 메시지를 다른 계정에 전달할 수 있습니다. 자세한 내용은 Amazon Simple Notification Service 개발자 안내서의 다른 계정의 Amazon SQS 대기열로 Amazon SNS 메시지 전송을 참조하세요.

알림을 위한 SQS 대기열 폴링

SQS 대기열을 SNS 주제에 구독하면 메시지가 SQS에 저장됩니다. 대기열을 지속적으로 폴링하는 서비스를 정의하고, 메시지를 찾고, 그에 따라 메시지를 처리해야 합니다.