

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

# Registrar eventos de interação com ações em tempo real
<a name="recording-item-interaction-events"></a>

 *Evento de interação com item* é uma interação entre um usuário e um item do catálogo. Por exemplo, um usuário comprando sapatos ou assistindo a um filme.

Registre eventos de interação com itens em tempo real ao mostrar recomendações de itens ao cliente. Isso cria dados de interações e os mantém atualizados. Também informa o Amazon Personalize sobre os interesses atuais do usuário, o que pode melhorar a relevância das recomendações. 

 Você deve registrar eventos de interação com itens com a operação de API [PutEvents](API_UBS_PutEvents.md). O Amazon Personalize anexa os dados do evento ao *conjunto de dados de interações com itens* no grupo de conjuntos de dados. Se você gravar dois eventos com exatamente as mesmas informações de data e hora e propriedades idênticas, o Amazon Personalize manterá somente um dos eventos. Você pode gravar eventos de interação do item usando o AWS SDKs, AWS Amplify ou AWS Command Line Interface ()AWS CLI. 

Se você usa o Apache Kafka, utilize o *conector do Kafka para o Amazon Personalize* para transmitir interações com itens em tempo real para o Amazon Personalize. Para obter informações, consulte [Conector Kafka para Amazon](https://github.com/aws/personalize-kafka-connector/blob/main/README.md) Personalize no *personalize-kafka-connector*repositório Github.

 AWS O Amplify inclui uma JavaScript biblioteca para registrar eventos de interação de itens de aplicativos cliente web e uma biblioteca para gravar eventos no código do servidor. Para obter mais informações, consulte a [documentação do Amplify](https://docs.amplify.aws/). 

**Topics**
+ [Requisitos para registrar eventos de interação com itens e treinar um modelo](#recording-events-requirements)
+ [Criar um rastreador de eventos de interação com itens](event-get-tracker.md)
+ [Registrar um único evento de interação com itens](putevents-example.md)
+ [Registrar vários eventos de interação com itens com dados de valor dos eventos](recording-events-example-event-value.md)
+ [Registrar eventos de interação com itens usando os dados de impressões](putevents-including-impressions-data.md)
+ [Métricas de eventos e relatórios de atribuição](event-metrics.md)

## Requisitos para registrar eventos de interação com itens e treinar um modelo
<a name="recording-events-requirements"></a>

Para registrar eventos de interação com itens, é necessário o seguinte:
+ Um grupo de conjuntos de dados que inclui um conjunto de dados `Item interactions`, que pode estar vazio. Se você consultou o guia [Tutoriais de conceitos básicos](getting-started.md), pode usar o mesmo conjunto de dados e o grupo de conjuntos de dados que criou. Para mais informações sobre como criar um grupo de conjuntos de dados e um conjunto de dados, consulte [Importar dados de treinamento para os conjuntos de dados do Amazon Personalize](import-data.md).
+ Um rastreador de eventos.
+ Uma chamada para a operação de API [PutEvents](API_UBS_PutEvents.md).
+  Se você usar uma AWS Lambda função para chamar a PutEvents operação, a função de execução da função deverá ter permissão para realizar a `personalize:PutEvents` ação com o caractere curinga `*` no `Resource` elemento. 

É possível começar com um conjunto de dados de interações com itens vazio e, depois de registrar dados suficientes, treinar o modelo usando somente novos eventos registrados. Para todos os casos de uso (grupos de conjuntos de dados de Domínio) e fórmulas (grupos de conjuntos de dados personalizados), seus dados de interações precisam do seguinte antes do treinamento: 
+ No mínimo, mil registros de interações com itens de usuários que interagem com itens do catálogo. Essas interações podem ser de importações em massa, eventos transmitidos ou ambas as coisas.
+ No mínimo 25 usuários únicos IDs com pelo menos duas interações de itens para cada um.

Para obter recomendações de qualidade, o ideal é que você tenha, no mínimo, cinquenta mil interações com itens de, pelo menos, mil usuários com duas ou mais interações com itens cada.