Requisitos del esquema del conjunto de datos de interacciones de elementos (personalizado)

Un conjunto de datos de interacciones de elementos almacena datos históricos y en tiempo real de las interacciones entre los usuarios y los elementos de su catálogo. Para obtener información sobre los tipos de datos de interacciones que Amazon Personalize puede utilizar, consulte Conjunto de datos de interacciones de elementos.

Los datos que proporcione para cada interacción deben coincidir con su esquema. Según su esquema, los metadatos de interacción pueden incluir valores nulos o vacíos. Como mínimo, debe proporcionar lo siguiente para cada interacción:

• ID de usuario

• ID de elemento

• Marca temporal (en formato de tiempo Unix)

Tiene la libertad de añadir campos adicionales según su caso de uso y sus datos. Siempre que los campos no figuren como obligatorios o reservados, y los tipos de datos figuren en Tipos de datos de esquema, puede elegir los nombres de los campos y los tipos de datos.

El número máximo total de campos de metadatos opcionales que puede agregar a un conjunto de datos de interacciones de elementos, combinado con el número total de tipos de eventos distintos en sus datos de interacciones de elementos, es de 10. Los campos de metadatos incluidos en este recuento son los VALUE campos EVENT EVENT _TYPE, _ junto con cualquier campo de metadatos personalizados que añadas al esquema. El número máximo de campos de metadatos, excluidos los campos reservados, por ejemploIMPRESSION, es 5. Los valores categóricos pueden tener 1000 caracteres como máximo. Si tiene una interacción con un valor categórico con más de 1000 caracteres, se generará un error en su trabajo de importación del conjunto de datos.

Para obtener más información sobre los requisitos mínimos y los límites máximos de datos para un conjunto de datos de interacciones de elementos, consulte Service Quotas.

Ejemplo de esquema de interacciones (personalizado)

En el siguiente ejemplo, se muestra un esquema para un conjunto de datos de interacciones de elementos. Los campos USER_ID, ITEM_ID y TIMESTAMP son obligatorios. Los campos EVENT_TYPE, EVENT_VALUE y IMPRESSION son palabras clave reservadas reconocidas por Amazon Personalize. EVENT_ TYPE debe ser de tipo cadena y no puede ser categórico. LOCATIONy DEVICE son campos de metadatos contextuales opcionales. Para obtener información sobre los requisitos de esquema, consulte Requisitos de esquemas y conjuntos de datos personalizados.

{

  "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"
}

Para este esquema, las primeras líneas de datos históricos de un CSV archivo pueden tener el siguiente aspecto. Tenga en cuenta que algunos valores de EVENT _ VALUE son nulos.

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
...
...