Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Persyaratan skema kumpulan data interaksi item (khusus)
<a name="interactions-dataset-requirements"></a>

Kumpulan data *interaksi Item menyimpan data* historis dan waktu nyata dari interaksi antara pengguna dan item di katalog Anda. Untuk informasi tentang jenis data interaksi yang dapat digunakan Amazon Personalize, lihat. [Data interaksi item](interactions-datasets.md)

 Data yang Anda berikan untuk setiap interaksi harus sesuai dengan skema Anda. Bergantung pada skema Anda, metadata interaksi dapat menyertakan nilai kosong/nol. Minimal, Anda harus memberikan yang berikut untuk setiap interaksi: 
+ ID Pengguna
+ ID Barang
+ Stempel waktu (dalam format waktu zaman Unix)

Anda bebas menambahkan bidang tambahan tergantung pada kasus penggunaan dan data Anda. Selama bidang tidak terdaftar sebagai wajib atau dicadangkan, dan tipe data dicantumkan[Jenis data skema](how-it-works-dataset-schema.md#personalize-datatypes), nama bidang dan tipe data terserah Anda.

 Jumlah total maksimum bidang metadata opsional yang dapat Anda tambahkan ke kumpulan data interaksi Item, dikombinasikan dengan jumlah total jenis peristiwa *berbeda* dalam data interaksi Item Anda, adalah 10. Bidang metadata yang disertakan dalam hitungan ini adalah bidang EVENT\$1TYPE, EVENT\$1VALUE bersama dengan bidang metadata kustom yang Anda tambahkan ke skema Anda. Jumlah maksimum bidang metadata yang tidak termasuk bidang cadangan, seperti IMPRESSION, adalah 5. Nilai kategoris dapat memiliki paling banyak 1000 karakter. Jika Anda memiliki interaksi dengan nilai kategoris dengan lebih dari 1000, pekerjaan impor dataset Anda akan gagal. 

Untuk informasi lebih lanjut tentang persyaratan minimum dan batas data maksimum untuk kumpulan data interaksi Item, lihat[Kuota layanan](limits.md#limits-table). 

## Contoh skema interaksi (kustom)
<a name="schema-examples-interactions"></a>

Contoh berikut menunjukkan skema untuk kumpulan data interaksi Item. `TIMESTAMP`Bidang `USER_ID``ITEM_ID`,, dan diperlukan. `IMPRESSION`Bidang`EVENT_TYPE`,`EVENT_VALUE`, dan adalah kata kunci cadangan opsional yang diakui oleh Amazon Personalize. EVENT\$1TYPE harus bertipe string dan tidak bisa kategoris. `LOCATION`dan `DEVICE` merupakan bidang metadata kontekstual opsional. Untuk informasi tentang persyaratan skema, lihat[Dataset kustom dan persyaratan skema](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"
}
```

Untuk skema ini, beberapa baris pertama data historis dalam file CSV mungkin terlihat seperti berikut. Perhatikan bahwa beberapa nilai untuk EVENT\$1VALUE adalah null.

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