Anforderungen an das Aktions-Dataset-Schema (benutzerdefiniert)

Eine Aktion ist eine Interaktionsaktivität, die Sie Ihren Kunden vielleicht empfehlen möchten. Zu den Aktionen können die Installation Ihrer mobilen App, das Ausfüllen eines Mitgliedsprofils, die Teilnahme an Ihrem Treueprogramm oder die Anmeldung für Werbe-E-Mails gehören. Ein Aktionen-Datensatz speichert Daten über Ihre Aktionen. Informationen zu den Arten von Aktionsdaten, die Sie in Amazon Personalize importieren können, finden Sie unterDatensatz „Aktionen“.

Die Daten, die Sie für jede Aktion angeben, müssen Ihrem Aktions-Datensatzschema entsprechen. Abhängig von Ihrem Schema können Aktionsmetadaten leere/Nullwerte enthalten.

Sie müssen mindestens eine Aktions-ID für jedes Element angeben (maximale Länge 256 Zeichen). Ihr Schema muss mindestens ein Metadatenfeld enthalten. Wenn Sie jedoch einen null Typ hinzufügen, kann dieser Wert für die Aktion Null sein. Abhängig von Ihrem Anwendungsfall und Ihren Daten können Sie zusätzliche Felder hinzufügen. Sie können die Feldnamen und Datentypen auswählen, sofern die Felder nicht als erforderlich oder reserviert aufgeführt sind und die Datentypen unter aufgeführt sindSchema-Datentypen.

Um ein kategoriales Feld hinzuzufügen, 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 Aktionen auf. Kategorische Werte können maximal 1000 Zeichen lang sein. Wenn Sie eine Aktion 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 Actions-Datensatz finden Sie unterServicekontingente.

Beispiel für ein Aktions-Dataset-Schema (benutzerdefiniert)

Das folgende Beispiel zeigt, wie ein Actions-Schema strukturiert wird. Das Feld ACTION_ID ist ein Pflichtfeld. Das MEMBERSHIP_LEVEL Feld ist ein kategoriales Zeichenfolgenfeld. Die REPEAT_FREQUENCY Felder VALUECREATION_TIMESTAMP, und sind reservierte Schlüsselwörter mit den erforderlichen Typen. Sie können maximal 10 Spalten hinzufügen. Informationen zu Schemaanforderungen finden Sie unterAnforderungen an benutzerdefinierte Datensätze und Schemas.

{
  "type": "record",
  "name": "Actions",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
    {
      "name": "ACTION_ID",
      "type": "string"
    },
    {
      "name": "VALUE",
      "type": [
        "null",
        "long"
      ]
    },
    
    {
      "name": "MEMBERSHIP_LEVEL",
      "type": [
        "null",
        "string"
      ],
      "categorical": true
    },
    
    {
      "name": "CREATION_TIMESTAMP",
      "type": "long"
    },
    {
      "name": "REPEAT_FREQUENCY",
      "type": [
        "long",
        "null"
      ]
    }
  ],
  "version": "1.0"
}

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

ACTION_ID,VALUE,MEMBERSHIP_LEVEL,CREATION_TIMESTAMP,REPEAT_FREQUENCY
1,10,Deluxe|Premium,1510003267,7
2,5,Basic,1580003267,7
3,5,Preview,1590003267,3
4,10,Deluxe|Platinum,1560003267,4
...
...