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à.

# Requisiti dello schema del set di dati per le interazioni tra elementi (personalizzati)
<a name="interactions-dataset-requirements"></a>

Un *set di dati sulle interazioni tra articoli* archivia i dati storici e in tempo reale delle interazioni tra utenti e articoli del catalogo. Per informazioni sui tipi di dati di interazione che Amazon Personalize può utilizzare, consulta. [Dati di interazione tra gli articoli](interactions-datasets.md)

 I dati forniti per ogni interazione devono corrispondere al tuo schema. A seconda dello schema, i metadati di interazione possono includere valori vuoti/nulli. È necessario fornire almeno quanto segue per ogni interazione: 
+ ID utente
+ ID dell'articolo
+ Timestamp (nel formato orario Unix Epoch)

Sei libero di aggiungere campi aggiuntivi a seconda del tuo caso d'uso e dei tuoi dati. Finché i campi non sono elencati come obbligatori o riservati e i tipi di dati sono elencati[Tipi di dati dello schema](how-it-works-dataset-schema.md#personalize-datatypes), i nomi dei campi e i tipi di dati sono a tua discrezione.

 Il numero totale massimo di campi di metadati opzionali che puoi aggiungere a un set di dati sulle interazioni tra elementi, combinato con il numero totale di tipi di eventi *distinti* nei dati di interazione degli elementi, è 10. I campi di metadati inclusi in questo conteggio sono i campi EVENT\_TYPE, EVENT\_VALUE insieme a tutti i campi di metadati personalizzati aggiunti allo schema. Il numero massimo di campi di metadati esclusi i campi riservati, come IMPRESSION, è 5. I valori categoriali possono contenere al massimo 1000 caratteri. Se hai un'interazione con un valore categorico superiore a 1000, il processo di importazione del set di dati avrà esito negativo. 

Per ulteriori informazioni sui requisiti minimi e sui limiti massimi di dati per un set di dati sulle interazioni tra elementi, consulta. [Service Quotas](limits.md#limits-table) 

## Esempio di schema di interazioni (personalizzato)
<a name="schema-examples-interactions"></a>

L'esempio seguente mostra uno schema per un set di dati sulle interazioni tra elementi. I campi `USER_ID`, `ITEM_ID` e `TIMESTAMP` sono obbligatori. I `IMPRESSION` campi `EVENT_TYPE``EVENT_VALUE`, e sono parole chiave riservate facoltative riconosciute da Amazon Personalize. EVENT\_TYPE deve essere di tipo string e non può essere categorico. `LOCATION`e `DEVICE` sono campi di metadati contestuali opzionali. Per informazioni sui requisiti dello schema, vedere. [Requisiti per set di dati e schemi personalizzati](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"
}
```

Per questo schema, le prime righe di dati storici in un file CSV potrebbero avere l'aspetto seguente. Nota che alcuni valori per EVENT\_VALUE sono nulli.

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