Requisitos do esquema de conjunto de dados de ações (personalizado)

Ação é uma atividade de engajamento que convém recomendar aos clientes. As ações podem incluir instalar o aplicativo móvel, preencher um perfil de membro, participar do programa de fidelidade ou inscrever-se para receber e-mails promocionais. Um conjunto de dados de ações armazena dados sobre as ações. Para obter informações sobre os tipos de dados de ações a serem importados para o Amazon Personalize, consulte Conjunto de dados de ações.

Os dados fornecidos para cada ação devem corresponder ao esquema de conjunto de dados de ações. Dependendo do esquema, os metadados da ação podem incluir valores vazios empty/null nulos.

No mínimo, você deve fornecer um ID de ação para cada item (comprimento máximo de 256 caracteres). Seu esquema deve ter no mínimo um campo de metadados, mas se você adicionar um null tipo, esse valor pode ser nulo para a ação. É possível adicionar outros campos, dependendo do caso de uso e dos dados. É possível selecionar os nomes dos campos e os tipos de dados, a menos que os campos estejam indicados como obrigatórios ou reservados e os tipos de dados estejam listados em Tipos de dados do esquema.

Para adicionar um campo categórico, adicione um campo do tipo string e defina o atributo categórico do campo em seu esquema. true Depois, inclua os dados categóricos no arquivo CSV em massa e nas importações de ações individuais. Os valores categóricos podem ter no máximo 1.000 caracteres. Se houver uma ação com um valor categórico com mais de mil caracteres, ocorrerá uma falha no trabalho de importação do conjunto de dados.

Para obter mais informações sobre requisitos mínimos e limites máximos de dados para um conjunto de dados de ações, consulte Cotas de serviço.

Exemplo de esquema de conjunto de dados de ações (personalizado)

O exemplo a seguir mostra como estruturar um esquema de ações. O campo ACTION_ID é obrigatório. MEMBERSHIP_LEVEL é um campo de string categórico. Os campos VALUE, CREATION_TIMESTAMP e REPEAT_FREQUENCY são palavras-chave reservadas com os tipos necessários. É possível adicionar, no máximo, dez colunas. Para obter informações sobre requisitos do esquema, consulte Requisitos de conjuntos de dados personalizados e esquemas.

{
  "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, as primeiras linhas de dados históricos em um arquivo CSV podem ser da seguinte forma.

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