

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\$1ID (`string`) ITEM\$1ID (`string`) TIMESTAMP (`long`)  |  EVENT\$1TYPE (`string`) EVENT\$1VALUE (`float`,) `null` IMPRESSIONE (,) `string` `null` RECOMMENDATION\$1ID (,) `string` `null` SORGENTE\$1ATTRIBUTION\$1EVENTO (,) `string` `null`  | 
| Utenti (esempio di schema[)](user-dataset-requirements.md#schema-examples-users) |  USER\$1ID (`string`) 1 campo di metadati (categorico `string` o numerico)  |  | 
| [Elementi (esempio di schema)](item-dataset-requirements.md#schema-examples-items) |  ITEM\$1ID (`string`) 1 campo di metadati (campo categorico o testuale o `string` campo numerico)  |  `long`CREATION\$1TIMESTAMP ()  | 
| [Azioni (esempio di schema)](action-dataset-requirements.md#schema-examples-actions) |  ACTION\$1ID () `string` 1 campo di metadati (categorico o numerico) `string`  |  CREATION\$1TIMESTAMP () `long` VALORE (,`long`) `null` TIPO (`string`,`null`) EXPIRATION\$1TIMESTAMP (,) `long` `null` REPEAT\$1FREQUENCY (`long`,`null`)  | 
| Interazioni di azione (esempio di [schema](action-interactions-dataset-requirements.md#schema-examples-action-interactions)) |  USER\$1ID (`string`) ACTION\$1ID () `string` EVENT\$1TYPE (`string`) TIMESTAMP (`long`)  |  IMPRESSIONE (,) `string` `null` RECOMMENDATION\$1ID (,) `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\$1TYPE: 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\$1TYPE come `string` e non può essere impostato come categorico.
+ EVENT\$1VALUE: 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\$1TIMESTAMP: 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\$1ID: 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\$1EXPIRATION\$1TIMESTAMP: 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\$1FREQUENCY: 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). 

# 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\$1TYPE, EVENT\$1VALUE 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\$1TYPE 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\$1VALUE 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
...
...
```

# Requisiti dello schema del set di dati degli utenti (personalizzati)
<a name="user-dataset-requirements"></a>

 Un *set di dati Users memorizza* i metadati sui tuoi utenti. Ciò potrebbe includere informazioni come età, sesso e iscrizione al programma fedeltà per ciascun articolo. Per informazioni sui tipi di dati utente che puoi importare in Amazon Personalize, consulta. [Metadati utente](users-datasets.md) 

 I dati che fornisci per ogni utente devono corrispondere al tuo schema. È necessario fornire almeno un ID utente per ogni utente (lunghezza massima 256 caratteri). A seconda dello schema, i metadati utente possono includere empty/null valori. Lo schema Users deve avere almeno un campo di metadati, ma se aggiungi un `null` tipo, questo valore può essere nullo per l'utente. 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.

 Per utilizzare dati categorici, aggiungi un campo di tipo `string` e imposta l'attributo categorico del campo su `true` nel tuo schema. Quindi includi i dati categorici nel tuo file CSV di massa e nelle importazioni di singoli record. Per gli utenti con più categorie, separa ogni valore utilizzando la barra verticale '\$1'. Ad esempio, per un campo SUBSCRIPTION\$1MODEL, i dati per un utente potrebbero essere student\$1monthly\$1discount. 

I valori categoriali possono contenere al massimo 1000 caratteri. Se hai un utente con un valore categorico con più di 1000 caratteri, 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 Users, consulta. [Service Quotas](limits.md#limits-table) 

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

L'esempio seguente mostra come strutturare uno schema Users. Il `USER_ID` campo è obbligatorio e i `GENDER` campi `AGE` e sono metadati. È obbligatorio almeno un campo di metadati ed è possibile aggiungere al massimo 25 campi di metadati. 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": "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"
}
```

Per questo schema, le prime righe di dati storici in un file CSV potrebbero avere l'aspetto seguente.

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

# Requisiti dello schema del set di dati degli elementi (personalizzati)
<a name="item-dataset-requirements"></a>

 Un *set di dati Items* memorizza i metadati relativi ai tuoi articoli nel tuo catalogo. Ciò potrebbe includere informazioni come prezzo, genere e disponibilità per ogni articolo. Per informazioni sui tipi di dati sugli articoli che puoi importare in Amazon Personalize, consulta. [Metadati degli articoli](items-datasets.md) 

 I dati forniti per ogni articolo devono corrispondere allo schema del set di dati Items. Come minimo, devi fornire un ID articolo per ogni articolo (lunghezza massima 256 caratteri). A seconda dello schema, i metadati degli elementi possono includere empty/null valori. Lo schema deve avere almeno un campo di metadati, ma se aggiungi un `null` tipo, questo valore può essere nullo per l'elemento. 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. 

 Per utilizzare dati categorici, aggiungi un campo di tipo `string` e imposta l'attributo categorico del campo su `true` nel tuo schema. Quindi includi i dati categorici nel tuo file CSV di massa e nelle importazioni di singoli articoli. I valori categoriali possono contenere al massimo 1000 caratteri. Se hai un elemento con un valore categorico con più di 1000 caratteri, il processo di importazione del set di dati avrà esito negativo.

 Per gli elementi con più categorie, separa ogni valore con la barra verticale '\$1'. Ad esempio, per un campo GENRES i tuoi dati per un elemento potrebbero essere. `Action|Crime|Biopic` Se disponi di più livelli di dati categoriali e alcuni elementi hanno più categorie per ogni livello della gerarchia, aggiungi un campo per ogni livello e aggiungi un indicatore di livello dopo ogni nome di campo: GENRES, GENRE\$1L2, GENRE\$1L3. In questo modo puoi filtrare i consigli in base alle sottocategorie, anche se un elemento appartiene a più categorie a più livelli (per informazioni sulla creazione e l'utilizzo dei filtri, vedi). [Suggerimenti di filtraggio e segmenti di utenti](filter.md) Ad esempio, un video potrebbe contenere i seguenti dati per ogni livello di categoria: 
+ GENERI: Azione\$1Avventura
+ GENERE\$1L2: Crimine\$1Western
+ GENERE\$1L3: Biopic

In questo esempio, il video si trova nella gerarchia azione > crimine > biopic *e* nella gerarchia avventura > western > biopic. Si consiglia di utilizzare solo fino a L3, ma è possibile utilizzare più livelli se necessario.

Durante la formazione sui modelli, Amazon Personalize prende in considerazione un massimo di 750.000 articoli. Se importi più di 750.000 articoli, Amazon Personalize decide quali articoli includere nella formazione, con particolare attenzione all'inclusione di nuovi articoli (articoli aggiunti di recente senza interazioni) e articoli esistenti con dati sulle interazioni recenti.

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

## Esempio di schema del set di dati Items (personalizzato)
<a name="schema-examples-items"></a>

L'esempio seguente mostra come strutturare uno schema Items. Il campo `ITEM_ID` è obbligatorio. Il `GENRE` campo è costituito da metadati categorici e il `DESCRIPTION` campo è da metadati testuali. È richiesto almeno un campo di metadati. Puoi aggiungere un massimo di 100 campi di metadati. Il `CREATION_TIMESTAMP` campo è una parola chiave riservata. 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": "Items",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
    {
      "name": "ITEM_ID",
      "type": "string"
    },
    {
      "name": "GENRES",
      "type": [
        "null",
        "string"
      ],
      "categorical": true
    },
    {
      "name": "CREATION_TIMESTAMP",
      "type": "long"
    },
    {
      "name": "DESCRIPTION",
      "type": [
        "null",
        "string"
      ],
      "textual": true
    }
  ],
  "version": "1.0"
}
```

Per questo schema, le prime righe di dati storici in un file CSV potrebbero avere l'aspetto seguente.

```
ITEM_ID,GENRES,CREATION_TIMESTAMP,DESCRIPTION
1,Adventure|Animation|Children|Comedy|Fantasy,1570003267,"This is an animated movie that features action, comedy, and fantasy. Audience is children. This movie was released in 2004."
2,Adventure|Children|Fantasy,1571730101,"This is an adventure movie with elements of fantasy. Audience is children. This movie was release in 2010."
3,Comedy|Romance,1560515629,"This is a romantic comedy. The movie was released in 1999. Audience is young women."
4,Comedy|Drama|Romance,1581670067,"This movie includes elements of both comedy and drama as well as romance. This movie was released in 2020."
...
...
```

# Requisiti dello schema del set di dati Actions (personalizzato)
<a name="action-dataset-requirements"></a>

Un'*azione* è un'attività di coinvolgimento che potresti consigliare ai tuoi clienti. Le azioni possono includere l'installazione dell'app per dispositivi mobili, il completamento di un profilo di iscrizione, l'iscrizione al programma fedeltà o l'iscrizione a e-mail promozionali. Un *set di dati Actions* memorizza i dati sulle tue azioni. Per informazioni sui tipi di dati di azione che puoi importare in Amazon Personalize, consulta. [Metadati delle azioni](actions-datasets.md) 

 I dati forniti per ogni azione devono corrispondere allo schema del set di dati Actions. A seconda dello schema, i metadati delle azioni possono includere empty/null valori. 

Come minimo, devi fornire un Action ID per ogni elemento (lunghezza massima 256 caratteri). Lo schema deve avere almeno un campo di metadati, ma se aggiungi un `null` tipo, questo valore può essere nullo per l'azione. Puoi aggiungere campi aggiuntivi a seconda del tuo caso d'uso e dei tuoi dati. Puoi scegliere i nomi dei campi e i tipi di dati a meno che i campi non siano elencati come obbligatori o riservati e i tipi di dati non siano elencati in[Tipi di dati dello schema](how-it-works-dataset-schema.md#personalize-datatypes). 

 Per aggiungere un campo categorico, aggiungi un campo di tipo `string` e imposta l'attributo categorico del campo su `true` nel tuo schema. Quindi includi i dati categorici nel tuo file CSV di massa e nelle importazioni di azioni individuali. I valori categoriali possono contenere al massimo 1000 caratteri. Se hai un'azione con un valore categorico con più di 1000 caratteri, 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 Actions, consulta. [Service Quotas](limits.md#limits-table)

## Esempio di schema del set di dati Actions (personalizzato)
<a name="schema-examples-actions"></a>

L'esempio seguente mostra come strutturare uno schema Actions. Il campo `ACTION_ID` è obbligatorio. Il `MEMBERSHIP_LEVEL` campo è un campo di stringa categorico. I `REPEAT_FREQUENCY` campi `VALUE``CREATION_TIMESTAMP`, e sono parole chiave riservate con i tipi obbligatori. È possibile aggiungere un massimo di 10 colonne. 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": "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"
}
```

Per questo schema, le prime righe di dati storici in un file CSV potrebbero avere l'aspetto seguente.

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

# Requisiti dello schema del set di dati sulle interazioni tra azioni (personalizzato)
<a name="action-interactions-dataset-requirements"></a>

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

 I dati forniti per ogni interazione devono corrispondere al tuo schema. A seconda dello schema, i metadati di interazione possono includere empty/null valori. Lo schema deve includere almeno quanto segue: 
+ USER\$1ID
+ ACTION\$1ID
+ TIMESTAMP
+ EVENT\$1TYPE

Puoi aggiungere campi aggiuntivi a seconda del tuo caso d'uso e dei tuoi dati. Puoi scegliere i nomi dei campi e i tipi di dati a meno che i campi non siano elencati come obbligatori o riservati e i tipi di dati non siano elencati in[Tipi di dati dello schema](how-it-works-dataset-schema.md#personalize-datatypes).

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

## Esempio di schema del set di dati sulle interazioni d'azione (personalizzato)
<a name="schema-examples-action-interactions"></a>

L'esempio seguente mostra uno schema per un set di dati di interazioni Action con solo i campi obbligatori. Per informazioni sui requisiti generali di formattazione dello schema, vedere. [Requisiti di formattazione dello schema](how-it-works-dataset-schema.md#general-schema-requirements) 

```
{

  "type": "record",
  "name": "ActionInteractions",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
      {
          "name": "USER_ID",
          "type": "string"
      },
      {
          "name": "ACTION_ID",
          "type": "string"
      },
      {
          "name": "EVENT_TYPE",
          "type": "string"
      },
      {
          "name": "TIMESTAMP",
          "type": "long"
      }
  ],
  "version": "1.0"
}
```

Per questo schema, le prime righe di dati storici in un file CSV potrebbero avere l'aspetto seguente.

```
USER_ID,ACTION_ID,EVENT_TYPE,TIMESTAMP
35,73,Viewed,1586731606
54,35,Not taken,1586731609
9,33,Viewed,1586735158
23,10,Taken,1586735697
27,11,Taken,1586735763
...
...
```