Requisitos del esquema del conjunto de datos de acciones (personalizado)

Una acción es una actividad de interacción que puede que quiera recomendar a sus clientes. Entre las acciones puede incluirse instalar su aplicación móvil, completar un perfil de pertenencia a grupo, unirse a un programa de fidelización o registrarse para recibir correos electrónicos promocionales. Un conjunto de datos de acciones almacena datos sobre las acciones. Para obtener información sobre los tipos de datos de acciones que puede importar en Amazon Personalize, consulte Conjunto de datos de acciones.

Los datos que proporcione para cada acción deben coincidir con el esquema del conjunto de datos de acciones. Según el esquema, los metadatos de acciones pueden incluir valores nulos o vacíos.

Como mínimo, debe proporcionar un identificador de acción para cada elemento (longitud máxima 256 caracteres). El esquema debe tener un campo de metadatos como mínimo, pero si agrega un null tipo, este valor puede ser nulo para la acción. Puede agregar campos adicionales en función de su caso de uso y sus datos. A menos que los campos figuren como obligatorios o reservados y los tipos de datos se enumeren en Tipos de datos de esquema, puede elegir los nombres de los campos y los tipos de datos.

Para agregar un campo categórico, agrega un campo de tipo string y establece el atributo categórico del campo true en tu esquema. A continuación, incluya los datos categóricos en su archivo CSV masivo y en las importaciones de acciones individuales. Los valores categóricos pueden tener 1000 caracteres como máximo. Si tiene una acción con un valor categórico con más de 1000 caracteres, se generará un error en el 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 acciones, consulte Service Quotas.

Ejemplo de esquema de conjunto de datos de acciones (personalizado)

En el siguiente ejemplo se muestra cómo estructurar un esquema de acciones. El campo ACTION_ID es obligatorio. MEMBERSHIP_LEVEL es un campo de cadena categórico. Los campos VALUE, CREATION_TIMESTAMP y REPEAT_FREQUENCY son palabras clave reservadas con los tipos necesarios. Puede agregar un máximo de 10 columnas. Para obtener información sobre los requisitos de esquema, consulte Requisitos de esquemas y conjuntos de datos personalizados.

{
  "type": "record",
  "name": "Actions",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
    {
      "name": "ACTION_ID",
      "type": "string"
    },
    {
      "name": "VALUE",
      "type": [
        "null",
        "long"
      ]
    },
    
    {
      "name": "MEMBERSHIP_LEVEL",
      "type": [
        "null",
        "string"
      ],
      "categorical": true
    },
    
    {
      "name": "CREATION_TIMESTAMP",
      "type": "long"
    },
    {
      "name": "REPEAT_FREQUENCY",
      "type": [
        "long",
        "null"
      ]
    }
  ],
  "version": "1.0"
}

Para este esquema, las primeras líneas de datos históricos de un archivo CSV pueden tener el siguiente aspecto.

ACTION_ID,VALUE,MEMBERSHIP_LEVEL,CREATION_TIMESTAMP,REPEAT_FREQUENCY
1,10,Deluxe|Premium,1510003267,7
2,5,Basic,1580003267,7
3,5,Preview,1590003267,3
4,10,Deluxe|Platinum,1560003267,4
...
...