

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.

# Schemaanforderungen für Datensätze mit Artikelinteraktionen (benutzerdefiniert)
<a name="interactions-dataset-requirements"></a>

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 unter[Daten zur Interaktion mit Artikeln](interactions-datasets.md).

 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
+ Artikel-ID
+ 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 sind[Schema-Datentypen](how-it-works-dataset-schema.md#personalize-datatypes), 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. Kategoriale 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 unter[Servicekontingente](limits.md#limits-table). 

## Beispiel für ein Interaktionsschema (benutzerdefiniert)
<a name="schema-examples-interactions"></a>

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_TYPE``EVENT_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. `LOCATION`und `DEVICE` sind optionale kontextuelle Metadatenfelder. Informationen zu Schemaanforderungen finden Sie unter. [Anforderungen an benutzerdefinierte Datensätze und Schemas](custom-datasets-and-schemas.md#dataset-requirements) 

```
{

  "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
...
...
```