Entités de données de listes externes
Les recommandations intelligentes vous permettent de gérer des listes d’éléments créées manuellement. Cette liste est utile, par exemple, dans un scénario de démarrage à froid, où vous ne disposez pas de suffisamment de données d’interactions utilisateur pour générer des recommandations significatives. Un autre scénario consiste à créer des listes promotionnelles, comme pour une vente "de retour à l’école" ou "les choix de l’éditeur".
Dans tous les cas, les disponibilités des articles sont toujours respectées. Tout article non considéré comme disponible lors de l’appel de l’API de recommandation n’est pas renvoyé dans le cadre de la réponse.
Les entités de données suivantes font partie des entités de données des listes externes :
Listes de recommandations contextuelles
Nom de l’entité de données :Reco_ExternalRecommendationsLists
Description : Listes externes de recommandations
Attributs :
| Nom | Type de données | Obligatoire | Valeur par défaut | Comportement de la valeur non valide | Commentaires |
|---|---|---|---|---|---|
| ListName | String(64) | Oui | Valeur de rognage | Identificateur de liste unique, également utilisé lors de l’interrogation de la liste. Longueur limitée à 64 caractères. | |
| Civilité | String(256) | Oui | Valeur de rognage | Longueur limitée à 256 caractères. | |
| ListAvailabilityStartDate | DateHeure | Non | 0001-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. |
| ListAvailabilityEndDate | DateHeure | Non | 9999-12-31T23:59:59.999Z | Abandonner l’entrée | Voir Entités de données requises par scénario de recommandations pour les valeurs DateHeure. |
Instructions :
Cette entité de données est destinée à une utilisation future.
L’attribut ListName a les restrictions suivantes :
- Ensemble de caractères autorisés : A-Z, a-z, 0-9, _, -, ~, ..
- Respecte la casse.
- Les valeurs RecoListName existantes sont réservées et ne peuvent pas être utilisées comme valeurs ListName. Consultez la liste complète des noms réservés sur la page des entités de données d’enrichissement.
- À l’aide des dates de début et de fin de disponibilité de la liste, vous pouvez déterminer la disponibilité de la liste, qui Recommandations intelligentes ne peut servir qu’entre ces dates spécifiées.
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.
| ListName | Civilité | ListAvailabilityStartDate | ListAvailabilityEndDate |
|---|---|---|---|
| SummerSale2020 | Les meilleurs articles de l’été 2020 | 2020-07-01T00:00:00.000Z | 2020-08-31T23:59:59.999Z |
Éléments de recommandations contextuelles
Nom de l’entité de données :Reco_ExternalRecommendationsItems
Description : éléments des listes externes de recommandations
Attributs :
| Nom | Type de données | Obligatoire | Valeur par défaut | Comportement de la valeur non valide | Commentaires |
|---|---|---|---|---|---|
| ListName | String(64) | Oui | Valeur de rognage | Identificateur de liste unique, qui est également utilisé lors de l’interrogation de la liste. Longueur limitée à 64 caractères. Vous pouvez consulter le tableau des ListNames ici. | |
| ItemId | String(16) | Oui | Abandonner l’entrée | Voir Entités de données requises par scénario de recommandations pour l’itemId. |
|
| ItemVariantId | String(16) | Non | Abandonner l’entrée | Voir Entités de données requises par scénario de recommandations pour l’itemVariantId. |
|
| Classement | Int | Oui | Abandonner l’entrée | Ordre de positionnement dans lequel vous voulez que chaque élément apparaisse. |
Instructions :
Cette entité de données est destinée à une utilisation future.
Voir les directives ListName dans l’entité de données Reco_ExternalRecommendationsLists.
Les Recommandations intelligentes ne garantit pas l’ordre interne entre plusieurs éléments qui ont été attribués avec le même rang dans la même liste.
Dans le cas où le même article ou la même variante d’article apparaît plusieurs fois dans une liste, son classement le plus élevé est utilisé et toutes les autres entrées sont ignorées.
Pour chaque valeur ListName dans cette entité de données, il doit y avoir une entrée correspondante avec la même valeur ListName dans l’entité de données Reco_ExternalRecommendationsLists ; sinon, l’entrée est ignorée.
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.
| ListName | ItemId | ItemVariantId | Classement |
|---|---|---|---|
| SummerSale2020 | Élément2 | 1 | |
| SummerSale2020 | Item3 | Item3Var1 | 2 |
| SummerSale2020 | Élément1 | Item1Var2 | 3 |
Voir aussi
Présentation des contrats de données
Table de mappage des entités de données
Entités de données du catalogue
Entités de données de mappage image-élément
Entités de données des interactions
Entités de données de configuration de recommandation
Entités de données d’utilisateurs désabonnés
Entités de données d’enrichissement des recommandations
API de recommandations intelligentes
Guide de démarrage rapide : configurer et exécuter des recommandations intelligentes avec un exemple données