Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Enregistrement des événements d'interaction en temps réel
Un événement *d'interaction d'action* est une interaction entre un utilisateur et une *action*. Par exemple, un utilisateur s'inscrivant à un programme d'adhésion ou demandant une carte de crédit.
Si vous utilisez une recette personnalisée PERSONALIZED\$1ACTIONS, enregistrez les événements d'interaction en temps réel au fur et à mesure que vos clients interagissent avec les recommandations d'action. Cela permet de développer vos données d'interactions et de les actualiser. Il informe également Amazon Personalize des centres d'intérêt actuels de votre utilisateur, ce qui peut améliorer la pertinence des recommandations. Seules les recettes personnalisées PERSONALIZED\$1ACTIONS utilisent les données des interactions d'action.
Vous enregistrez les événements d'interaction avec l'action de [PutActionInteractions](API_UBS_PutActionInteractions.md) l'API. Amazon Personalize ajoute ces données au [jeu de données Action interactions](action-interactions-datasets.md) de votre groupe de jeux de données.
Un événement d'interaction avec une action doit avoir un attribut de type d'événement, qui peut être l'un des suivants :
+ Taken : enregistre *les* événements Taken lorsqu'un utilisateur exécute une action recommandée.
+ Non prise — Enregistrez les événements *non* effectués lorsque votre utilisateur fait le choix délibéré de ne pas effectuer l'action après l'avoir consultée. Par exemple, s'ils choisissent *Non* lorsque vous leur montrez l'action. Les événements *Not* Taken peuvent indiquer que le client n'est pas intéressé par l'action.
+ Consulté — Enregistrez les événements *consultés* lorsque vous montrez une action à un utilisateur avant qu'il ne fasse le choix d'effectuer ou de ne pas effectuer une action. Amazon Personalize utilise les événements *View* pour en savoir plus sur les centres d'intérêt de vos utilisateurs. Par exemple, si un utilisateur voit une action mais ne l'exécute pas, il se peut que cette action ne l'intéresse pas à l'avenir.
Vous pouvez enregistrer des événements en temps réel à l'aide de AWS SDKs, ou AWS Command Line Interface (AWS CLI). Si vous enregistrez deux événements avec exactement le même horodatage et les mêmes propriétés, Amazon Personalize ne conserve qu'un seul des événements.
**Topics**
+ [Exigences relatives à l'enregistrement des événements d'interaction entre actions](#recording-action-interaction-requirements)
+ [Trouver l'identifiant de votre outil de suivi des événements d'interaction et d'action](action-interaction-tracker-id.md)
+ [Enregistrement d'un événement d'interaction avec une seule action](record-single-action-interaction.md)
+ [Enregistrement de plusieurs événements d'interaction entre actions](recording-multiple-action-interactions.md)
## Exigences relatives à l'enregistrement des événements d'interaction entre actions
Pour enregistrer des événements d'interaction en temps réel, vous avez besoin des éléments suivants :
+ Un groupe de jeux de données qui inclut un`Action interactions dataset`, qui peut être vide. Pour plus d'informations sur la création d'un groupe de jeux de données et d'un ensemble de données, consultez[Importation de données de formation dans les ensembles de données Amazon Personalize](import-data.md).
+ L'identifiant de votre outil de suivi des événements. Vous spécifiez cet ID lors de l' PutActionInteractions opération. Lorsque vous créez un ensemble de données d'interactions d'action, Amazon Personalize crée automatiquement un outil de suivi des événements d'interaction d'action pour vous. Pour de plus amples informations, veuillez consulter [Trouver l'identifiant de votre outil de suivi des événements d'interaction et d'action](action-interaction-tracker-id.md).
+ Un appel de l'opération [PutActionInteractions](API_UBS_PutActionInteractions.md).
# Trouver l'identifiant de votre outil de suivi des événements d'interaction et d'action
Lorsque vous créez un ensemble de données d'interactions d'action, Amazon Personalize crée automatiquement un outil de suivi des événements *d'interaction d'action* pour vous. Vous spécifiez l'ID du tracker dans l'opération PutActionInteractions d'API. Amazon Personalize l'utilise pour diriger les nouvelles données vers le jeu de *données Action interactions de* votre groupe de jeux de données.
Vous trouverez l'identifiant de votre outil de suivi d'événements sur la page détaillée de votre ensemble de données d'interactions Action dans la console Amazon Personalize. Et vous pouvez trouver l'identifiant en appelant l'opération DescribeDataset API. Le code Python suivant imprime l'ID de suivi d'un ensemble de données d'interactions Action.
```
import boto3
personalize = boto3.client(service_name='personalize')
response = personalize.describe_dataset(
datasetArn="Action interactions dataset ARN"
)
print(response['trackingId'])
```
# Enregistrement d'un événement d'interaction avec une seule action
Après avoir créé un jeu de données d'interactions d'action, vous êtes prêt à enregistrer les événements d'interaction d'action avec l'[PutActionInteractions](API_UBS_PutActionInteractions.md)opération. Le code suivant montre une `PutActionInteractions` opération qui transmet un événement TAKEN. Vous pouvez enregistrer cet événement lorsque vous montrez à un utilisateur les recommandations d'Amazon Personalize et qu'il entreprend une action, telle qu'une demande de carte de crédit.
`actionInteractions`Il s'agit d'un ensemble d' ActionInteraction objets. Il `trackingId` provient du système de suivi d'événements Amazon Personalize créé lorsque vous avez créé votre ensemble de données d'interactions Action. Pour de plus amples informations, veuillez consulter [Trouver l'identifiant de votre outil de suivi des événements d'interaction et d'action](action-interaction-tracker-id.md).
Votre application génère un code unique `sessionId` lorsqu'un utilisateur visite votre site Web ou utilise votre application pour la première fois. Vous devez utiliser le même `sessionId` dans tous les événements de la session. Amazon Personalize utilise le `sessionId` pour associer des événements à l'utilisateur avant qu'il ne se connecte (c'est anonyme). Pour de plus amples informations, veuillez consulter [Enregistrement d'événements pour les utilisateurs anonymes](recording-events.md#recording-anonymous-user-events).
Les `sentAt` paramètres `userId``actionId`, et correspondent aux champs USER\$1ID, ACTION\$1ID, EVENT\$1TYPE et TIMESTAMP du jeu de données Action interactions.
**Ensemble de données d'interactions Action correspondant**
```
USER_ID, ACTION_ID, TIMESTAMP, EVENT_TYPE
user123, action-xyz, 1543631760, TAKEN
```
**Exemple de code**
------
#### [ 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'
}]
)
```
------
# Enregistrement de plusieurs événements d'interaction entre actions
Le code suivant montre comment enregistrer plusieurs événements d'interaction d'action pour le même utilisateur avec le même SessionId.
**Ensemble de données d'interactions Action correspondant**
```
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'
}]
)
```
------