Exigences relatives au jeu de données Items (ECOMMERCEdomaine)

Un jeu de données d'articles stocke les métadonnées relatives à vos ECOMMERCE articles. Cela peut inclure des informations telles que le prix, la catégorie et la description du produit pour chaque article. Pour plus d'informations sur les types de données d'articles que vous pouvez importer dans Amazon Personalize, consultezEnsemble de données d'articles. 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, consultezSchémas. Ces exigences s'appliquent à tous les schémas, quel que soit le domaine.

Un ensemble de données Items est facultatif pour tous les cas ECOMMERCE d'utilisation. Si vous avez des données sur les articles, nous vous recommandons d'en créer une pour obtenir les recommandations les plus pertinentes. Si vous créez un jeu de données d'éléments, votre schéma doit inclure les champs suivants :

• ITEM_ID

• PRICE (float)

• CATEGORY_L1 (catégorique) string

Votre schéma peut également inclure les mots clés réservés suivants. Pour les champs catégoriels, vous pouvez définir votre propre plage de valeurs en fonction de votre cas d'utilisation.

• CATEGORY_L2 (catégoriquestring,) null

• CATEGORY_L3 (catégoriquestring,) null

• PRODUCT_ DESCRIPTION (textuelstring,null)

• CREATION_TIMESTAMP (float)

• AGE_ GROUP (catégoriquestring,null) : groupe d'âge auquel l'article est destiné. Les valeurs peuvent être les nouveau-nés, les nourrissons, les enfants et les adultes.

• ADULT(catégoriquestring,null) : Si l'article est réservé aux adultes uniquement, comme l'alcool. Les valeurs peuvent être « oui » ou « non ».

• GENDER(catégoriquestring,null) : Le sexe auquel l'article est destiné. Les valeurs peuvent être masculines, féminines ou unisexes.

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. 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ésTypes de données de schéma, les noms des champs et les types de données dépendent de vous.

Utilisez les mots clés réservés CATEGORY _L2 et CATEGORY _L3 pour les articles comportant plusieurs catégories à plusieurs niveaux. Pour de plus amples informations, veuillez consulter Utilisation de données catégoriques. Pour plus d'informations sur les métadonnées textuelles et catégoriques, voir. Métadonnées de texte non structurées Pour un exemple du schéma par défaut pour les ensembles de données Items pour les ECOMMERCE domaines, consultezSchéma des éléments par défaut (ECOMMERCEdomaine).

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 CSV fichier groupé et vos importations d'articles individuels. Vous pouvez définir votre propre plage de valeurs en fonction de votre cas d'utilisation. 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 « | ». Par exemple, pour un champ CATEGORY _L1, vos données pour un élément peuvent être. Electronics|Productivity|Mouse 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 : CATEGORY _L1, _L2, CATEGORY _L3. CATEGORY 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, un article peut contenir les données suivantes pour chaque niveau de catégorie :

• CATEGORY_L1 : Électronique|Productivité

• CATEGORY_L2 : Productivité|Ordinateurs

• CATEGORY_L3 : Souris

Dans cet exemple, l'élément se trouve dans la hiérarchie électronique > productivité > souris et dans la hiérarchie productivité > ordinateurs > souris. 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, voirRecommandations de filtrage et segments d'utilisateurs.

Schéma des éléments par défaut (ECOMMERCEdomaine)

Voici le schéma par défaut pour les ensembles de données Items pour le ECOMMERCE domaine avec uniquement les champs obligatoires.

{
  "type": "record",
  "name": "Items",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
    {
      "name": "ITEM_ID",
      "type": "string"
    },
    {
      "name": "PRICE",
      "type": "float"
    },
    {
      "name": "CATEGORY_L1",
      "type": [
        "string"
      ],
      "categorical": true
    }
  ],
  "version": "1.0"
}