Entités de données du catalogue
Cet article fournit des instructions sur la configuration des entités de données de catalogue dans contrat de données Recommandations intelligentes.
Évaluation d’entités de données
Une entité de données est un ensemble d’un ou plusieurs fichiers texte de données, chacun ayant une liste de colonnes (également appelée attributs) et des lignes contenant les valeurs de données réelles.
Recommandations intelligentes définit des groupes logiques d’entités de données, chacun ayant son propre objectif.
Note
Les entités de données sont facultatives, sauf indication contraire explicite, ce qui signifie que leurs données peuvent être vides ou manquantes.
Revenir à la liste complète des entités de données
Présentation des entités des données de catalogue
L’entité de données de catalogue représente tous les articles et variantes d’articles qui sont candidats à l’affichage dans les résultats de recommandations. Les candidats sont déterminés en appliquant des disponibilités aux articles, une date qui indique au système d’inclure un article dans les résultats des recommandations. Sans disponibilité valide, les articles sont ignorés au moment du retour des résultats.
Recommandations intelligentes prend en charge les fonctionnalités et scénarios suivants :
Articles avec plusieurs variantes (par exemple, une chemise de différentes tailles ou couleurs) ou aucune variation. Nous appelons ces variations des variantes. Les articles qui n’ont pas de variantes sont appelés articles autonomes, tandis que les articles avec au moins une variante sont appelés articles principaux.
Affectation de valeurs de filtre aux articles (par exemple, catégorie, couleur ou taille). Plus tard, au moment de la requête de recommandations, vous pouvez filtrer par ces valeurs de filtre.
Attribution d’images à des articles.
Les articles peuvent être disponibles dans différentes entités logiques au sein de l’organisation. Recommandations intelligentes prend en charge deux niveaux de hiérarchies :
Canal : Les articles peuvent être affectés à un canal, permettant à Recommandations intelligentes de fournir des recommandations limitées aux produits inclus dans un canal spécifique. Tous les articles sont automatiquement associés au canal par défaut, qui utilise la chaîne 0 (zéro) comme ID de canal réservé.
Exemple :
Dans cet exemple, le jeu de données ne contient que trois articles : X, Y et Z. Ces trois articles sont automatiquement affectés au canal par défaut (Canal=0). Vous pouvez également affecter ces articles à vos propres canaux personnalisés. Par exemple, vous pouvez affecter les articles X et Y à Canal=C1 et les articles Y et Z à Canal=C2.
Ainsi, quand vous demandez des recommandations, vous pouvez transmettre ces autres paramètres de requête :
- Aucun paramètre de canal (équivalent au canal par défaut) : les trois articles peuvent être renvoyés dans la réponse
- Canal=0 : identique à aucun paramètre puisqu’il s’agit du canal par défaut
- Canal=C1 : Seuls les articles qui appartiennent au canal C1 (articles X et Y) peut être retourné dans la réponse
- Canal=C2 : Seuls les articles qui appartiennent au canal C2 (articles Y et Z) peut être retourné dans la réponse
- Channel=SomethingElse : Réponse vide car ce canal n’a pas été défini et aucun articles ne lui est attribué
Catalogue : Un catalogue est un autre niveau de granularité de disponibilité plus fin. Il vous permet de définir plusieurs catalogues au sein d’un canal et d’obtenir des recommandations pour des catalogues spécifiques. Comme les canaux, tous les articles sont automatiquement associés au catalogue par défaut d’un canal, qui utilise la chaîne 0 (zéro) comme ID de catalogue réservé.
Exemple :
Poursuivant avec l’exemple de Canal, vous avez les articles X, Y et Z. Vous avez affecté les articles X et Y au canal C1, et ils sont automatiquement affectés au catalogue par défaut dans le canal (en utilisant Catalogue=0). Vous pouvez bénéficier d’une plus grande granularité en attribuant ces articles à des catalogues personnalisés au sein du canal. Attribuons l’articles X à Catalogue=A et les articles X et Y à Catalogue=B.
Ainsi, quand vous demandez des recommandations, vous pouvez transmettre ces autres paramètres de requête :
- Canal=C1 : aucun paramètre de catalogue, égal au catalogue par défaut. Les articles X et Y peuvent être retournés dans la réponse.
- Canal=C1&Catalogue=0 : identique à aucun paramètre de catalogue car il s’agit du catalogue par défaut.
- Canal=C1&Catalogue=A : Seuls les articles qui appartiennent au catalogue A du canal C1 (articles X uniquement) peut être retourné dans la réponse.
- Canal=C1&Catalogue=B : Seuls les articles qui appartiennent au catalogue B du canal C1 (articles X et Y) peut être retourné dans la réponse.
- Channel=C1&Catalog=SomethingElse : Réponse vide, car ce catalogue n’a pas été défini dans le canal C1 et aucun article ne lui est attribué.
Déclarer les disponibilités des articles :
- Dates de début/fin de disponibilité : les articles en dehors de leur plage de disponibilité seront exclus de la réponse de recommandation.
- Fine granularité de la disponibilité : définissez les dates de début/fin dans des ID de canal/catalogue spécifiques.
Le catalogue est composé de plusieurs entités de données, toutes facultatives (selon les fonctionnalités que vous souhaitez utiliser) et peut rester vide (ou manquant) dans le dossier racine Recommandations intelligentes. Suivez les directives dans l’entité de données Reco_ItemsAndVariants, décrite ci-dessous, si vous ne souhaitez pas fournir cette entité de données.
Liste des entités de données du catalogue
Les entités de données suivantes font partie du catalogue :
- Articles et variantes
- Catégories article
- Images d’articles et de variantes
- Filtres d’articles et de variantes
- Disponibilités des articles et des variantes
Revenir à la liste complète des entités de données
Articles et variantes
Nom de l’entité de données :Reco_ItemsAndVariants
Description : Tous les articles et variantes d’articles
Attributs :
| Nom | Type de données | Obligatoire | Default value | Comportement de la valeur non valide | Commentaires |
|---|---|---|---|---|---|
| ItemId | String(16) | Oui | Abandonner l’entrée | Voir Entités de données requises par scénario de recommandations pour l’ID de l’article. | |
| ItemVariantId | String(16) | Non | Abandonner l’entrée | Voir Entités de données requises par scénario de recommandations pour l’ID de variante. | |
| Civilité | String(256) | Non | Valeur de rognage | Longueur limitée à 256 caractères. | |
| Description | String(2048) | Non | Valeur de rognage | Longueur limitée à 2048 caractères. | |
| ReleaseDate | DateTime | Non | 1970-01-01T00:00:00.000Z | Abandonner l’entrée | Voir Entités de données requises par scénario de recommandations pour les valeurs DateHeure. |
Instructions :
Les variantes d’articles héritent des attributs de leur référentiel d’articles. Par exemple, si une variante d’article n’a pas de titre, elle hérite du titre de sa fiche article (c’est-à-dire la ligne avec le même ItemId mais avec un ItemVariantId vide) s’il existe.
ItemIds peut avoir une relation un-à-plusieurs avec ItemVariantIds. Il est possible qu’un seul ItemId soit mappé à plusieurs ItemVariantId pour capturer la relation entre un référentiel d’articles et ses variantes d’articles. Il est possible d’avoir une seule entrée pour une combinaison ItemId et ItemVariantId spécifique sans spécifier d’autre combinaison ItemId à ItemVariantId.
L’attribut ReleaseDate représente la date à laquelle l’article est sorti (publié, introduit) sur le marché. Cet attribut est différent de la disponibilité d’un article (quand un article/produit peut être retourné dans un appel API), mais ReleaseDate peut être utilisé dans des scénarios tels que Nouveau et Tendance, qui reposent sur les dates de commande des articles.
Si cette entité de données est vide (ou manquante), Recommandations intelligentes utilisera automatiquement tous les articles et variantes d’articles trouvés dans l’entité de données Reco_Interactions en tant qu’ensemble d’articles de catalogue et attribuez à chaque article et variante d’article le titre, la description et la date de sortie par défaut. Ces articles sont considérés comme toujours disponibles sauf si des disponibilités explicites leur ont été attribuées dans l’entité de données Reco_ItemAndVariantAvailabilities.
Recommandations intelligentes peuvent utiliser les attributs Title et Description pour fournir des recommandations textuelles. Étant donné que Recommandations intelligentes ne prend actuellement en charge que les paramètres régionaux en-us pour les recommandations textuelles, fournissant les Titre et Description dans tout autre lieu peut dégrader la qualité des recommandations textuelles.
Exemple de données :
Les en-têtes apparaissent uniquement à des fins de commodité et ne doivent pas faire partie des données réelles.
| ItemId | ItemVariantId | Civilité | Description | ReleaseDate |
|---|---|---|---|---|
| Élément1 | 2018-05-15T13:30:00.000Z | |||
| Élément1 | Item1Var1 | Lunettes de soleil noires | Lunettes de soleil noires pour enfants | 2018-08-01T10:45:00.000Z |
| Élément1 | Item1Var2 | Lunettes de soleil marron | Lunettes de soleil marron pour adultes | |
| Élément2 | Chiffon de nettoyage de lunettes | 2019-09-20T18:00:00.000Z | ||
| Item3 | Item3Var1 |
Revenez à la liste des entités de données du catalogue
Catégories article
Nom de l’entité de données :Reco_ItemCategories
Description : toutes les catégories d’articles.
Attributs :
| Nom | Type de données | Obligatoire | Default value | Comportement de la valeur non valide | Commentaires |
|---|---|---|---|---|---|
| ItemId | String(16) | Oui | Abandonner l’entrée | Voir Entités de données requises par scénario de recommandations pour l’ID de l’article. | |
| Categorie | String(64) | Oui | Valeur de rognage | Longueur limitée à 64 caractères. |
Instructions :
Chaque ItemId peut avoir plusieurs catégories, ce qui signifie qu’il peut apparaître dans plusieurs entrées dans les données.
Si vos données sont construites à l’aide d’arbres de catégories, vous devez fournir l’ensemble complet de catégories (aplaties) pour chaque article.
Exemple de données :
Les en-têtes apparaissent uniquement à des fins de commodité et ne doivent pas faire partie des données réelles.
| ItemId | Categorie |
|---|---|
| Élément1 | Category1 |
| Élément1 | Category1_subCategoryX |
| Élément1 | Category1_subCategoryY |
| Élément2 | Category1_subCategoryX |
Revenez à la liste des entités de données du catalogue
Images d’articles et de variantes
Nom de l’entité de données :Reco_ItemAndVariantImages
Description : Toutes les images des articles et variantes d’articles
Attributs :
| Nom | Type de données | Obligatoire | Default value | Comportement de la valeur non valide | Commentaires |
|---|---|---|---|---|---|
| ItemId | String(16) | Oui | Abandonner l’entrée | Voir Entités de données requises par scénario de recommandations pour l’ID de l’article. | |
| ItemVariantId | String(16) | Non | Abandonner l’entrée | Voir Entités de données requises par scénario de recommandations pour l’ID de variante. | |
| ImageFullUrl | String(2048) | Oui | Abandonner l’entrée | Doit être une URL absolue. L’URL doit être correctement encodée (en utilisant le pourcentage d’encodage). Longueur limitée à 2048 caractères. | |
| IsPrimaryImage | Bool | Oui | Consultez les instructions | Voir Entités de données requises par scénario de recommandations pour les valeurs booléennes. |
Instructions :
Vous devez explicitement affecter des images à un ItemId et à chaque ItemVariantId concernée. Les images attribuées à un article ne sont pas automatiquement attribuées à toutes les variantes d’article et vice-versa. Les images attribuées à une variante d’ article ne sont pas automatiquement attribuées à l’article principal de cette variante.
Si plusieurs images principales sont spécifiées pour la même combinaison <ItemId, ItemVariantId>, une seule de ces images sera utilisée pour l’étape d’inférence des recommandations visuelles et les autres sont utilisées uniquement au moment de la formation de l’ensemble du modèle visuel.
Pour toute image à laquelle Recommandations intelligentes n’a pas pu accéder, l’URL de l’image est ignorée et non utilisée pour le modèle de recommandation.
Si la valeur IsPrimaryImage n’est pas valide, une valeur de false sera utilisé (par exemple, une image non principale).
Si seules des images non principales ont été spécifiées pour un article ou une variante d’article, Recommandations intelligentes utilisera l’une des images spécifiées comme image principale pour continuer à fournir des recommandations visuelles pour cet article ou cette variante d’article.
Il existe deux types d’URL pris en charge :
- URL HTTPS accessibles au public : Ne nécessite pas d’en-tête Autorisation. Cette URL n’inclut pas les URL des objets blobs Azure disponibles publiquement/anonymement, qui ne sont pas prises en charge.
- URL de stockage d’objets blob Azure nécessitant une authentification : ne sont pas disponibles publiquement/anonymement. Les autorisations de lecture des objets blobs d’image doivent être accordées à Recommandations intelligentes, comme expliqué dans Déployer des recommandations intelligentes). Les URL d’objets blob doivent commencer par le préfixe :
https://<StorageAccountName>.blob.core.windows.net/.
La taille maximale prise en charge pour une seule image est de 512 Ko. Toute image supérieure à 512 Ko sera ignorée par le système.
Le ContentType de l’image doit avoir un type de contenu d’image (elle doit commencer par image). Cette exigence s’applique à toutes les images, à la fois disponibles via HTTPS et les objets blobs d’image (via la propriété ContentType de l’objet blob).
Exemple de données :
Les en-têtes apparaissent uniquement à des fins de commodité et ne doivent pas faire partie des données réelles.
| ItemId | ItemVariantId | ImageFullUrl | IsPrimaryImage |
|---|---|---|---|
| Élément1 | https://my.server.org/images/Item1_primary.jpg |
Vrai | |
| Élément1 | https://my.server.org/images/Item1_secondary.jpg |
False | |
| Élément1 | Item1Var1 | https://my.server.org/images/Item1Var1.jpg |
Vrai |
| Élément2 | https://my.server.org/images/Item2.jpg |
Vrai |
Revenez à la liste des types d’entités du catalogue
Filtres d’articles et de variantes
Nom de l’entité de données :Reco_ItemAndVariantFilters
Description : Propriétés d’article et de variante d’article utilisées pour le filtrage des résultats d’exécution
Attributs :
| Nom | Type de données | Obligatoire | Default value | Comportement de la valeur non valide | Commentaires |
|---|---|---|---|---|---|
| ItemId | String(16) | Oui | Abandonner l’entrée | Voir Entités de données requises par scénario de recommandations pour l’ID de l’article. | |
| ItemVariantId | String(16) | Non | Abandonner l’entrée | Voir Entités de données requises par scénario de recommandations pour l’ID de variante. | |
| FilterName | String(64) | Oui | Valeur de rognage | ||
| FilterValue | String(64) | Oui | Valeur de rognage | Longueur limitée à 64 caractères. | |
| FilterType | String | Oui | Abandonner l’entrée | Les valeurs possibles incluent : Textuel, Numérique. |
Instructions :
Les articles et les variantes d’articles ont une relation parent-enfant. Cette instruction signifie que les variantes d’articles hériteront des filtres de leur référentiel d’articles. Par exemple, si le filtre « Couleur » a été déclaré pour un certain ItemId, toutes les variantes d’articles du même ItemId obtiennent la même valeur de filtre « Couleur », sauf si une valeur « Couleur » différente a été spécifiée pour la variante d’article.
Les types de filtres textuels prennent en charge l’opération de filtrage "equals". Par exemple, les requêtes API peuvent filtrer les articles avec "Color"="Blue".
Les types de filtres numériques prennent en charge les opérations de filtrage "range". Par exemple, les requêtes API peuvent filtrer les articles avec "Size" > 40.
Vous pouvez affecter plusieurs valeurs de filtre au même filtre. Par exemple, pour le filtre "Couleur", vous pouvez fournir plusieurs valeurs, comme "Vert" et "Bleu". Dans cet exemple, l’article pertinent a deux valeurs pour le filtre « Couleur » et sera renvoyé quand vous filtrez les articles « Verts » ou les articles « Bleus ». Pour affecter plusieurs valeurs au même filtre, ajoutez une entrée pour chaque valeur de filtre que vous souhaitez affecter, en utilisant les mêmes valeurs FilterName et FilterType.
Pour chaque FilterName, une variante d’article peut hériter de ses valeurs de filtre parent ou les remplacer. La fusion des deux n’est pas prise en charge. Par défaut, si la variante n’a pas de valeurs affectées à un filtre, elle hérite des valeurs de filtre de l’article parent. Si au moins une valeur de filtre est affectée à un filtre pour une variante d’article, le mode de remplacement est activé et seules les valeurs de filtre de variante sont effectives (pour le filtre spécifique uniquement). Cette valeur signifie que pour obtenir un comportement de "fusion", la variante d’article doit répéter ses valeurs de filtre parent. Par exemple, un article prend en charge deux couleurs, le bleu et le vert. Si une variante prend en charge une autre couleur, le rouge, la variante doit répertorier les trois couleurs attribuées à l’ID de variante : bleu, vert et rouge. Dans cet exemple, la variante d’article a remplacé les valeurs du filtre « Couleur », mais elle peut toujours hériter des valeurs des autres filtres de son article parent.
Les entrées avec des types de filtre non pris en charge seront ignorées.
Vous pouvez fournir jusqu’à 20 FilterName distincts.
Fournir plusieurs entrées avec le même FilterName mais un autre FilterType échouera le processus d’ingestion de données de Recommandations intelligentes.
Les articles ou variantes d’articles ne peuvent avoir aucun filtre spécifié. Quand vous spécifiez un filtre dans la demande d’API, les articles ou variantes d’articles sans le filtre spécifié seront filtrés.
Exemple de données :
Les en-têtes apparaissent uniquement à des fins de commodité et ne doivent pas faire partie des données réelles.
| ItemId | ItemVariantId | FilterName | FilterValue | FilterType |
|---|---|---|---|---|
| Élément1 | Color | Rouge | Textuel | |
| Élément1 | Item1Var1 | Color | Bordeaux | Textuel |
| Élément1 | Item1Var2 | Style | Rectangulaire | Textuel |
| Élément2 | Size | 38 | Numérique | |
| Élément2 | Color | Bleu | Textuel | |
| Élément2 | Color | Vert | Textuel |
Revenez à la liste des types d’entités du catalogue
Disponibilités des articles et des variantes
Nom de l’entité de données :Reco_ItemAndVariantAvailabilities
Description : Toutes les disponibilités des articles et variantes d’articles
Attributs :
| Nom | Type de données | Obligatoire | Default value | Comportement de la valeur non valide | Commentaires |
|---|---|---|---|---|---|
| ItemId | String(16) | Oui | Abandonner l’entrée | Voir Entités de données requises par scénario de recommandations pour l’ID de l’article. | |
| ItemVariantId | String(16) | Non | Abandonner l’entrée | Voir Entités de données requises par scénario de recommandations pour l’ID de variante. | |
| StartDate | DateHeure | Non | 0001-01-01T00:00:00.000Z | Consultez les instructions | Voir Entités de données requises par scénario de recommandations pour les valeurs DateHeure. |
| Date de fin | DateHeure | Non | 9999-12-31T23:59:59.999Z | Consultez les instructions | Voir Entités de données requises par scénario de recommandations pour les valeurs DateHeure. |
| Attribut double | Double | Non | Attribut double qui peut être utilisé selon les besoins de l’entreprise et qui n’affecte pas le processus de modélisation. | ||
| Canal | String(64) | Non | 0 | Valeur de rognage | Longueur limitée à 64 caractères. |
| Catalog | String(64) | Non | 0 | Valeur de rognage | Longueur limitée à 64 caractères. |
Instructions :
Rappel : disponibilités indique au système quels articles ou variantes d’articles sont considérés comme candidats pour les résultats des recommandations.
La disponibilité d’une variante d’article est l’union des disponibilités de sa fiche article avec la disponibilité de la variante d’article elle-même. Même les variantes d’articles qui n’ont pas d’entrées héritent des disponibilités de leur fiche article.
Un article manquant dans cette entité de données sera considéré comme toujours disponible dans le canal et le catalogue par défaut. Plus précisément, Recommandations intelligentes se comporte exactement comme si cet article apparaît dans les données avec des valeurs par défaut pour tous les attributs.
ItemIds peut avoir une relation un-à-plusieurs avec ItemVariantIds. Tandis qu’un ItemId n’est pas obligé d’avoir un ItemVariantId, il est possible que plus d’un ItemVariantId peut être mappé sur un seul ItemId. Par exemple, vous pouvez ajouter une entrée pour une combinaison de ItemId et ItemVariantId sans également ajouter explicitement une autre entrée pour ItemId (et un ItemVariantId vide). Lorsque vous déterminez si les variantes d’articles ont des disponibilités valides, seules les variantes d’articles spécifiées sont considérées comme disponibles (aux intervalles de temps spécifiés pour chaque variante).
Un catalogue n’est pertinent que dans le cadre d’un canal (les catalogues sont un sous-ensemble de canaux). Par example, catalog=MySale dans channel=Europe est un catalogue différent de catalog=MySale dans channel=Asia.
Si votre jeu de données contient plusieurs canaux et catalogues, vous devez ajouter une entrée pour chaque combinaison de canal et de catalogue pertinente pour chaque article et variante d’article pertinent.
Les dates de disponibilité ne sont pertinentes que pour le canal et le catalogue spécifiques spécifiés. Si vous souhaitez spécifier les mêmes dates de disponibilité pour différents canaux et catalogues, vous devez explicitement ajouter une entrée pour chaque canal et catalogue.
S’il y a une valeur non valide pour l’un des attributs StartDate ou EndDate, l’entrée entière est modifiée pour représenter un article non disponible. Les valeurs StartDate et EndDate sont remplacées par des valeurs DateTime qui appartiennent au passé.
L’« Attribut double » peut être laissé vide.
N’utilisez pas "0" comme valeur pour "Canal". Cette valeur est réservée au système. L’utilisation de "0" entraînera une erreur de traitement.
Exemple de données :
Les en-têtes apparaissent uniquement à des fins de commodité et ne doivent pas faire partie des données réelles.
| ItemId | ItemVariantId | StartDate | Date de fin | Attribut double | Canal | Catalog |
|---|---|---|---|---|---|---|
| Élément1 | 2020-08-20T10:00:00.000Z | |||||
| Élément1 | Item1Var1 | 2020-08-01T12:00:00.000Z | ||||
| Élément2 | 2020-04-01T10:00:00.000Z | 2020-04-15T23:59:59.999Z | 15.0 | |||
| Élément2 | 2020-04-01T10:00:00.000Z | 9.76 | ||||
| Item3 | 2020-05-01T12:00:00.000Z | Europe | MySale |
Revenez à la liste des types d’entités du catalogue
Voir aussi
Présentation des contrats de donnéesTable de mappage des entités de donnéesEntités de données des interactionsEntités de données de reconfiguration RecoEntités de données d’utilisateurs désabonnésEntités de données de listes externesEntités de données d’enrichissement des recommandationsImage aux entités de données de mappage d’élémentsAPI de recommandations intelligentesGuide de démarrage rapide : configurer et exécuter des recommandations intelligentes avec un exemple données