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 dados de interação com ações para treinamento
<a name="action-interactions-datasets"></a>

 Se você usar a fórmula personalizada [Next-Best-Action](native-recipe-next-best-action.md), o Amazon Personalize utiliza os dados de interações com ações para identificar o interesse dos usuários e prever as ações que eles provavelmente vão realizar. *Interação com ação* é uma interação que envolve um usuário e uma ação no [conjunto de dados de ações](actions-datasets.md). Por exemplo, se houver uma ação de *inscrição* no conjunto de dados de ações e um usuário realizar essa ação, você registrará o ID do usuário, o ID da ação, o carimbo de data e hora e, para o tipo de evento, registrará `TAKEN`. 

Você deve importar interações com ações para um *conjunto de dados de interações com ações* do Amazon Personalize. É possível importar eventos de interação com ações em massa com um trabalho de importação de conjunto de dados ou transmiti-los em tempo real com a operação de API [PutActionInteractions](API_UBS_PutActionInteractions.md). Não é possível criar os recursos de próximas melhores ações, incluindo os conjuntos de dados de interações com ações e ações, em um grupo de conjuntos de dados de domínio.

Seus dados de interações com ações em massa devem estar em um arquivo CSV. Cada linha do arquivo deve representar uma interação exclusiva entre um usuário e uma ação. Quando terminar de preparar os dados, você poderá criar um arquivo JSON do 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](how-it-works-dataset-schema.md).

 As próximas seções contêm mais informações sobre como preparar os dados de interações com ações do 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](preparing-training-data.md#general-formatting-guidelines).

**Topics**
+ [Requisitos de dados de interações com ações](#action-interaction-requirements)
+ [Dados de tipos de eventos](#action-interaction-event-type-data)
+ [Exemplo de dados de interações com ações](#action-interactions-data-schema-example)

## Requisitos de dados de interações com ações
<a name="action-interaction-requirements"></a>

Não há requisitos mínimos para dados de interações com ações. Recomendamos importá-los para obter recomendações de ações de qualidade. Se não houver dados de interações com ações, será possível criar um conjunto de dados de interações com ações vazio e registrar as interações dos clientes com ações usando a operação de API [PutActionInteractions](API_UBS_PutActionInteractions.md). 

Seus dados de interações com ações devem ter no mínimo as colunas a seguir. Você pode adicionar outras colunas personalizadas dependendo do seu caso de uso e dos seus dados.
+ USER\_ID: o identificador exclusivo do usuário que interagiu com o item. Todo evento deve ter um USER\_ID. Esse nome deve ter uma `string` com até 256 caracteres.
+ ACTION\_ID: o identificador exclusivo do item com que o usuário interagiu. Todo evento deve ter um ID de item. Esse nome deve ter uma `string` com até 256 caracteres.
+  TIMESTAMP: a hora em que o evento ocorreu (no formato do Epoch Time do Unix em segundos). Cada interação com ações deve ter um TIMESTAMP. Para obter mais informações, consulte [Dados de carimbo de data/hora](interactions-datasets.md#timestamp-data).
+ EVENT\_TYPE: se a ação foi realizada, não realizada ou visualizada. Cada interação com ações deve ter um tipo de evento. Para obter mais informações, consulte [Dados de tipos de eventos](#action-interaction-event-type-data).

 Até que você importe os dados de interações com ações, o Amazon Personalize recomenda ações sem personalização, e as pontuações de propensão são 0,0. Uma ação terá uma pontuação depois que tiver o seguinte: 
+  Pelo menos 50 interações com ações com o tipo de evento TAKEN. 
+  Pelo menos 50 interações com ações com o tipo de evento NOT\_TAKEN ou VIEWED. 

Essas interações com ações devem ser incluídas no treinamento da versão mais recente da solução e têm que ocorrer dentro de seis semanas, a partir do registro de data e hora da interação mais recente no conjunto de dados de interações com ações. 

## Dados de tipos de eventos
<a name="action-interaction-event-type-data"></a>

 O Amazon Personalize pode usar padrões em dados de tipos de eventos com o objetivo de identificar as ações que os usuários provavelmente vão realizar. Por exemplo, se um cliente quase sempre ignora uma ação de assinatura de e-mail (indicada com o tipo de evento NOT\_TAKEN), o Amazon Personalize poderá ajustar as recomendações para incluir menos ocorrências desse tipo de ação. 

 É possível usar somente os tipos de eventos a seguir para eventos de interação com ações. O Amazon Personalize usa esses eventos para saber mais sobre o usuário e avaliar quais ações recomendar depois.
+ Taken: registre eventos *Taken* quando um usuário executa uma ação recomendada.
+ Not taken: registre eventos *Not Taken* quando o usuário opta deliberadamente por não executar a ação depois de visualizá-la. Por exemplo, se ele selecionar *Não* quando a ação for exibida. Os eventos *Not Taken* podem indicar que o cliente não está interessado na ação.
+ Viewed: registre eventos *Viewed* quando você exibir uma ação a um usuário ação antes que ele opte por realizá-la ou não. O Amazon Personalize usa eventos *Viewed* para saber mais sobre os interesses dos usuários. Por exemplo, se um usuário visualiza uma ação e não a realiza, talvez não se interesse por essa ação no futuro. 

## Exemplo de dados de interações com ações
<a name="action-interactions-data-schema-example"></a>

As primeiras linhas de um arquivo CSV com os dados de interações com ações e todas as colunas necessárias podem ser organizadas como descrito a seguir.

```
USER_ID,ACTION_ID,EVENT_TYPE,TIMESTAMP
35,73,Viewed,1586731606
54,35,Not taken,1586731609
9,33,Viewed,1586735158
23,10,Taken,1586735697
27,11,Taken,1586735763
...
...
```

Quando terminar de preparar os dados, você poderá criar um arquivo JSON do 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](how-it-works-dataset-schema.md). Essa é a aparência do arquivo JSON do esquema para os dados de amostra acima.

```
{

  "type": "record",
  "name": "ActionInteractions",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
      {
          "name": "USER_ID",
          "type": "string"
      },
      {
          "name": "ACTION_ID",
          "type": "string"
      },
      {
          "name": "EVENT_TYPE",
          "type": "string"
      },
      {
          "name": "TIMESTAMP",
          "type": "long"
      }
  ],
  "version": "1.0"
}
```