항목 상호 작용 데이터 세트 스키마 요구 사항(사용자 지정)

항목 상호 작용 데이터 세트는 사용자와 항목 간 상호 작용의 이력 및 실시간 데이터를 카탈로그에 저장합니다. Personalize에서 사용할 수 있는 상호작용 데이터 유형에 대한 자세한 내용은 항목 상호 작용 데이터단원을 참조하세요.

각 상호작용에 제공하는 데이터는 스키마와 일치해야 합니다. 스키마에 따라 상호작용 메타데이터에는 비어 있음/null 값이 포함될 수 있습니다. 최소한 각 상호작용에 대해 다음을 제공해야 합니다.

사용 사례와 데이터에 따라 추가 필드를 마음대로 추가할 수 있습니다. 필드가 필수 또는 예약으로 나열되어 있지 않고 데이터 유형이 스키마 데이터 유형에 나열된 경우, 필드 이름과 데이터 사용자가 선택할 수 있습니다.

항목 상호 작용 데이터 세트에 추가할 수 있는 선택형 메타데이터 필드의 최대 개수는 항목 상호 작용 데이터에 있는 개별 이벤트 유형의 총 개수와 합산하여 10개입니다. 이 수치에 포함되는 메타데이터 필드는 스키마에 추가한 사용자 지정 메타데이터 필드와 함께 EVENT_TYPE, EVENT_VALUE 필드입니다. 예약된 필드(예: IMPRESSION 를 제외한 메타데이터 필드의 최대 수는 5개입니다. 범주형 값은 최대 1000자까지 포함할 수 있습니다. 범주형 값이 1000자를 초과하는 상호작용이 있는 경우, 데이터세트 가져오기 작업이 실패합니다.

항목 상호 작용 데이터 세트에 대한 자세한 최소 요구 사항 및 최대 데이터 한도 정보는 Service quotas 섹션을 참조하세요.

상호작용 스키마 예제(사용자 지정)

다음 예제는 항목 상호 작용 데이터 세트의 스키마를 보여줍니다. USER_ID, ITEM_ID및 TIMESTAMP필드는 필수입니다. EVENT_TYPE, EVENT_VALUE및 IMPRESSION필드는 Personalize에서 인식한 선택 가능한 예약어입니다. EVENT_TYPE은 문자열이어야 하며 범주형일 수 없습니다. LOCATION및 DEVICE는 선택 가능한 컨텍스트 메타데이터 필드입니다. 스키마 요구 사항에 대한 자세한 내용은 사용자 지정 데이터세트 및 스키마 요구 사항단원을 참조하세요.

{

  "type": "record",
  "name": "Interactions",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
      {
          "name": "USER_ID",
          "type": "string"
      },
      {
          "name": "ITEM_ID",
          "type": "string"
      },
      {
          "name": "EVENT_TYPE",
          "type": "string"
      },
      {
          "name": "EVENT_VALUE",
          "type": [
             "float",
             "null"
          ]
      },
      {
          "name": "LOCATION",
          "type": "string",
          "categorical": true
      },
      {
          "name": "DEVICE",
          "type": [
              "string",
              "null"
          ],
          "categorical": true
      },
      {
          "name": "TIMESTAMP",
          "type": "long"
      },
      {
          "name": "IMPRESSION",
          "type": "string"
      }
  ],
  "version": "1.0"
}

이 스키마의 경우, CSV 파일의 이력 데이터의 처음 몇 줄은 다음과 같을 수 있습니다. 참고로 EVENT_VALUE의 일부 값은 null입니다.

USER_ID,ITEM_ID,EVENT_TYPE,EVENT_VALUE,LOCATION,DEVICE,TIMESTAMP,IMPRESSION
35,73,click,,Ohio,Tablet,1586731606,73|70|17|95|96|92|55|45|16|97|56|54|33|94|36|10|5|43|19|13|51|90|65|59|38
54,35,watch,0.75,Indiana,Cellphone,1586735164,35|82|78|57|20|63|1|90|76|75|49|71|26|24|25|6|37|85|40|98|32|13|11|54|48
9,33,click,,Oregon,Cellphone,1586735158,68|33|62|6|15|57|45|24|78|89|90|40|26|91|66|31|47|17|99|29|27|41|77|75|14
23,10,watch,0.25,California,Tablet,1586735697,92|89|36|10|39|77|4|27|79|18|83|16|28|68|78|40|50|3|99|7|87|49|12|57|53
27,11,watch,0.55,Indiana,Tablet,1586735763,11|7|39|95|71|1|6|40|41|28|99|53|68|76|0|65|69|36|22|42|34|67|24|20|66
...
...