GetPersonalizedRanking - Personalize
Request SyntaxURI 요청 파라미터요청 본문응답 구문응답 요소Errors참고

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

GetPersonalizedRanking

해당 사용자에 대한 추천 항목 목록의 순위를 다시 매깁니다. 이 목록의 첫 번째 항목은 사용자가 관심을 보일 가능성이 가장 높은 항목으로 간주됩니다.

참고

캠페인을 지원하는 솔루션은 PERSONALIZED_RANKING 유형 레시피를 사용하여 생성한 것이어야 합니다.

Request Syntax

POST /personalize-ranking HTTP/1.1
Content-type: application/json

{
   "campaignArn": "string",
   "context": { 
      "string" : "string" 
   },
   "filterArn": "string",
   "filterValues": { 
      "string" : "string" 
   },
   "inputList": [ "string" ],
   "metadataColumns": { 
      "string" : [ "string" ]
   },
   "userId": "string"
}

URI 요청 파라미터

요청은 URI 파라미터를 사용하지 않습니다.

요청 본문

요청은 JSON 형식으로 다음 데이터를 받습니다.

campaignArn

순위를 생성하기 위해 사용할 캠페인의 Amazon 리소스 이름(ARN)입니다.

타입: 문자열

길이 제약: 최대 길이 256.

패턴: arn:([a-z\d-]+):personalize:.*:.*:.+

필수 사항 여부: Yes

context

추천을 받을 때 사용할 컨텍스트 메타데이터. 컨텍스트 메타데이터에는 사용자의 현재 위치 또는 기기 유형과 같이 사용자의 추천을 받을 때 관련이 있을 수 있는 모든 상호작용 정보가 포함됩니다.

유형: 문자열-문자열 맵

맵 항목: 최대 항목 수 150개.

키 길이 제약: 최대 길이 150.

키 패턴: [A-Za-z\d_]+

값 길이 제약: 최대 길이 1000.

필수 여부: 아니요

filterArn

특정 사용자에 대한 추천에 항목을 포함시키거나 항목을 제외시키기 위해 만든 필터의 Amazon 리소스 이름(ARN)입니다. 자세한 내용은 추천 필터링 단원을 참조하세요.

타입: 문자열

길이 제약: 최대 길이 256.

패턴: arn:([a-z\d-]+):personalize:.*:.*:.+

Required: No

filterValues

추천을 필터링할 때 사용할 값. 필터 표현식의 각 자리 표시자 파라미터에 대해 파라미터 이름(대/소문자 구분)을 키로 그리고 필터 값을 해당 값으로 각각 제공합니다. 한 파라미터의 여러 값을 쉼표로 구분합니다.

INCLUDE 요소를 사용하여 항목을 포함시키는 필터 표현식의 경우 표현식에 정의되어 있는 모든 파라미터의 값을 제공해야 합니다. EXCLUDE 요소를 사용하여 항목을 제외시키는 표현식이 있는 필터의 경우 filter-values를 생략할 수 있습니다. 이 경우 Personalize는 표현식의 해당 부분을 사용하여 추천을 필터링하지 않습니다.

자세한 내용은 추천 필터링 단원을 참조하세요.

유형: 문자열-문자열 맵

맵 항목: 최대 항목 수 25개.

키 길이 제약: 최대 길이 50.

키 패턴: [A-Za-z0-9_]+

값 길이 제약: 최대 길이 1000.

필수 여부: 아니요

inputList

순위를 매길 항목이 목록(itemId 기준). 항목이 학습 데이터세트에 포함되지 않은 경우 해당 항목은 순위가 재조정된 목록 끝에 추가됩니다. 추천에 메타데이터를 포함하는 경우 최대값은 50입니다. 포함하지 않는 경우 최대값은 500입니다.

유형: 문자열 어레이

길이 제약: 최대 길이 256.

필수 여부: 예

metadataColumns

캠페인을 만들거나 업데이트할 때 추천에서 메타데이터를 활성화한 경우 개인 맞춤 순위에 포함할 항목 데이터 세트의 메타데이터 열을 지정하세요. 맵 키는 ITEMS이고, 값은 항목 데이터 세트의 열 이름 목록입니다. 제공할 수 있는 최대 열 수는 10개입니다.

캠페인용 메타데이터 활성화에 대한 자세한 내용은 캠페인용 추천의 메타데이터 활성화를 참조하세요.

유형: 문자열-문자열 어레이 맵

맵 항목: 최대 항목 수 1개입니다.

키 길이 제약: 최대 길이 256.

배열 멤버: 최대 항목 수는 99개입니다.

길이 제약: 최대 길이 150.

필수 여부: 아니요

userId

캠페인에서 순위를 제공하려는 대상 사용자.

타입: 문자열

길이 제약: 최대 길이 256.

필수 여부: 예

응답 구문

HTTP/1.1 200
Content-type: application/json

{
   "personalizedRanking": [ 
      { 
         "itemId": "string",
         "metadata": { 
            "string" : "string" 
         },
         "promotionName": "string",
         "reason": [ "string" ],
         "score": number
      }
   ],
   "recommendationId": "string"
}

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

personalizedRanking

사용자가 가장 관심을 가질 만한 순서의 항목 목록입니다. 최대값은 500입니다.

유형: PredictedItem객체 어레이

recommendationId

추천의 ID.

타입: 문자열

Errors

InvalidInputException

필드 또는 파라미터에 유효한 값을 제공합니다.

HTTP 상태 코드: 400

ResourceNotFoundException

지정한 리소스가 존재하지 않습니다.

HTTP 상태 코드: 404

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.