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.
PutEvents
Zeichnet Daten zu Artikelinteraktionsereignissen auf. Weitere Informationen finden Sie unter Aufzeichnen von Interaktionsereignissen mit Artikeln.
Anmerkung
Wenn Sie eine AWS Lambda Funktion verwenden, um den PutEvents Vorgang aufzurufen, muss die Ausführungsrolle Ihrer Funktion über die Berechtigung verfügen, die personalize:PutEvents Aktion mit dem Platzhalter * im Resource Element auszuführen.
Anforderungssyntax
POST /events HTTP/1.1
Content-type: application/json
{
"eventList": [
{
"eventId": "string",
"eventType": "string",
"eventValue": number,
"impression": [ "string" ],
"itemId": "string",
"metricAttribution": {
"eventAttributionSource": "string"
},
"properties": "string",
"recommendationId": "string",
"sentAt": number
}
],
"sessionId": "string",
"trackingId": "string",
"userId": "string"
}URI-Anfrageparameter
Die Anforderung verwendet keine URI-Parameter.
Anforderungstext
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
- eventList
-
Eine Liste mit Ereignisdaten aus der Sitzung.
Typ: Array von Event-Objekten
Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 10 Elemente.
Erforderlich: Ja
- sessionId
-
Die Sitzungs-ID, die dem Besuch des Benutzers zugeordnet ist. Ihre Anwendung generiert die sessionId, wenn ein Benutzer Ihre Website zum ersten Mal besucht oder Ihre Anwendung verwendet. Amazon Personalize verwendet die sessionId, um Ereignisse mit dem Benutzer zu verknüpfen, bevor er sich anmeldet. Weitere Informationen finden Sie unter Aufzeichnen von Interaktionsereignissen mit Artikeln.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen.
Erforderlich: Ja
- trackingId
-
Die Tracking-ID für das Ereignis. Die ID wird durch einen Aufruf der CreateEventTracker-API generiert.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen.
Erforderlich: Ja
- userId
-
Der mit dem Ereignis verknüpfte Benutzer.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen.
Erforderlich: Nein
Antwortsyntax
HTTP/1.1 200
Antwortelemente
Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.
Fehler
- InvalidInputException
-
Geben Sie einen gültigen Wert für das Feld oder den Parameter an.
HTTP Status Code: 400
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden:
