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 VIDEO\$1ON\$1DEMAND
Lorsque vous créez un groupe de jeux de données de domaine pour le domaine VIDEO\$1ON\$1DEMAND, chaque type de jeu de données possède un schéma par défaut avec un ensemble de champs obligatoires et recommandés spécifiques à VIDEO\$1ON\$1DEMAND. Vous pouvez utiliser le schéma par défaut ou en créer un nouveau basé sur le schéma par défaut. Les données que vous importez doivent correspondre au format et au type de votre schéma. Utilisez les schémas de domaine par défaut répertoriés dans les sections ci-dessous comme guide pour déterminer les données à importer afin de créer votre système de recommandation basé sur Video\$1on\$1Demand.
Vous êtes libre d'ajouter des champs supplémentaires. Tant que les champs ne sont pas répertoriés comme obligatoires ou réservés et que les types de données y sont répertoriés[Types de données de schéma](how-it-works-dataset-schema.md#personalize-datatypes), les noms des champs et les types de données dépendent de vous.
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, quel que soit le domaine.
Les rubriques suivantes fournissent des informations sur les champs obligatoires et recommandés de chaque ensemble de données pour le domaine VIDEO\$1ON\$1DEMAND. Chaque section du jeu de données inclut le schéma VIDEO\$1ON\$1DEMAND par défaut au format JSON.
**Topics**
+ [Exigences relatives au jeu de données et au schéma du domaine VIDEO\$1ON\$1DEMAND](#VIDEO-ON-DEMAND-dataset-requirements)
+ [Exigences relatives au jeu de données sur les interactions entre articles (domaine VIDEO\$1ON\$1DEMAND)](VIDEO-ON-DEMAND-interactions-dataset.md)
+ [Exigences relatives aux ensembles de données des utilisateurs (domaine VIDEO\$1ON\$1DEMAND)](VIDEO-ON-DEMAND-users-dataset.md)
+ [Exigences relatives au jeu de données d'articles (domaine VIDEO\$1ON\$1DEMAND)](VIDEO-ON-DEMAND-items-dataset.md)
## Exigences relatives au jeu de données et au schéma du domaine VIDEO\$1ON\$1DEMAND
Chaque type de jeu de données comporte les champs obligatoires et les mots clés réservés suivants. 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 en tant que type de données obligatoire lorsque vous les utilisez. 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 ne peuvent pas figurer dans vos données.
| Type d'ensemble de données | Champs obligatoires | Mots-clés réservés |
| --- | --- | --- |
| Interactions entre éléments ([schéma par défaut](VIDEO-ON-DEMAND-interactions-dataset.md#VIDEO-ON-DEMAND-interactions-schema)) | USER\$1ID (`string`) ITEM\$1ID (`string`) TIMESTAMP (`long`) EVENT\$1TYPE (`string`et selon le [cas d'utilisation](domain-use-cases.md) `Watch` et les types d'`Click`événements) | VALEUR\$1ÉVÉNEMENT (,) `float` `null` IMPRESSION (`string`,`null`) IDENTIFIANT DE RECOMMANDATION (,) `string` `null` SOURCE D'ATTRIBUTION DE L'ÉVÉNEMENT (,) `string` `null` |
| Utilisateurs ([schéma par défaut](VIDEO-ON-DEMAND-users-dataset.md#VIDEO-ON-DEMAND-users-dataset-schema)) | USER\$1ID (`string`) 1 champ de métadonnées (catégorique `string` ou numérique) | SUBSCRIPTION\$1MODEL (catégorique,) `string` `null` |
| Éléments ([schéma par défaut](VIDEO-ON-DEMAND-items-dataset.md#VIDEO-ON-DEMAND-items-dataset-schema)) | ITEM\$1ID (`string`) HORODATAGE DE CRÉATION () `long` GENRES (catégoriques`string`) | PRIX (`float`,`null`) DURÉE (`float`,`null`) GENRE\$1L2 (catégorique,) `string` `null` GENRE\$1L3 (catégorique,) `string` `null` NOTE MOYENNE (,) `float` `null` DESCRIPTION DU PRODUIT (`string`textuelle,) `null` CONTENT\$1OWNER (catégorique`string`,) `null` CONTENT\$1CLASSIFICATION (catégorique`string`,) `null` |
# Exigences relatives au jeu de données sur les interactions entre articles (domaine VIDEO\$1ON\$1DEMAND)
Un jeu de *données sur les interactions entre les articles* stocke les données historiques et en temps réel relatives aux interactions entre les utilisateurs et les articles de votre catalogue VIDEO\$1ON\$1DEMAND. Pour plus d'informations sur les types de données que vous pouvez stocker dans un jeu de données d'interactions, consultez[Données d'interaction entre les articles](interactions-datasets.md).
Vous devez disposer d'un jeu de données d'interactions entre les éléments pour tous les cas d'utilisation et votre schéma doit comporter les champs suivants :
+ USER\$1ID (`string`)
+ IDENTIFIANT DE L'ARTICLE `string`
+ TIMESTAMP (`long`)
+ EVENT\$1TYPE (`string`et selon le [cas d'utilisation](domain-use-cases.md) `Watch` et les types d'`Click`événements)
Votre schéma peut également inclure les mots clés réservés suivants :
+ VALEUR\$1ÉVÉNEMENT (,) `float` `null`
+ IMPRESSION (`string`,`null`)
+ IDENTIFIANT DE RECOMMANDATION (,) `string` `null`
Vous êtes libre d'ajouter des champs supplémentaires en fonction de votre cas d'utilisation et de vos données. Tant que les champs ne sont pas répertoriés comme obligatoires ou réservés et que les types de données y sont répertoriés[Types de données de schéma](how-it-works-dataset-schema.md#personalize-datatypes), les noms des champs et les types de données dépendent de vous. Pour un exemple du schéma par défaut pour les ensembles de données d'interactions entre articles pour les domaines VIDEO\$1ON\$1DEMAND, consultez. [Schéma d'interactions par défaut (domaine VIDEO\$1ON\$1DEMAND)](#VIDEO-ON-DEMAND-interactions-schema)
Ajoutez éventuellement le mot clé réservé EVENT\$1VALUE si vous disposez de données de valeur pour des événements, telles que le pourcentage d'une vidéo visionnée. Ajoutez éventuellement le mot clé réservé IMPRESSION si vous souhaitez inclure des données d'impressions explicites et implicites. Pour plus d'informations sur l'enregistrement des données d'impressions, voir[Données sur les impressions](interactions-datasets.md#interactions-impressions-data).
Le nombre total maximum de champs de métadonnées facultatifs que vous pouvez ajouter à un jeu de données d'interactions entre articles, combiné au nombre total de types d'événements *distincts* dans vos données d'interaction avec les articles, est de 10. Les champs de métadonnées inclus dans ce décompte sont les champs EVENT\$1TYPE, EVENT\$1VALUE ainsi que les champs de métadonnées personnalisés que vous ajoutez à votre schéma. Le nombre maximum de champs de métadonnées, à l'exception des champs réservés, tels que IMPRESSION, est de 5. Les valeurs catégorielles peuvent comporter au maximum 1 000 caractères. Si vous avez une interaction avec une valeur catégorielle supérieure à 1 000, votre tâche d'importation de jeu de données échouera.
Pour plus d'informations sur les exigences minimales et les limites de données maximales pour un jeu de données d'interactions entre articles pour le domaine VIDEO\$1ON\$1DEMAND, consultez. [Quotas de service](limits.md#limits-table) 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, quel que soit le domaine.
## Schéma d'interactions par défaut (domaine VIDEO\$1ON\$1DEMAND)
Voici le schéma de domaine VIDEO\$1ON\$1DEMAND par défaut pour les ensembles de données d'interactions entre articles.
```
{
"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": "TIMESTAMP",
"type": "long"
}
],
"version": "1.0"
}
```
# Exigences relatives aux ensembles de données des utilisateurs (domaine VIDEO\$1ON\$1DEMAND)
Un *jeu de données Utilisateurs* stocke les métadonnées relatives à vos utilisateurs. Cela peut inclure des informations telles que l'âge, les intérêts, le sexe et le niveau de fidélité de chaque utilisateur. Pour plus d'informations sur les types de données utilisateur que vous pouvez importer dans Amazon Personalize, consultez[Métadonnées utilisateur](users-datasets.md). Pour plus d'informations sur les exigences générales relatives au schéma Amazon Personalize, 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, quel que soit le domaine.
Un ensemble de données Users est facultatif pour tous les cas d'utilisation de VIDEO\$1ON\$1DEMAND. Si vous avez des données utilisateur, nous vous recommandons d'en créer une pour obtenir les recommandations les plus pertinentes. Si vous créez un jeu de données Users, votre schéma doit inclure les champs suivants.
+ USER\$1ID
+ 1 champ de métadonnées (catégorique `string` ou numérique)
Vous êtes libre d'ajouter des champs supplémentaires en fonction de votre cas d'utilisation et de vos données. Tant que les champs ne sont pas répertoriés comme obligatoires ou réservés et que les types de données y sont répertoriés[Types de données de schéma](how-it-works-dataset-schema.md#personalize-datatypes), les noms des champs et les types de données dépendent de vous. Pour un exemple du schéma par défaut pour les ensembles de données Users pour les domaines VIDEO\$1ON\$1DEMAND, consultez. [Schéma des utilisateurs par défaut (domaine VIDEO\$1ON\$1DEMAND)](#VIDEO-ON-DEMAND-users-dataset-schema)
Un `SUBSCRIPTION_MODEL` champ est inclus dans le schéma par défaut. Ce champ est un mot clé réservé facultatif dont le type `string` doit être défini sur. `true` Pour obtenir les meilleures recommandations, nous vous recommandons de conserver ce champ dans votre schéma si vous avez des informations sur le modèle d'abonnement concernant chacun de vos utilisateurs dans vos données. Les données que vous importez doivent correspondre à votre schéma.
## Utilisation de données catégoriques
Pour utiliser des données catégorielles, ajoutez un champ de type `string` et définissez l'attribut catégorique du champ sur `true` dans votre schéma. Incluez ensuite les données catégorielles dans votre fichier CSV en masse et dans vos importations d'enregistrements individuels. Pour les utilisateurs appartenant à plusieurs catégories, séparez chaque valeur à l'aide de la barre verticale « \$1 ». Par exemple, pour un champ SUBSCRIPTION\$1MODEL, les données d'un utilisateur peuvent être student\$1monthly\$1discount.
Les valeurs catégorielles peuvent comporter au maximum 1 000 caractères. Si un utilisateur possède une valeur catégorielle de plus de 1 000 caractères, votre tâche d'importation de jeu de données échouera.
## Schéma des utilisateurs par défaut (domaine VIDEO\$1ON\$1DEMAND)
Voici le schéma de domaine VIDEO\$1ON\$1DEMAND par défaut pour les ensembles de données Users.
```
{
"type": "record",
"name": "Users",
"namespace": "com.amazonaws.personalize.schema",
"fields": [
{
"name": "USER_ID",
"type": "string"
},
{
"name": "SUBSCRIPTION_MODEL",
"type": "string",
"categorical": true
}
],
"version": "1.0"
}
```
# Exigences relatives au jeu de données d'articles (domaine VIDEO\$1ON\$1DEMAND)
Un *jeu de données d'articles* stocke les métadonnées relatives à vos articles dans votre catalogue. Cela peut inclure des informations telles que le prix, le genre et la disponibilité de chaque article. Pour plus d'informations sur les types de données d'articles que vous pouvez importer dans Amazon Personalize, consultez[Métadonnées de l'article](items-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, quel que soit le domaine.
Un jeu de données Items est requis pour certains cas d'utilisation (voir[Cas d'utilisation de VIDEO\$1ON\$1DEMAND](VIDEO_ON_DEMAND-use-cases.md)). Lorsque cela est facultatif, nous vous recommandons tout de même d'en créer un pour obtenir les recommandations les plus pertinentes. Si vous créez un jeu de données Items, votre schéma doit inclure les champs suivants :
+ ITEM\$1ID
+ GENRES (catégoriques`string`)
+ CREATION\$1TIMESTAMP (au format Unix Epoch Time)
Votre schéma peut également inclure les mots clés réservés suivants. Chaque mot clé indique le type de données requis et indique s'il prend en charge les données nulles. L'ajout du type nul est facultatif.
+ PRIX (flottant)
+ DURÉE (flottant)
+ GENRE\$1L2 (catégorique,) `string` `null`
+ GENRE\$1L3 (catégorique,) `string` `null`
+ NOTE MOYENNE (,) `float` `null`
+ DESCRIPTION DU PRODUIT (`string`textuelle,) `null`
+ CONTENT\$1OWNER (catégorique`string`,`null`) : société propriétaire de la vidéo. Par exemple, les valeurs peuvent être HBO, Paramount et NBC.
+ CONTENT\$1CLASSIFICATION (catégorique`string`,`null`) : évaluation du contenu. Par exemple, les valeurs peuvent être G, PG, PG-13, R, NC-17 et rated.
Pour obtenir les meilleures recommandations, nous vous recommandons de conserver ces champs autant de champs dans votre schéma que vous disposez de données. Les données que vous importez doivent correspondre à votre schéma. Le nombre maximum de colonnes de métadonnées est de 100. Vous êtes libre d'ajouter des champs supplémentaires en fonction de votre cas d'utilisation et de vos données. Tant que les champs ne sont pas répertoriés comme obligatoires ou réservés et que les types de données y sont répertoriés[Types de données de schéma](how-it-works-dataset-schema.md#personalize-datatypes), les noms des champs et les types de données dépendent de vous.
Utilisez les mots clés réservés GENRE\$1L2 et GENRE\$1L3 pour les articles comportant plusieurs catégories à plusieurs niveaux. Pour de plus amples informations, veuillez consulter [Utilisation de données catégoriques](#VIDEO-ON-DEMAND-items-categorical-data). Pour plus d'informations sur les métadonnées textuelles et catégoriques, voir. [Préparation des métadonnées des éléments pour la formation](items-datasets.md) Pour un exemple du schéma par défaut pour les ensembles de données Items pour les domaines de commerce électronique, consultez[Schéma des articles par défaut (domaine VIDEO\$1ON\$1DEMAND)](#VIDEO-ON-DEMAND-items-dataset-schema).
## Utilisation de données catégoriques
Pour utiliser des données catégorielles, ajoutez un champ de type `string` et définissez l'attribut catégorique du champ sur `true` dans votre schéma. Incluez ensuite les données catégorielles dans votre fichier CSV en masse et dans les importations d'articles individuels. Les valeurs catégorielles peuvent comporter au maximum 1 000 caractères. Si vous avez un élément avec une valeur catégorique de plus de 1 000 caractères, votre tâche d'importation de jeu de données échouera.
Pour les articles comportant plusieurs catégories, séparez chaque valeur par la barre verticale « \$1 ». Par exemple, pour un champ GENRES, vos données relatives à un article peuvent être`Action|Crime|Biopic`. Si vous disposez de plusieurs niveaux de données catégorielles et que certains éléments comportent plusieurs catégories pour chaque niveau de la hiérarchie, ajoutez un champ pour chaque niveau et ajoutez un indicateur de niveau après le nom de chaque champ : GENRES, GENRE\$1L2, GENRE\$1L3. Cela vous permet de filtrer les recommandations en fonction de sous-catégories, même si un article appartient à plusieurs catégories à plusieurs niveaux. Par exemple, une vidéo peut contenir les données suivantes pour chaque niveau de catégorie :
+ GENRES : Action\$1Aventure
+ GENRE\$1L2 : Crime \$1 Western
+ GENRE\$1L3 : film biographique
Dans cet exemple, la vidéo se trouve dans la hiérarchie action > crime > biopic *et* dans la hiérarchie aventure > western > biopic. Nous vous recommandons de n'utiliser que le niveau L3, mais vous pouvez utiliser d'autres niveaux si nécessaire. Pour plus d'informations sur la création et l'utilisation de filtres, consultez[Recommandations de filtrage et segments d'utilisateurs](filter.md).
## Schéma des articles par défaut (domaine VIDEO\$1ON\$1DEMAND)
Le schéma par défaut pour les ensembles de données Items du domaine VIDEO\$1ON\$1DEMAND est le suivant.
```
{
"type": "record",
"name": "Items",
"namespace": "com.amazonaws.personalize.schema",
"fields": [
{
"name": "ITEM_ID",
"type": "string"
},
{
"name": "GENRES",
"type": [
"string"
],
"categorical": true
},
{
"name": "CREATION_TIMESTAMP",
"type": "long"
}
],
"version": "1.0"
}
```