Event - Personalize
내용참고

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

Event

PutEvents API를 사용하여 전송된 항목 상호 작용 이벤트 정보를 나타냅니다.

내용

eventType

이벤트의 유형(예: 클릭 또는 다운로드). 이 속성은 항목 상호 작용 데이터 세트 스키마의 EVENT_TYPE 필드에 해당하며 추적 중인 이벤트 유형에 따라 달라집니다.

유형: 문자열

길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256.

필수 여부: 예

sentAt

이벤트가 발생한 시점의 클라이언트측 타임스탬프(Unix 시간).

유형: 타임스탬프

필수 여부: 예

eventId

이벤트와 연결된 ID. 이벤트 ID가 제공되지 않은 경우 Personalize는 이벤트에 대한 고유한 ID를 생성합니다. 이벤트 ID는 모델 입력으로 사용되지 않습니다. Amazon Personalize는 이벤트 ID를 사용하여 고유한 이벤트를 구분합니다. 동일한 이벤트 ID를 가진 첫 번째 이벤트 이후의 모든 후속 이벤트는 모델 학습에 사용되지 않습니다.

유형: 문자열

길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256.

필수 여부: 아니요

eventValue

항목 상호 작용 스키마의 EVENT_VALUE 필드에 해당하는 이벤트 값.

유형: Float

필수 여부: 아니요

impression

사용자에게 보여준 항목의 순서를 나타내는 항목 ID 목록. 예를 들어 ["itemId1", "itemId2", "itemId3"]입니다. 이벤트의 노출 데이터를 수동으로 기록할 항목의 목록을 제공합니다. 노출 데이터 기록에 대한 자세한 내용은 노출 데이터 기록 단원을 참조하세요.

유형: 문자열 어레이

어레이 멤버: 최소 항목 수 1개. 최대 항목 수 25개.

길이 제약: 최소 길이 1. 최대 길이는 256.

필수 여부: 아니요

itemId

항목 상호 작용 데이터 세트 스키마의 ITEM_ID 필드에 해당하는 항목 ID 키.

유형: 문자열

길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256.

필수 여부: 아니요

metricAttribution

이벤트와 관련된 지표 어트리뷰션에 대한 정보가 들어 있습니다. 지표 어트리뷰션에 대한 자세한 내용은 추천 영향 측정 단원을 참조하세요.

유형: MetricAttribution객체

필수 여부: 아니요

properties

기록하도록 선택할 수 있는 이벤트별 데이터의 문자열 맵. 예를 들어 사용자가 사이트에 있는 영화 ID(itemId) 및 등급(eventValue) 이외의 영화에 등급을 매기는 경우 사용자가 만든 영화 등급 수를 보낼 수도 있습니다.

맵의 각 항목은 키-값 쌍으로 이루어져 있습니다. 예:

{"numberOfRatings": "12"}

키는 항목 상호 작용 데이터 세트 스키마의 필드와 일치하는 낙타 대문자 이름을 사용합니다. 위 예제에서 numberOfRatings는 항목 상호 작용 데이터 세트 스키마에 정의된 'NUMBER_OF_RATINGS' 필드와 일치합니다.

다음은 속성의 키워드로 포함할 수 없습니다(대소문자 구분 없음).

  • userId

  • sessionid

  • eventType

  • 타임스탬프

  • recommendationId

  • impression

유형: 문자열

길이 제약: 최소 길이 1. 최대 길이 1024.

필수 여부: 아니요

recommendationId

사용자가 상호작용한 항목이 포함된 추천 목록의 ID. Personalize가 사용자에게 보여주는 추천을 노출 데이터로 암시적으로 기록하도록 하려면 recommendationId을 제공합니다. 또는 지표 어트리뷰션을 사용하여 추천의 영향을 측정하는 경우 recommendationId을 제공합니다.

노출 데이터 기록에 대한 자세한 내용은 노출 데이터 기록 단원을 참조하세요. 지표 어트리뷰션 생성에 대한 자세한 내용은 추천 영향 측정 단원을 참조하세요.

유형: 문자열

길이 제약: 최소 길이 1자. 최대 길이 40자.

필수 여부: 아니요

참고

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