As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Preparar metadados de ações para o treinamento

Ação é uma atividade que gera engajamento ou receita que convém recomendar aos usuários. 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. Você deve importar dados sobre ações para um conjunto de dados de ações. Os exemplos dos dados de uma ação incluem o ID exclusivo da ação, o valor estimado da ação ou o carimbo de data e hora de expiração da ação.

Se você usar a Next-Best-Action, deverá importar os metadados de ações. Com essa fórmula, o Amazon Personalize prevê a próxima melhor ação com base nas ações importadas para seu conjunto de dados de ações. Nenhuma outra fórmula ou caso de uso utiliza metadados de ações. Você não pode criar um conjunto de dados de ações em um grupo de conjuntos de dados de domínio.

Durante o treinamento, o Amazon Personalize não usa dados de ação de string não categóricos, como títulos ou tags de ação. No entanto, importar esses dados ainda pode melhorar as recomendações. Para obter mais informações, consulte Dados de string não categóricos.

Seus dados de ação em massa devem estar em um CSV arquivo. Cada linha do arquivo deve representar um único usuário. Depois de concluir a preparação dos dados, você estará pronto para criar um JSON arquivo de esquema. Esse arquivo informa a estrutura dos seus dados ao Amazon Personalize. Para obter mais informações, consulte Criar arquivos JSON de esquema para esquemas do Amazon Personalize.

As seções a seguir fornecem mais informações sobre como preparar seus metadados de ações para o Amazon Personalize. Para conhecer as diretrizes de formato de dados em massa para todos os tipos de dados, consulte as diretrizes de formato de dados em massa.

Requisitos de dados de ação

A seguir, veja os requisitos de dados de ação para o Amazon Personalize.

Dados de carimbo de data e hora de expiração da ação

Um carimbo de data e hora de expiração da ação especifica a data em que uma ação não é mais válida. Você deve fornecer dados de carimbo de data e hora de expiração da ação no formato de época do Unix, em segundos. Se uma ação tiver expirado, o Amazon Personalize não a incluirá nas recomendações.

Especifique um carimbo de data e hora de expiração para as ações se quiser limitar a exibição delas nas recomendações a um período específico. Por exemplo, você pode ter uma aplicação que esteja executando uma campanha de adesão durante um mês específico. É possível definir um carimbo de data e hora de expiração para a ação de inscrição para o final do mês em questão. O Amazon Personalize interromperá automaticamente a recomendação dessa ação quando essa data for atingida.

Se você definir o carimbo de data e hora de expiração para uma nova ação no passado ou se atualizar o carimbo de data e hora de ações para um horário anterior, poderá levar até duas horas para a remoção da ação das recomendações.

Dados de frequência de repetição

Os dados de frequência de repetição especificam quantos dias o Amazon Personalize deve esperar para recomendar uma ação específica depois que um usuário interagir com ela, com base no histórico do usuário no conjunto de dados de interações com ações. Você deve especificar a frequência de repetição de uma ação em dias com, no máximo, trinta.

Por exemplo, é possível ter uma aplicação de comércio eletrônico no qual cada usuário cria uma conta e um perfil. Se você tiver uma ação complete profile e quiser esperar uma semana após a interação do usuário para recomendá-la novamente, especifique sete dias como REPEAT_FREQENCY da ação. Depois de sete dias, o Amazon Personalize começa a utilizar a ação para recomendações.

Se você não indicar uma frequência de repetição de uma ação, o Amazon Personalize não definirá nenhum limite para o número de vezes que ela aparece nas recomendações.

Value data

Os dados de valor são o valor comercial ou a importância de cada ação. O value da ação pode ser de um a dez, em que dez é a ação mais valiosa do conjunto de dados.

Por exemplo, é possível ter duas ações, uma para inscrição na assinatura básica e outra para inscrição no serviço premium. Para o serviço básico, é possível especificar o valor 5 e, para o premium, o valor 10.

O Amazon Personalize usa dados de valor como uma entrada ao determinar a melhor ação a ser recomendada aos usuários. Por exemplo, se um usuário tiver a mesma probabilidade de realizar uma ação ou outra, o Amazon Personalize classificará a ação com o maior valor em recomendações.

Dados de carimbo de data e hora de criação

O Amazon Personalize usa dados de carimbo de data e hora de criação (no formato de horário de época do Unix, em segundos) para calcular a idade de uma ação e ajustar as recomendações corretamente.

Se não houver dados de carimbo de data e hora de criação, o Amazon Personalize inferirá essas informações de quaisquer dados de interação com ações. Ele usará o carimbo de data e hora dos dados de interação mais antigos da ação como o carimbo de data e hora de criação da ação. Se uma ação não tiver dados de interação, o carimbo de data e hora de criação será definido como o carimbo de data e hora da interação mais recente no conjunto de treinamento e o Amazon Personalize a considerará uma nova ação.

Metadados categóricos

O Amazon Personalize usará metadados categóricos sobre ações, como sazonalidade ou exclusividade da ação, ao identificar os padrões subjacentes que revelam as melhores ações para os usuários. Você define o próprio intervalo de valores com base em seu caso de uso. Os metadados categóricos podem estar em qualquer idioma.

É possível importar dados categóricos e usá-los para filtrar recomendações com base nos atributos de uma ação. Para obter informações sobre como filtrar recomendações, consulte Como filtrar recomendações e segmentos de usuários.

Os valores categóricos podem ter no máximo mil 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.

Dados de string não categóricos

Com exceção da açãoIDs, o Amazon Personalize não usa dados de sequência de caracteres não categóricos durante o treinamento, como nome de uma ação, palavras-chave sobre a ação ou tags. No entanto, o Amazon Personalize pode usá-los ao filtrar as recomendações. É possível criar filtros para incluir ou remover ações das recomendações com base em dados de string não categóricos. Para obter mais informações sobre os filtros, consulte Como filtrar recomendações e segmentos de usuários. Os valores não categóricos podem ter até 1.000 caracteres.

Exemplo de metadados de ações

Os metadados das primeiras linhas de ação em um CSV arquivo podem ter a seguinte aparência.

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

A coluna ACTION_ID é obrigatória. A coluna 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.

Depois de concluir a preparação dos dados, você estará pronto para criar um JSON arquivo de esquema. Esse arquivo informa a estrutura dos seus dados ao Amazon Personalize. Para obter mais informações, consulte Criar arquivos JSON de esquema para esquemas do Amazon Personalize. Essa é a aparência do JSON arquivo de esquema para os dados de amostra acima.

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