

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Set di dati e schemi personalizzati
<a name="custom-datasets-and-schemas"></a>

Quando crei un gruppo di set di dati personalizzato, crei i tuoi schemi da zero. I set di dati e gli schemi di gruppi di dati personalizzati hanno meno campi obbligatori e maggiore flessibilità. I seguenti argomenti spiegano lo schema e i requisiti di dati per i set di dati (un gruppo di set di dati personalizzato). Ogni sezione del set di dati elenca i dati richiesti per il tipo di set di dati e fornisce un esempio JSON di schema. 

Per informazioni sui tipi di dati che puoi importare in Amazon Personalize, consulta. [Tipi di dati che Amazon Personalize può utilizzare](datasets.md) Per informazioni sui requisiti generali dello schema di Amazon Personalize, come i requisiti di formattazione e i tipi di dati di campo disponibili, consulta. [Creazione di file JSON di schema per schemi Amazon Personalize](how-it-works-dataset-schema.md) Questi requisiti si applicano a tutti gli schemi Amazon Personalize.

**Topics**
+ [Requisiti per set di dati e schemi personalizzati](#dataset-requirements)
+ [Requisiti dello schema del set di dati per le interazioni tra elementi (personalizzati)](interactions-dataset-requirements.md)
+ [Requisiti dello schema del set di dati degli utenti (personalizzati)](user-dataset-requirements.md)
+ [Requisiti dello schema del set di dati degli elementi (personalizzati)](item-dataset-requirements.md)
+ [Requisiti dello schema del set di dati Actions (personalizzato)](action-dataset-requirements.md)
+ [Requisiti dello schema del set di dati sulle interazioni tra azioni (personalizzato)](action-interactions-dataset-requirements.md)

## Requisiti per set di dati e schemi personalizzati
<a name="dataset-requirements"></a>

Quando si crea un set di dati per un gruppo di set di dati personalizzato, ogni tipo di set di dati presenta i seguenti campi obbligatori e parole chiave riservate con tipi di dati obbligatori.


| Tipo di set di dati | Campi obbligatori | Parole chiave riservate | 
| --- | --- | --- | 
| [Interazioni tra elementi (esempio di schema)](interactions-dataset-requirements.md#schema-examples-interactions) | USER\_ID (`string`)<br />ITEM\_ID (`string`)<br />TIMESTAMP (`long`) | EVENT\_TYPE (`string`)<br />EVENT\_VALUE (`float`,) `null`<br />IMPRESSIONE (,) `string` `null`<br />RECOMMENDATION\_ID (,) `string` `null`<br />SORGENTE\_ATTRIBUTION\_EVENTO (,) `string` `null` | 
| Utenti (esempio di schema[)](user-dataset-requirements.md#schema-examples-users) | USER\_ID (`string`)<br />1 campo di metadati (categorico `string` o numerico) |  | 
| [Elementi (esempio di schema)](item-dataset-requirements.md#schema-examples-items) | ITEM\_ID (`string`)<br />1 campo di metadati (campo categorico o testuale o `string` campo numerico) | `long`CREATION\_TIMESTAMP () | 
| [Azioni (esempio di schema)](action-dataset-requirements.md#schema-examples-actions) | ACTION\_ID () `string`<br />1 campo di metadati (categorico o numerico) `string` | CREATION\_TIMESTAMP () `long`<br />VALORE (,`long`) `null`<br />TIPO (`string`,`null`)<br />EXPIRATION\_TIMESTAMP (,) `long` `null`<br />REPEAT\_FREQUENCY (`long`,`null`) | 
| Interazioni di azione (esempio di [schema](action-interactions-dataset-requirements.md#schema-examples-action-interactions)) | USER\_ID (`string`)<br />ACTION\_ID () `string`<br />EVENT\_TYPE (`string`)<br />TIMESTAMP (`long`) | IMPRESSIONE (,) `string` `null`<br />RECOMMENDATION\_ID (,) `string` `null` | 

### Campi di metadati
<a name="metadata-fields"></a>

I metadati includono campi stringhe o non stringhe che non sono obbligatori o che non utilizzano una parola chiave riservata. Gli schemi di metadati presentano le seguenti restrizioni: 
+ Gli schemi Users, Items e Actions richiedono almeno un campo di metadati.
+ È possibile aggiungere al massimo 25 campi di metadati per uno schema Users, 100 campi di metadati per uno schema Items e 10 campi di metadati per uno schema Actions.
+ Se aggiungi il tuo campo di metadati di tipo personale`string`, questo deve includere l'`categorical`attributo o l'attributo (solo gli schemi Items supportano i campi con l'`textual`attributo testuale). Altrimenti, Amazon Personalize non utilizzerà il campo durante l'addestramento di un modello.

### Parole chiave riservate
<a name="reserved-keywords"></a>

Le parole chiave riservate sono campi facoltativi, non contenenti metadati. Questi campi sono considerati riservati perché è necessario definire i campi come tipo di dati obbligatorio quando li si utilizza e le parole chiave non possono essere utilizzate come valori nei dati. I campi stringa categorici riservati devono essere `categorical` impostati su`true`, mentre i campi stringa riservati non possono essere categorici. Le seguenti sono parole chiave riservate:
+ EVENT\_TYPE: per i set di dati sulle interazioni tra elementi con uno o più tipi di eventi, ad esempio *clic* e *download*, utilizza un campo. `EVENT_TYPE` È necessario definire un campo EVENT\_TYPE come `string` e non può essere impostato come categorico.
+ EVENT\_VALUE: per i set di dati sulle interazioni tra elementi che includono dati di valore per gli eventi, come la percentuale di un video guardato da un utente, utilizza un `EVENT_VALUE` campo con tipo e facoltativamente. `float` `null`
+  CREATION\_TIMESTAMP: per i set di dati Items o Actions con un timestamp per la data di creazione di ogni elemento, utilizza un campo con un tipo. `CREATION_TIMESTAMP` `long` Amazon Personalize utilizza i `CREATION_TIMESTAMP` dati per calcolare l'età di un articolo e modificare i consigli di conseguenza. Per informazioni, consulta [Dati relativi al timestamp di creazione](items-datasets.md#creation-timestamp-data). 
+  IMPRESSIONE: per i set di dati sulle interazioni tra articoli e dati espliciti sulle impressioni, utilizza un `IMPRESSION` campo con tipo e, facoltativamente, digita`String`. `null` Le impressioni sono elenchi di elementi che erano visibili a un utente quando interagiva con (ad esempio, faceva clic o guardava) un particolare elemento. Per ulteriori informazioni, consulta [Dati sulle impressioni](interactions-datasets.md#interactions-impressions-data). 
+  RECOMMENDATION\_ID: per i set di dati sulle interazioni tra elementi che utilizzano consigli precedenti come dati impliciti sulle impressioni, utilizza facoltativamente un campo con tipo e facoltativamente con tipo. `RECOMMENDATION_ID` `String` `null` 

  Non è necessario aggiungere un `RECOMMENDATION_ID` campo per Amazon Personalize per utilizzare le impressioni implicite durante la generazione di consigli. Puoi eseguire un'[PutEvents](API_UBS_PutEvents.md)operazione senza `recommendationId` di essa. Per ulteriori informazioni, consulta [Dati sulle impressioni](interactions-datasets.md#interactions-impressions-data). 
+ VALORE: per i set di dati Actions, se disponi di dati validi per alcune o tutte le tue azioni, aggiungi un `VALUE` campo allo schema. Per il tipo, usa `long` e, facoltativamente, digita. `null` Per ulteriori informazioni sulle azioni e sul loro valore, vedere[Value data (Dati valore)](actions-datasets.md#action-value-data). 
+ ACTION\_EXPIRATION\_TIMESTAMP: per i set di dati Actions, se hai un timestamp di scadenza per alcune o tutte le tue azioni, aggiungi un campo allo schema. `ACTION_EXPIRATION_TIMESTAMP` Per il tipo, usa e`long`, facoltativamente, digita. `null` Per ulteriori informazioni sui timestamp di scadenza, vedere. [Dati relativi al timestamp di scadenza dell'azione](actions-datasets.md#action-expiration-timestamp-data) 
+ REPEAT\_FREQUENCY: per i set di dati Actions, se disponi di dati sulla frequenza di ripetizione per alcune o tutte le tue azioni, aggiungi un `REPEAT_FREQUENCY` campo allo schema. Per il tipo, usa `long` e, facoltativamente, digita. `null` Per ulteriori informazioni sui dati relativi alla frequenza di ripetizione, vedere[Ripeti i dati sulla frequenza](actions-datasets.md#action-repeat-frequency). 