Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Ensembles de données et schémas personnalisés
Lorsque vous créez un groupe de jeux de données personnalisé, vous créez vos propres schémas à partir de zéro. Les ensembles de données et les schémas de groupes de jeux de données personnalisés comportent moins de champs obligatoires et offrent une plus grande flexibilité. Les rubriques suivantes expliquent le schéma et les exigences en matière de données pour les ensembles de données d'un groupe de jeux de données personnalisé. Chaque section du jeu de données répertorie les données requises pour le type d'ensemble de données et fournit un exemple de schéma JSON.
Pour plus d'informations sur les types de données que vous pouvez importer dans Amazon Personalize, consultez[Types de données qu'Amazon Personalize peut utiliser](datasets.md). Pour plus d'informations sur les exigences générales du schéma Amazon Personalize, telles que les exigences de mise en forme et les types de données de champ disponibles, consultez[Création de fichiers JSON pour les schémas Amazon Personalize](how-it-works-dataset-schema.md). Ces exigences s'appliquent à tous les schémas Amazon Personalize.
**Topics**
+ [Exigences relatives aux ensembles de données et aux schémas personnalisés](#dataset-requirements)
+ [Exigences relatives au schéma du jeu de données sur les interactions entre articles (personnalisé)](interactions-dataset-requirements.md)
+ [Exigences relatives au schéma du jeu de données utilisateur (personnalisé)](user-dataset-requirements.md)
+ [Exigences relatives au schéma du jeu de données d'articles (personnalisé)](item-dataset-requirements.md)
+ [Exigences relatives au schéma du jeu de données Actions (personnalisé)](action-dataset-requirements.md)
+ [Exigences relatives au schéma du jeu de données Action Interactions (personnalisé)](action-interactions-dataset-requirements.md)
## Exigences relatives aux ensembles de données et aux schémas personnalisés
Lorsque vous créez un ensemble de données pour un groupe de jeux de données personnalisé, chaque type de jeu de données comporte les champs obligatoires et les mots clés réservés suivants avec les types de données requis.
| Type d'ensemble de données | Champs obligatoires | Mots-clés réservés |
| --- | --- | --- |
| Interactions entre éléments ([exemple de schéma](interactions-dataset-requirements.md#schema-examples-interactions)) | USER\_ID (`string`)
ITEM\_ID (`string`)
TIMESTAMP (`long`) | EVENT\_TYPE (`string`)
VALEUR\_ÉVÉNEMENT (,) `float` `null`
IMPRESSION (`string`,`null`)
IDENTIFIANT DE RECOMMANDATION (,) `string` `null`
SOURCE D'ATTRIBUTION DE L'ÉVÉNEMENT (,) `string` `null` |
| Utilisateurs ([exemple de schéma](user-dataset-requirements.md#schema-examples-users)) | USER\_ID (`string`)
1 champ de métadonnées (catégorique `string` ou numérique) | |
| Éléments ([exemple de schéma](item-dataset-requirements.md#schema-examples-items)) | ITEM\_ID (`string`)
1 champ de métadonnées (champ catégorique ou textuel ou `string` champ numérique) | HORODATAGE DE CRÉATION () `long` |
| Actions ([exemple de schéma](action-dataset-requirements.md#schema-examples-actions)) | IDENTIFIANT DE L'ACTION () `string`
1 champ de métadonnées (catégorique `string` ou numérique) | HORODATAGE DE CRÉATION () `long`
VALEUR (`long`,`null`)
TAPEZ (`string`,`null`)
HORODATAGE D'EXPIRATION (,) `long` `null`
FRÉQUENCE DE RÉPÉTITION (,) `long` `null` |
| Interactions entre les actions ([exemple de schéma](action-interactions-dataset-requirements.md#schema-examples-action-interactions)) | USER\_ID (`string`)
IDENTIFIANT DE L'ACTION () `string`
EVENT\_TYPE (`string`)
TIMESTAMP (`long`) | IMPRESSION (`string`,`null`)
IDENTIFIANT DE RECOMMANDATION (,) `string` `null` |
### Champs de métadonnées
Les métadonnées incluent des champs sous forme de chaîne ou non sous forme de chaîne qui ne sont pas obligatoires ou qui n'utilisent pas de mot clé réservé. Les schémas de métadonnées sont soumis aux restrictions suivantes :
+ Les schémas d'utilisateurs, d'éléments et d'actions nécessitent au moins un champ de métadonnées.
+ Vous pouvez ajouter au maximum 25 champs de métadonnées pour un schéma Users, 100 champs de métadonnées pour un schéma Items et 10 champs de métadonnées pour un schéma Actions.
+ Si vous ajoutez votre propre champ de métadonnées de type`string`, il doit inclure l'`categorical`attribut ou l'`textual`attribut (seuls les schémas Items prennent en charge les champs avec l'attribut textuel). Sinon, Amazon Personalize n'utilisera pas le champ lors de la formation d'un modèle.
### Mots-clés réservés
Les mots clés réservés sont des champs facultatifs qui ne sont pas des champs de métadonnées. Ces champs sont considérés comme réservés car vous devez définir les champs comme leur type de données obligatoire lorsque vous les utilisez, et les mots clés ne peuvent pas être utilisés comme valeurs dans vos données. Les champs de chaîne catégorielle réservés doivent être `categorical` définis sur`true`, tandis que les champs de chaîne réservés ne peuvent pas être catégoriques. Les mots clés suivants sont réservés :
+ EVENT\_TYPE : pour les ensembles de données d'interactions entre éléments comportant un ou plusieurs types d'événements, tels que le *clic* et le *téléchargement*, utilisez un champ. `EVENT_TYPE` Vous devez définir un champ EVENT\_TYPE comme un champ `string` et ne pouvez pas être défini comme catégorique.
+ EVENT\_VALUE : pour les ensembles de données d'interactions entre éléments qui incluent des données de valeur relatives à des événements, telles que le pourcentage d'une vidéo regardée par un utilisateur, utilisez un `EVENT_VALUE` champ avec un type `float` et éventuellement. `null`
+ CREATION\_TIMESTAMP : pour les ensembles de données d'éléments ou d'actions avec un horodatage pour la date de création de chaque élément, utilisez un champ avec un type. `CREATION_TIMESTAMP` `long` Amazon Personalize utilise `CREATION_TIMESTAMP` les données pour calculer l'âge d'un article et ajuster les recommandations en conséquence. Consultez [Données d'horodatage de création](items-datasets.md#creation-timestamp-data).
+ IMPRESSION : Pour les ensembles de données d'interactions entre articles contenant des données d'impressions explicites, utilisez un `IMPRESSION` champ avec un type `String` et éventuellement un type`null`. Les impressions sont des listes d'éléments visibles par un utilisateur lorsqu'il interagissait avec un élément en particulier (par exemple, en cliquant ou en regardant). Pour de plus amples informations, veuillez consulter [Données sur les impressions](interactions-datasets.md#interactions-impressions-data).
+ RECOMMENDATION\_ID : pour les ensembles de données d'interactions entre articles qui utilisent les recommandations précédentes comme données d'impressions implicites, utilisez éventuellement un `RECOMMENDATION_ID` champ avec type et éventuellement type`String`. `null`
Il n'est pas nécessaire d'ajouter un `RECOMMENDATION_ID` champ pour qu'Amazon Personalize utilise les impressions implicites lors de la génération de recommandations. Vous pouvez réussir `recommendationId` une [PutEvents](API_UBS_PutEvents.md) opération sans elle. Pour de plus amples informations, veuillez consulter [Données sur les impressions](interactions-datasets.md#interactions-impressions-data).
+ VALEUR : pour les ensembles de données Actions, si vous disposez de données de valeur pour certaines ou toutes vos actions, ajoutez un `VALUE` champ à votre schéma. Pour son type, utilisez `long` et tapez éventuellement`null`. Pour plus d'informations sur les actions et leur valeur, consultez[Données de valeur](actions-datasets.md#action-value-data).
+ ACTION\_EXPIRATION\_TIMESTAMP : pour les ensembles de données Actions, si vous avez un horodatage d'expiration pour certaines ou toutes vos actions, ajoutez un champ à votre schéma. `ACTION_EXPIRATION_TIMESTAMP` Pour son type, utilisez `long` et tapez éventuellement`null`. Pour plus d'informations sur les horodatages d'expiration, consultez. [Données d'horodatage d'expiration des actions](actions-datasets.md#action-expiration-timestamp-data)
+ REPEAT\_FREQUENCY : pour les ensembles de données Actions, si vous disposez de données de fréquence de répétition pour certaines ou toutes vos actions, ajoutez un `REPEAT_FREQUENCY` champ à votre schéma. Pour son type, utilisez `long` et tapez éventuellement`null`. Pour plus d'informations sur les données de fréquence de répétition, consultez[Répéter les données de fréquence](actions-datasets.md#action-repeat-frequency).