Schemaanforderungen für Datensätze mit Artikelinteraktionen (benutzerdefiniert)

Ein Datensatz mit Artikelinteraktionen speichert historische Daten und Echtzeitdaten aus Interaktionen zwischen Benutzern und Artikeln in Ihrem Katalog. Informationen zu den Arten von Interaktionsdaten, die Amazon Personalize verwenden kann, finden Sie unterDatensatz mit Interaktionen zwischen Elementen.

Die Daten, die Sie für jede Interaktion angeben, müssen Ihrem Schema entsprechen. Abhängig von Ihrem Schema können Interaktionsmetadaten leere/Nullwerte enthalten. Sie müssen für jede Interaktion mindestens Folgendes angeben:

• Benutzer-ID

• ID des Artikels

• Zeitstempel (im Zeitformat für die Unix-Epoche)

Es steht Ihnen frei, je nach Ihrem Anwendungsfall und Ihren Daten weitere Felder hinzuzufügen. Solange die Felder nicht als erforderlich oder reserviert aufgeführt sind und die Datentypen unter aufgeführt sindSchema-Datentypen, liegen die Feldnamen und Datentypen bei Ihnen.

Die maximale Gesamtzahl optionaler Metadatenfelder, die Sie einem Datensatz mit Artikelinteraktionen hinzufügen können, zusammen mit der Gesamtzahl der unterschiedlichen Ereignistypen in Ihren Artikelinteraktionsdaten, beträgt 10. Die in dieser Anzahl enthaltenen Metadatenfelder sind die Felder EVENT_TYPE und EVENT_VALUE sowie alle benutzerdefinierten Metadatenfelder, die Sie Ihrem Schema hinzufügen. Die maximale Anzahl von Metadatenfeldern mit Ausnahme von reservierten Feldern wie IMPRESSION beträgt 5. Kategorische Werte können maximal 1000 Zeichen lang sein. Wenn Sie eine Interaktion mit einem kategorialen Wert mit mehr als 1000 haben, schlägt Ihr Datensatz-Importjob fehl.

Weitere Informationen zu Mindestanforderungen und maximalen Datenlimits für einen Datensatz mit Artikelinteraktionen finden Sie unterServicekontingente.

Beispiel für ein Interaktionsschema (benutzerdefiniert)

Das folgende Beispiel zeigt ein Schema für einen Datensatz mit Artikelinteraktionen. Die Felder USER_ID, ITEM_ID und TIMESTAMP sind erforderlich. Die IMPRESSION Felder EVENT_TYPEEVENT_VALUE, und sind optionale reservierte Schlüsselwörter, die von Amazon Personalize erkannt werden. EVENT_TYPE muss vom Typ „Zeichenfolge“ sein und darf nicht kategorisch sein. LOCATIONund DEVICE sind optionale kontextuelle Metadatenfelder. Informationen zu Schemaanforderungen finden Sie unter. Anforderungen an benutzerdefinierte Datensätze und Schemas

{

  "type": "record",
  "name": "Interactions",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
      {
          "name": "USER_ID",
          "type": "string"
      },
      {
          "name": "ITEM_ID",
          "type": "string"
      },
      {
          "name": "EVENT_TYPE",
          "type": "string"
      },
      {
          "name": "EVENT_VALUE",
          "type": [
             "float",
             "null"
          ]
      },
      {
          "name": "LOCATION",
          "type": "string",
          "categorical": true
      },
      {
          "name": "DEVICE",
          "type": [
              "string",
              "null"
          ],
          "categorical": true
      },
      {
          "name": "TIMESTAMP",
          "type": "long"
      },
      {
          "name": "IMPRESSION",
          "type": "string"
      }
  ],
  "version": "1.0"
}

Für dieses Schema könnten die ersten Zeilen mit historischen Daten in einer CSV-Datei wie folgt aussehen. Beachten Sie, dass einige Werte für EVENT_VALUE Null sind.

USER_ID,ITEM_ID,EVENT_TYPE,EVENT_VALUE,LOCATION,DEVICE,TIMESTAMP,IMPRESSION
35,73,click,,Ohio,Tablet,1586731606,73|70|17|95|96|92|55|45|16|97|56|54|33|94|36|10|5|43|19|13|51|90|65|59|38
54,35,watch,0.75,Indiana,Cellphone,1586735164,35|82|78|57|20|63|1|90|76|75|49|71|26|24|25|6|37|85|40|98|32|13|11|54|48
9,33,click,,Oregon,Cellphone,1586735158,68|33|62|6|15|57|45|24|78|89|90|40|26|91|66|31|47|17|99|29|27|41|77|75|14
23,10,watch,0.25,California,Tablet,1586735697,92|89|36|10|39|77|4|27|79|18|83|16|28|68|78|40|50|3|99|7|87|49|12|57|53
27,11,watch,0.55,Indiana,Tablet,1586735763,11|7|39|95|71|1|6|40|41|28|99|53|68|76|0|65|69|36|22|42|34|67|24|20|66
...
...