PutEvents - Amazon Personalize
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

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 Ereignisdaten zur Interaktion mit Artikeln 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 CreateEventTrackerAPI 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 einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: