Entités de données de listes externes

  • Article

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 qui n’est pas considéré comme disponible au moment où l’API de recommandation est appelée 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 Default value 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 Default value 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