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
Um evento de *interação com ação* é uma interação entre um usuário e uma *ação*. Por exemplo, um usuário que se inscreve em um programa de associação ou solicita um cartão de crédito.
Se você usar uma fórmula personalizada PERSONALIZED\$1ACTIONS, registrará eventos de interação com ações em tempo real à medida que os clientes interagirem com as recomendações de ações. 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. Somente as fórmulas personalizadas PERSONALIZED\$1ACTIONS usam dados de interações com ações.
Você deve registrar eventos de interação com ações com a operação de API [PutActionInteractions](API_UBS_PutActionInteractions.md). O Amazon Personalize anexa esses dados ao [conjunto de dados de interações com ações](action-interactions-datasets.md) no grupo de conjuntos de dados.
Um evento de interação com ações deve ter um atributo de tipo de evento, que pode ser um dos seguintes:
+ 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 tem interesse 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.
Você pode gravar eventos em tempo real usando o AWS SDKs, ou AWS Command Line Interface (AWS CLI). 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.
**Topics**
+ [Requisitos para registrar eventos de interação com ações](#recording-action-interaction-requirements)
+ [Encontrar o ID do rastreador de eventos de interações com ações](action-interaction-tracker-id.md)
+ [Registrar um único evento de interação com ações](record-single-action-interaction.md)
+ [Registrar vários eventos de interação com ações](recording-multiple-action-interactions.md)
## Requisitos para registrar eventos de interação com ações
Para registrar eventos de interação com ações em tempo real, você precisa do seguinte:
+ Um grupo de conjuntos de dados que inclua um `Action interactions dataset`, que pode estar vazio. 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).
+ O ID do rastreador de eventos. Você especifica esse ID na PutActionInteractions operação. Ao criar um conjunto de dados de interações com ações, o Amazon Personalize cria automaticamente um rastreador de eventos de interações com ações para você. Para obter mais informações, consulte [Encontrar o ID do rastreador de eventos de interações com ações](action-interaction-tracker-id.md).
+ Uma chamada para a operação [PutActionInteractions](API_UBS_PutActionInteractions.md).
# Encontrar o ID do rastreador de eventos de interações com ações
Ao criar um conjunto de dados de interações com ações, o Amazon Personalize cria automaticamente um rastreador de eventos de *interações com ações* para você. Você especifica o ID do rastreador na operação da PutActionInteractions API. O Amazon Personalize o utiliza para direcionar novos dados para o *conjunto de dados de interações com ações* no grupo de conjuntos de dados.
É possível encontrar o ID do rastreador de eventos na página de detalhes do conjunto de dados de interações de ações no console do Amazon Personalize. E você pode encontrar o ID chamando a operação DescribeDataset da API. O código Python a seguir mostra o ID de acompanhamento de um conjunto de dados de interações com ações.
```
import boto3
personalize = boto3.client(service_name='personalize')
response = personalize.describe_dataset(
datasetArn="Action interactions dataset ARN"
)
print(response['trackingId'])
```
# Registrar um único evento de interação com ações
Depois de criar um conjunto de dados de interações com ações, estará tudo pronto para registrar eventos de interação com ações com a operação [PutActionInteractions](API_UBS_PutActionInteractions.md). O código a seguir mostra uma operação `PutActionInteractions` que transmite um evento TAKEN. Você pode registrar esse evento quando mostrar recomendações do Amazon Personalize a um usuário e ele realizar uma ação, como solicitar um cartão de crédito.
`actionInteractions`É uma matriz de ActionInteraction objetos. O `trackingId` vem do rastreador de eventos que o Amazon Personalize criou quando você criou o conjunto de dados de interações com ações. Para obter mais informações, consulte [Encontrar o ID do rastreador de eventos de interações com ações](action-interaction-tracker-id.md).
Seu aplicativo gera um `sessionId` exclusivo quando alguém visita seu site ou usa seu aplicativo pela primeira vez. Você deve usar o mesmo `sessionId` em todos os eventos durante a sessão. O Amazon Personalize usa o `sessionId` para associar eventos ao usuário antes que ele faça login (com anonimato). Para obter mais informações, consulte [Como registrar eventos de usuários anônimos](recording-events.md#recording-anonymous-user-events).
Os parâmetros `userId`, `actionId` e `sentAt` são associados aos campos USER\$1ID, ACTION\$1ID, EVENT\$1TYPE e TIMESTAMP do conjunto de dados de interações com ações.
**Conjunto de dados de interações com ações correspondente**
```
USER_ID, ACTION_ID, TIMESTAMP, EVENT_TYPE
user123, action-xyz, 1543631760, TAKEN
```
**Exemplo de código**
------
#### [ AWS CLI ]
```
aws personalize-events put-action-interactions \
--tracking-id 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
--action-interactions '[{
"userId": "user123",
"sessionId": "abcdefg",
"timestamp": 1543631760,
"eventType": "TAKEN",
"actionId": "action-xyz"}]'
```
------
#### [ SDK for Python (Boto3) ]
```
import boto3
personalize_events = boto3.client(service_name='personalize-events')
response = personalize_events.put_action_interactions(
trackingId='12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
actionInteractions=[{
'userId': 'user123',
'sessionId': 'abcdefg',
'timestamp': 1543631760,
'eventType': 'Taken',
'actionId': 'action-xyz'
}]
)
```
------
# Registrar vários eventos de interação com ações
O código a seguir mostra como registrar vários eventos de interação com ações para o mesmo usuário com o mesmo sessionId.
**Conjunto de dados de interações com ações correspondente**
```
USER_ID, ACTION_ID, EVENT_TYPE, TIMESTAMP
user123, action123, Taken, 1543531139
user123, action345, Not Taken, 1543531139
```
------
#### [ AWS CLI ]
```
aws personalize-events put-action-interactions \
--tracking-id 6ddfe6b7-cd83-4dd4-b09d-4c35ecbacfe1 \
--action-interactions '[{
"userId": "user123",
"sessionId": "abcdefg",
"timestamp": 1543531139,
"eventType": "Taken",
"actionId": "action123"
},
{
"userId": "user123",
"sessionId": "abcdefg",
"timestamp": 1543531139,
"eventType": "Not Taken",
"actionId": "action345"}]'
```
------
#### [ SDK for Python (Boto3) ]
```
import boto3
personalize_events = boto3.client(service_name='personalize-events')
response = personalize_events.put_action_interactions(
trackingId='12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
actionInteractions=[{
'userId': 'user123',
'sessionId': 'abcdefg',
'timestamp': 1697848587,
'eventType': 'Taken',
'actionId': 'action123'
},
{
'userId': 'user123',
'sessionId': 'abcdefg',
'timestamp': 1697848622,
'eventType': 'Not Taken',
'actionId': 'action345'
}]
)
```
------