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

# Kumpulan data dan skema khusus
<a name="custom-datasets-and-schemas"></a>

Saat membuat grup kumpulan data Kustom, Anda membuat skema sendiri dari awal. Kumpulan data dan skema grup kumpulan data khusus memiliki lebih sedikit bidang yang diperlukan dan lebih banyak fleksibilitas. Topik berikut menjelaskan skema dan persyaratan data untuk kumpulan data grup kumpulan data Kustom. Setiap bagian kumpulan data mencantumkan data yang diperlukan untuk jenis kumpulan data dan memberikan contoh skema JSON. 

Untuk informasi tentang jenis data yang dapat Anda impor ke Amazon Personalize, lihat. [Jenis data yang dapat digunakan Amazon Personalize](datasets.md) Untuk informasi tentang persyaratan skema Amazon Personalisasi umum, seperti persyaratan pemformatan dan tipe data bidang yang tersedia, lihat. [Membuat file JSON skema untuk skema Amazon Personalize](how-it-works-dataset-schema.md) Persyaratan ini berlaku untuk semua skema Amazon Personalize.

**Topics**
+ [Dataset kustom dan persyaratan skema](#dataset-requirements)
+ [Persyaratan skema kumpulan data interaksi item (khusus)](interactions-dataset-requirements.md)
+ [Persyaratan skema kumpulan data pengguna (kustom)](user-dataset-requirements.md)
+ [Persyaratan skema dataset item (kustom)](item-dataset-requirements.md)
+ [Persyaratan skema kumpulan data tindakan (kustom)](action-dataset-requirements.md)
+ [Persyaratan skema kumpulan data interaksi tindakan (kustom)](action-interactions-dataset-requirements.md)

## Dataset kustom dan persyaratan skema
<a name="dataset-requirements"></a>

Saat Anda membuat kumpulan data untuk grup kumpulan data Kustom, setiap jenis kumpulan data memiliki bidang wajib berikut dan kata kunci cadangan dengan tipe data yang diperlukan.


| Jenis dataset | Bidang wajib | Kata kunci terpesan | 
| --- | --- | --- | 
| Interaksi item ([contoh skema](interactions-dataset-requirements.md#schema-examples-interactions)) | USER\_ID () `string`<br />ITEM\_ID () `string`<br />STEMPEL WAKTU () `long` | EVENT\_TYPE () `string`<br />EVENT\_VALUE (,) `float` `null`<br />KESAN (`string`,`null`)<br />REKOMENDASI\_ID (,) `string` `null`<br />EVENT\_ATTRIBUTION\_SOURCE (,) `string` `null` | 
| Pengguna ([contoh skema](user-dataset-requirements.md#schema-examples-users)) | USER\_ID () `string`<br />1 bidang metadata (kategoris `string` atau numerik) |  | 
| Item ([contoh skema](item-dataset-requirements.md#schema-examples-items)) | ITEM\_ID () `string`<br />1 bidang metadata (bidang kategoris atau `string` tekstual atau bidang numerik) | CREATION\_TIMESTAMP () `long` | 
| Tindakan ([contoh skema](action-dataset-requirements.md#schema-examples-actions)) | ACTION\_ID () `string`<br />1 bidang metadata (kategoris `string` atau numerik) | CREATION\_TIMESTAMP () `long`<br />NILAI (`long`,`null`)<br />JENIS (`string`,`null`)<br />EXPIRATION\_TIMESTAMP (,) `long` `null`<br />REPEAT\_FREKUENSI (`long`,) `null` | 
| Interaksi aksi ([contoh skema](action-interactions-dataset-requirements.md#schema-examples-action-interactions)) | USER\_ID () `string`<br />ACTION\_ID () `string`<br />EVENT\_TYPE () `string`<br />STEMPEL WAKTU () `long` | KESAN (`string`,`null`)<br />REKOMENDASI\_ID (,) `string` `null` | 

### Kolom metadata
<a name="metadata-fields"></a>

Metadata mencakup bidang string atau non-string yang tidak diperlukan atau tidak menggunakan kata kunci cadangan. Skema metadata memiliki batasan berikut: 
+ Skema Pengguna, Item, dan Tindakan memerlukan setidaknya satu bidang metadata.
+ Anda dapat menambahkan paling banyak 25 bidang metadata untuk skema Pengguna, 100 bidang metadata untuk skema Item, dan 10 bidang metadata untuk skema Tindakan.
+ Jika Anda menambahkan bidang metadata Anda sendiri dari tipe`string`, itu harus menyertakan `categorical` atribut atau `textual` atribut (hanya skema Item yang mendukung bidang dengan atribut tekstual). Jika tidak, Amazon Personalize tidak akan menggunakan bidang saat melatih model.

### Kata kunci terpesan
<a name="reserved-keywords"></a>

Kata kunci yang dicadangkan adalah opsional, bidang non-metadata. Bidang ini dianggap dicadangkan karena Anda harus menentukan bidang sebagai tipe data yang diperlukan saat Anda menggunakannya, dan kata kunci tidak dapat digunakan sebagai nilai dalam data Anda. Bidang string kategoris yang dicadangkan harus `categorical` disetel ke`true`, sementara bidang string yang dicadangkan tidak dapat dikategorikan. Berikut ini adalah kata kunci yang dicadangkan:
+ EVENT\_TYPE: Untuk kumpulan data interaksi Item dengan satu atau beberapa jenis acara, seperti *klik* dan *unduh*, gunakan bidang. `EVENT_TYPE` Anda harus mendefinisikan bidang EVENT\_TYPE sebagai `string` dan tidak dapat diatur sebagai kategoris.
+ EVENT\_VALUE: Untuk kumpulan data interaksi Item yang menyertakan data nilai untuk peristiwa, seperti persentase video yang ditonton pengguna, gunakan `EVENT_VALUE` bidang dengan tipe dan opsional. `float` `null`
+  CREATION\_TIMESTAMP: Untuk kumpulan data Item atau Tindakan dengan stempel waktu untuk tanggal pembuatan setiap item, gunakan bidang dengan tipe. `CREATION_TIMESTAMP` `long` Amazon Personalize menggunakan `CREATION_TIMESTAMP` data untuk menghitung usia item dan menyesuaikan rekomendasi yang sesuai. Lihat [Data stempel waktu pembuatan](items-datasets.md#creation-timestamp-data). 
+  IMPRESSION: Untuk kumpulan data interaksi Item dengan data tayangan eksplisit, gunakan `IMPRESSION` bidang dengan tipe `String` dan tipe opsional. `null` Tayangan adalah daftar item yang terlihat oleh pengguna saat berinteraksi dengan (misalnya, diklik atau ditonton) item tertentu. Untuk informasi selengkapnya, lihat [Data tayangan](interactions-datasets.md#interactions-impressions-data). 
+  RECOMMENTATION\_ID: Untuk kumpulan data interaksi Item yang menggunakan rekomendasi sebelumnya sebagai data tayangan implisit, secara opsional gunakan bidang dengan tipe dan tipe opsional. `RECOMMENDATION_ID` `String` `null` 

  Anda tidak perlu menambahkan `RECOMMENDATION_ID` bidang untuk Amazon Personalize untuk menggunakan tayangan implisit saat membuat rekomendasi. Anda dapat lulus `recommendationId` dalam [PutEvents](API_UBS_PutEvents.md) operasi tanpa itu. Untuk informasi selengkapnya, lihat [Data tayangan](interactions-datasets.md#interactions-impressions-data). 
+ NILAI: Untuk kumpulan data Tindakan, jika Anda memiliki nilai data untuk beberapa atau semua tindakan Anda, tambahkan `VALUE` bidang ke skema Anda. Untuk jenisnya, gunakan `long` dan ketik `null` opsional. Untuk informasi selengkapnya tentang tindakan dan nilainya, lihat[Data nilai](actions-datasets.md#action-value-data). 
+ ACTION\_EXPIRATION\_TIMESTAMP: Untuk kumpulan data Tindakan, jika Anda memiliki stempel waktu kedaluwarsa untuk beberapa atau semua tindakan Anda, tambahkan bidang ke skema Anda. `ACTION_EXPIRATION_TIMESTAMP` Untuk jenisnya, gunakan `long` dan ketik `null` opsional. Untuk informasi selengkapnya tentang cap waktu kedaluwarsa, lihat. [Data stempel waktu kedaluwarsa tindakan](actions-datasets.md#action-expiration-timestamp-data) 
+ REPEAT\_FREQUENCY: Untuk kumpulan data Tindakan, jika Anda memiliki data frekuensi berulang untuk beberapa atau semua tindakan Anda, tambahkan `REPEAT_FREQUENCY` bidang ke skema Anda. Untuk jenisnya, gunakan `long` dan ketik `null` opsional. Untuk informasi selengkapnya tentang data frekuensi berulang, lihat[Ulangi data frekuensi](actions-datasets.md#action-repeat-frequency).