Anforderungen an das Datensatz-Schema der Benutzer (benutzerdefiniert)

Ein Benutzerdatensatz speichert Metadaten über Ihre Benutzer. Dies kann Informationen wie Alter, Geschlecht und Loyalitätsmitgliedschaft für jeden Artikel beinhalten. Informationen zu den Arten von Benutzerdaten, die Sie in Amazon Personalize importieren können, finden Sie unterBenutzerdatensatz.

Die Daten, die Sie für jeden Benutzer angeben, müssen Ihrem Schema entsprechen. Sie müssen mindestens eine Benutzer-ID für jeden Benutzer angeben (maximale Länge 256 Zeichen). Abhängig von Ihrem Schema können Benutzermetadaten leere Werte oder Nullwerte enthalten. Ihr Benutzerschema muss mindestens ein Metadatenfeld enthalten. Wenn Sie jedoch einen null Typ hinzufügen, kann dieser Wert für den Benutzer Null sein. 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.

Um kategoriale Daten zu verwenden, fügen Sie ein Feld vom Typ hinzu string und legen Sie das kategoriale Attribut des Felds true in Ihrem Schema auf fest. Nehmen Sie dann die kategorialen Daten in Ihre CSV-Massendatei und die Importe einzelner Artikel auf. Bei Benutzern mit mehreren Kategorien trennen Sie die einzelnen Werte mithilfe des vertikalen Balkens '|' voneinander ab. Für ein Feld SUBSCRIPTION_MODEL könnten Ihre Daten für einen Benutzer beispielsweise student|monthly|discount discount.

Kategoriale Werte können maximal 1000 Zeichen enthalten. Wenn Sie einen Benutzer mit einem kategorialen Wert mit mehr als 1000 Zeichen haben, schlägt Ihr Datensatz-Importjob fehl.

Weitere Informationen zu Mindestanforderungen und maximalen Datenlimits für einen Benutzerdatensatz finden Sie unterServicekontingente.

Beispiel für ein Benutzerschema (benutzerdefiniert)

Das folgende Beispiel zeigt, wie ein Benutzerschema strukturiert wird. Das USER_ID Feld ist erforderlich und die GENDER Felder AGE und sind Metadaten. Es ist mindestens ein Metadatenfeld erforderlich, und Sie können maximal 25 Metadatenfelder hinzufügen. Informationen zu Schemaanforderungen finden Sie unterAnforderungen an benutzerdefinierte Datensätze und Schemas.

{
  "type": "record",
  "name": "Users",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
      {
          "name": "USER_ID",
          "type": "string"
      },
      {
          "name": "AGE",
          "type": "int"
      },
      {
          "name": "GENDER",
          "type": "string",
          "categorical": true
      }
  ],
  "version": "1.0"
}

Für dieses Schema könnten die ersten Zeilen mit historischen Daten in einer CSV-Datei wie folgt aussehen.

USER_ID,AGE,GENDER
5,34,Male
6,56,Female
8,65,Male
...
...