Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Aufzeichnung von Action-Interaktionsereignissen in Echtzeit
*Ein *Aktionsereignis* ist eine Interaktion zwischen einem Benutzer und einer Aktion.* Zum Beispiel ein Benutzer, der sich für ein Mitgliedschaftsprogramm anmeldet oder eine Kreditkarte beantragt.
Wenn Sie ein benutzerdefiniertes Rezept für PERSONALIZED\$1ACTIONS verwenden, zeichnen Sie Aktionsereignisse in Echtzeit auf, während Ihre Kunden mit Handlungsempfehlungen interagieren. Dadurch werden Ihre Interaktionsdaten erweitert und Ihre Daten auf dem neuesten Stand gehalten. Es informiert Amazon Personalize auch über die aktuellen Interessen Ihres Benutzers, wodurch die Relevanz von Empfehlungen verbessert werden kann. Nur die benutzerdefinierten Rezepte von PERSONALIZED\$1ACTIONS verwenden Daten zu Aktionsinteraktionen.
Sie zeichnen Aktionsereignisse mit dem API-Vorgang auf. [PutActionInteractions](API_UBS_PutActionInteractions.md) Amazon Personalize hängt diese Daten an den Datensatz „[Aktionsinteraktionen“ in Ihrer Datensatzgruppe](action-interactions-datasets.md) an.
Ein Aktions-Interaktionsereignis muss über ein Ereignistyp-Attribut verfügen, das eines der folgenden sein kann:
+ Ergriffen — *Erlegene* Ereignisse aufzeichnen, wenn ein Benutzer eine empfohlene Maßnahme ergreift.
+ Nicht ausgeführt — Ereignisse, die *nicht ausgeführt wurden*, aufzeichnen, wenn Ihr Benutzer sich bewusst dafür entscheidet, die Aktion nicht auszuführen, nachdem er sich die Aktion angesehen hat. Zum Beispiel, wenn sie *Nein* wählen, wenn Sie ihnen die Aktion zeigen. Ereignisse, die *nicht durchgeführt wurden*, können darauf hinweisen, dass der Kunde an der Aktion nicht interessiert ist.
+ Angesehen — *Angesehene* Ereignisse aufzeichnen, wenn Sie einem Benutzer eine Aktion zeigen, bevor er sich entscheidet, ob er eine Aktion ausführt oder nicht. Amazon Personalize verwendet *View-Ereignisse*, um mehr über die Interessen Ihrer Benutzer zu erfahren. Wenn ein Benutzer beispielsweise eine Aktion betrachtet, sie aber nicht ausführt, ist dieser Benutzer möglicherweise in future nicht an dieser Aktion interessiert.
Mit dem, oder AWS Command Line Interface (AWS CLI) können Sie Ereignisse in Echtzeit aufzeichnen. AWS SDKs Wenn Sie zwei Ereignisse mit exakt demselben Zeitstempel und identischen Eigenschaften aufzeichnen, speichert Amazon Personalize nur eines der Ereignisse.
**Topics**
+ [Anforderungen für die Aufzeichnung von Ereignissen im Zusammenhang mit Aktionen](#recording-action-interaction-requirements)
+ [Finden Sie die ID Ihres Action-Interaktions-Event-Trackers](action-interaction-tracker-id.md)
+ [Aufzeichnen eines einzelnen Aktionsinteraktionsereignisses](record-single-action-interaction.md)
+ [Aufzeichnen mehrerer Aktionsinteraktionsereignisse](recording-multiple-action-interactions.md)
## Anforderungen für die Aufzeichnung von Ereignissen im Zusammenhang mit Aktionen
Um Aktionsereignisse in Echtzeit aufzuzeichnen, benötigen Sie Folgendes:
+ Eine Datensatzgruppe, die eine enthält`Action interactions dataset`, die leer sein kann. Hinweise zum Erstellen einer Datensatzgruppe und eines Datensatzes finden Sie unter[Trainingsdaten in Amazon Personalize Personalize-Datensätze importieren](import-data.md).
+ Die ID Ihres Event-Trackers. Sie geben diese ID in der PutActionInteractions Operation an. Wenn Sie einen Action-Interaction-Datensatz erstellen, erstellt Amazon Personalize automatisch einen Action-Interaktions-Event-Tracker für Sie. Weitere Informationen finden Sie unter [Finden Sie die ID Ihres Action-Interaktions-Event-Trackers](action-interaction-tracker-id.md).
+ Einen Aufruf der [PutActionInteractions](API_UBS_PutActionInteractions.md)-Operation.
# Finden Sie die ID Ihres Action-Interaktions-Event-Trackers
Wenn Sie einen Action-Interaction-Datensatz erstellen, erstellt Amazon Personalize automatisch einen *Action-Interaktions-Event-Tracker* für Sie. Sie geben die ID des Trackers im PutActionInteractions API-Vorgang an. Amazon Personalize leitet damit neue Daten an den Datensatz „*Aktionsinteraktionen“ in Ihrer Datensatzgruppe* weiter.
Sie finden die ID Ihres Event-Trackers auf der Detailseite Ihres Action-Interaktions-Datensatzes in der Amazon Personalize Personalize-Konsole. Und Sie können die ID finden, indem Sie den DescribeDataset API-Vorgang aufrufen. Der folgende Python-Code druckt die Tracking-ID für einen Datensatz mit Aktionsinteraktionen.
```
import boto3
personalize = boto3.client(service_name='personalize')
response = personalize.describe_dataset(
datasetArn="Action interactions dataset ARN"
)
print(response['trackingId'])
```
# Aufzeichnen eines einzelnen Aktionsinteraktionsereignisses
Nachdem Sie einen Datensatz mit Aktionsinteraktionen erstellt haben, können Sie Aktionsereignisse mit der [PutActionInteractions](API_UBS_PutActionInteractions.md) Operation aufzeichnen. Der folgende Code zeigt eine `PutActionInteractions` Operation, die ein TAKEN-Ereignis übergibt. Sie können dieses Ereignis aufzeichnen, wenn Sie einem Benutzer Empfehlungen von Amazon Personalize anzeigen und dieser eine Maßnahme ergreift, z. B. Ihre Kreditkarte beantragt.
Das `actionInteractions` ist eine Reihe von ActionInteraction Objekten. Das `trackingId` stammt aus dem Event-Tracker Amazon Personalize, den Sie bei der Erstellung Ihres Action-Interaktions-Datensatzes erstellt haben. Weitere Informationen finden Sie unter [Finden Sie die ID Ihres Action-Interaktions-Event-Trackers](action-interaction-tracker-id.md).
Ihre Anwendung generiert ein eindeutiges Zeichen`sessionId`, wenn ein Benutzer Ihre Website zum ersten Mal besucht oder Ihre Anwendung verwendet. Sie müssen während der gesamten Sitzung `sessionId` bei allen Veranstaltungen dasselbe verwenden. Amazon Personalize verwendet das`sessionId`, um Ereignisse mit dem Benutzer zu verknüpfen, bevor er sich anmeldet (ist anonym). Weitere Informationen finden Sie unter [Ereignisse für anonyme Benutzer aufzeichnen](recording-events.md#recording-anonymous-user-events).
Die `sentAt` Parameter `userId``actionId`, und sind den Feldern USER\$1ID, ACTION\$1ID, EVENT\$1TYPE und TIMESTAMP des Action-Interaktions-Datensatzes zugeordnet.
**Entsprechender Datensatz „Action-Interaktionen“**
```
USER_ID, ACTION_ID, TIMESTAMP, EVENT_TYPE
user123, action-xyz, 1543631760, TAKEN
```
**Code-Beispiel**
------
#### [ 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'
}]
)
```
------
# Aufzeichnen mehrerer Aktionsinteraktionsereignisse
Der folgende Code zeigt, wie mehrere Aktionsinteraktionsereignisse für denselben Benutzer mit derselben sessionId aufgezeichnet werden.
**Entsprechender Datensatz „Aktionsinteraktionen“**
```
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'
}]
)
```
------