ActionInteraction

PutActionInteractions API를 사용하여 전송된 작업 상호 작용 이벤트를 나타냅니다.

내용

actionId

사용자가 상호 작용한 작업의 ID. 이는 작업 상호 작용 스키마의 ACTION_ID 필드에 해당합니다.

유형: 문자열

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

필수 여부: 예

eventType

작업 상호 작용 이벤트의 유형. Viewed, Taken, Not Taken 이벤트 유형을 지정할 수 있습니다. 작업 상호 작용 이벤트 유형 데이터에 대한 자세한 내용은 이벤트 유형 데이터를 참조하세요.

유형: 문자열

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

필수 여부: 예

sessionId

해당 사용자의 방문과 연결된 ID. 애플리케이션은 사용자가 웹 사이트를 처음 방문하거나 애플리케이션을 사용할 때 고유한 sessionId을 생성합니다.

유형: 문자열

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

필수 여부: 예

timestamp

작업 상호 작용 이벤트가 발생한 시점의 타임스탬프. 타임스탬프는 Unix epoch 시간 형식(초)이어야 합니다.

유형: 타임스탬프

필수 여부: 예

eventId

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

유형: 문자열

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

필수 여부: 아니요

impression

사용자에게 보여준 작업의 순서를 나타내는 작업 ID 목록. 예를 들어 ["actionId1", "actionId2", "actionId3"]입니다. Amazon Personalize는 작업 상호 작용 이벤트의 노출 데이터를 사용하지 않습니다. 대신 각 작업에 대해 여러 이벤트를 기록하고 Viewed 이벤트 유형을 사용합니다.

유형: 문자열 어레이

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

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

필수 여부: 아니요

properties

기록하도록 선택할 수 있는 이벤트별 데이터의 문자열 맵. 예를 들어, 사용자가 작업 ID 이외의 작업을 수행하는 경우 사용자가 수행한 작업 수를 전송할 수도 있습니다.

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

{"numberOfActions": "12"}

키는 작업 상호 작용 스키마의 필드와 일치하는 낙타 대문자 이름을 사용합니다. 위 예제에서 numberOfActions는 작업 상호 작용 스키마에 정의된 'NUMBER_OF_ACTIONS' 필드와 일치합니다.

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

• userId

• sessionid

• eventType

• 타임스탬프

• recommendationId

• impression

유형: 문자열

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

필수 여부: 아니요

recommendationId

사용자가 상호 작용한 작업이 포함된 추천 목록의 ID.

유형: 문자열

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

필수 여부: 아니요

userId

작업과 상호 작용한 사용자의 ID. 이는 작업 상호 작용 스키마의 USER_ID 필드에 해당합니다.

유형: 문자열

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

필수 여부: 아니요

참고

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

• AWS SDK for C++

• AWS Java V2용 SDK

• AWS 루비 V3용 SDK