Gegevensentiteiten voor verrijking van aanbevelingen
In dit artikel worden richtlijnen gegeven hoe u uw gegevensentiteiten voor verrijking van aanbevelingen configureert in het Intelligent Recommendations-gegevenscontract.
Beoordeling van gegevensentiteiten
Een gegevensentiteit is een set van een of meer gegevenstekstbestanden, elk met een lijst met kolommen (ook wel kenmerken genoemd) en rijen die de werkelijke gegevenswaarden bevatten.
Intelligent Recommendations definieert logische groepen gegevensentiteiten, elk met een eigen doel.
Notitie
Gegevensentiteiten zijn optioneel (tenzij expliciet anders vermeld), wat betekent dat hun gegevens leeg kunnen zijn of helemaal kunnen ontbreken.
Ga naar de volledige lijst met gegevensentiteiten
Inleiding
Intelligent Recommendations ondersteunt handmatige verrijking van gegenereerde aanbevelingen, waardoor u handmatig specifieke artikelen of artikelvarianten kunt toevoegen aan of verwijderen uit een lijst met aanbevelingen.
De ondersteunde verrijkingsacties zijn:
Opnemen: hiermee voegt u het gespecificeerde artikel of de gespecificeerde artikelvariant toe bovenaan de gespecificeerde lijst. Deze handmatig toegevoegde artikelen worden gesorteerd op hun kenmerk Rang.
Uitsluiten: hiermee verwijdert u het gespecificeerde artikel of de gespecificeerde artikelvariant uit de gespecificeerde lijst, ongeacht de rangorde van het artikel in die lijst.
Beschikbaarheid van artikelen wordt altijd gerespecteerd. Elk artikel dat niet beschikbaar wordt geacht op het moment dat de aanbevelings-API wordt aangeroepen, wordt niet geretourneerd als onderdeel van de respons.
De volgende gegevensentiteiten maken deel uit van de gegevensentiteiten voor verrijking van aanbevelingen:
Ga naar de volledige lijst met gegevensentiteiten
Verrijking van aanbevelingen voor een specifiek item
Naam gegevensentiteit:Reco_SeededRecommendationsEnrichment
Beschrijving: Verrijking van aanbevelingsresultaten voor een specifiek item met behulp van een ItemId dat bekend staat als de SeedItemId. Alleen van toepassing op lijsten zoals ′Wat anderen ook leuk vinden′, die zijn afgeleid van een specifiek item.
Kenmerken:
| Name | Gegevenstype | Verplicht | Default value | Ongeldig gedrag van waarde | Opmerkingen |
|---|---|---|---|---|---|
| RecoListName | String | Ja | Waarde inkorten | Ga naar de tabel ListNames voor de ondersteunde lijstnamen. | |
| AlgoType | String | Nee | Waarde inkorten | Het is niet voor alle lijstnamen verplicht om deze waarde in te stellen. Zie voor de ondersteunde algoritmetypen voor elke lijstnaam AlgoTypes-tabel. | |
| SeedItemId | Tekenreeks(16) | Ja | Invoer verwijderen | De ItemId waarvoor de lijst aanbevelingen biedt. Zie Vereiste gegevensentiteiten per aanbevelingsscenario voor artikel-id. | |
| SeedItemVariantId | Tekenreeks(16) | Nee | Invoer verwijderen | De ItemVariantId waarvoor de lijst aanbevelingen biedt. Zie Vereiste gegevensentiteiten per aanbevelingsscenario voor artikelvariant-id. | |
| ItemId | Tekenreeks(16) | Ja | Invoer verwijderen | Zie Vereiste gegevensentiteiten per aanbevelingsscenario voor artikel-id. | |
| ItemVariantId | Tekenreeks(16) | Nee | Invoer verwijderen | Zie Vereiste gegevensentiteiten per aanbevelingsscenario voor artikelvariant-id. | |
| EnrichmentAction | String | Ja | Invoer verwijderen | Ondersteunt voorlopig alleen Opnemen of Uitsluiten. | |
| Rank | Int | Nee | Invoer verwijderen | Voor de verrijkingsactie Uitsluiten wordt deze waarde genegeerd. |
Richtlijnen
Artikelen gemarkeerd met opnemen kunnen alleen bovenaan een gegenereerde lijst met aanbevelingen worden toegevoegd.
Het uitsluiten van een artikel uit een lijst waarin het artikel niet voorkomt, heeft geen zin.
Uitsluiting wint altijd. Als u hetzelfde artikel in- en uitsluit van dezelfde lijst, wordt het uitgesloten van de definitieve API-respons.
Het kenmerk Rang specificeert alleen de volgorde tussen de toegevoegde artikelen of artikelvarianten. Ze komen in ieder geval altijd bovenaan de lijst te staan. Als er dubbele rangwaarden zijn voor meerdere artikelen, worden deze in een willekeurige onderlinge volgorde toegevoegd.
Verrijkingen met een niet-ondersteunde waarde voor AlgoType worden genegeerd.
Voorbeeldgegevens:
Headers worden alleen voor het gemak weergegeven en mogen geen deel uitmaken van de daadwerkelijke gegevens.
| RecoListName | AlgoType | SeedItemId | SeedItemVariantId | ItemId | ItemVariantId | EnrichmentAction | Rank |
|---|---|---|---|---|---|---|---|
| Vergelijkbaar | MF | Item1 | Item2 | Opnemen | 0 | ||
| Vergelijkbaar | MF | Item1 | Item3 | Item3Var1 | Opnemen | 2 | |
| Vergelijkbaar | DAS | Item3 | Item3Var1 | Item1 | Item1Var2 | Uitsluiten | |
| Kaart | Item3 | Item1 | Item1Var1 | Opnemen | 0 |
Verrijking van aanbevelingen
Naam gegevensentiteit:Reco_RecommendationsEnrichment
Beschrijving: verrijking van aanbevelingsresultaten
Kenmerken:
| Name | Gegevenstype | Verplicht | Default value | Ongeldig gedrag van waarde | Opmerkingen |
|---|---|---|---|---|---|
| RecoListName | String | Ja | Waarde inkorten | Ga naar de tabel ListNames voor de ondersteunde lijstnamen. | |
| ItemId | Tekenreeks(16) | Ja | Invoer verwijderen | Ga naar Vereiste gegevensentiteiten per aanbevelingsscenario voor artikel-id. | |
| ItemVariantId | Tekenreeks(16) | Nee | Invoer verwijderen | Ga naar Vereiste gegevensentiteiten per aanbevelingsscenario voor artikelvariant-id. | |
| EnrichmentAction | String | Ja | Invoer verwijderen | Ondersteunt voorlopig alleen Opnemen of Uitsluiten. | |
| Rank | Int | Nee | Invoer verwijderen | Voor de verrijkingsactie Uitsluiten wordt deze waarde genegeerd. |
Richtlijnen
- Gelijk aan Reco_SeededRecommendationsEnrichment.
Ga naar de volledige lijst met gegevensentiteiten
Lijstnamen, AlgoTypes en verfijningen
Tabel met ListNames
De huidige lijst met beschikbare ListNames vindt u in de tabel:
| ListName | Facturering (standaard/premium) | Functieset voor modellering |
|---|---|---|
| BrowseLists | Standard | Basis |
| ExternalLists | Standard | Basis |
| PeopleAlso | Standard | Basis |
| NextBestAction (formeel 'Winkelwagentje') | Standard | Basis |
| Selectie | Standard | Standard |
| ViewedInSession | Standard | Standard |
| VisualSimilarity | Premium | Premium |
| TextualSimilarity | Premium | Premium |
Tabel met AlgoTypes
De beschikbare AlgoTypes en de verschillende API’s waarmee u ze kunt gebruiken, vindt u in de tabel:
| AlgoType | Omschrijving | Ondersteunde API |
|---|---|---|
| RecentPurchases | Aanbevelingen voor keuzes worden berekend op basis van de meest recente aankopen (of andere interactie) van de gebruiker. | Alleen verkrijgbaar met de User Picks-API. |
| RecentViews | Aanbevelingen voor keuzes worden berekend op basis van de meest recente kijkgeschiedenis en voorkeuren van de gebruiker. | Alleen verkrijgbaar met de User Picks-API. |
| FullHistory | Aanbevelingen voor keuzes worden berekend op basis van de volledige geschiedenis van aankopen (of andere interactie) van de gebruiker. | Alleen verkrijgbaar met de User Picks-API. |
| MF (Matrixfactorisatie) | De standaardweergave voor de Similar API. | Alleen verkrijgbaar met de Similar-API |
| Visueel | Artikelovereenkomsten worden berekend op basis van visuele overeenkomsten van catalogusafbeeldingen. | Alleen verkrijgbaar met de Similar-API. |
| Tekstueel | Artikelovereenkomsten worden berekend op basis van tekstuele overeenkomsten (taalbegrip) in tekstuele titels en beschrijvingen in de catalogus. | Alleen verkrijgbaar met de Similar-API. |
| BringSimilarItems | Wanneer er een samengestelde afbeelding wordt gegeven, suggereert dit AlgoType items die visueel vergelijkbaar zijn met de items die in de samengestelde afbeelding zijn geïdentificeerd. | Alleen verkrijgbaar met de Similar-API. |
| CompleteSimilarStyles | Wanneer er een seed-artikel wordt gegeven, suggereert dit AlgoType andere samengestelde afbeeldingen van vergelijkbare stijlen die vergelijkbaar zijn met het seed-artikel. | Alleen verkrijgbaar met de Similar-API. |
| CompleteSimilarItems | Wanneer er een seed-artikel wordt gegeven, suggereert dit AlgoType artikelen van andere samengestelde afbeeldingen die vergelijkbaar zijn met het seed-artikel. | Alleen verkrijgbaar met de Similar-API. |
| DAS | DAS staat voor Direct Associated Scoring. Dit AlgoType biedt aanbevelingen op basis van de berekening van overeenkomsten door het gelijktijdig voorkomen van artikelen binnen de gegevensset interacties. Dit AlgoType is de standaard voor de API NextBestAction. | Alleen verkrijgbaar met de Similar-API en de NextBestAction-API (formeel 'Winkelwagen' genoemd). |
Tabel met verfijningen
De beschikbare verfijningen en de verschillende API's waar u deze bij kunt gebruiken, vindt u in de tabel: u kunt meerdere verfijningen toevoegen, gescheiden door komma's, zolang ze elkaar niet tegenspreken.
| Verfijning | Definitie | Ondersteunde API | standaardgedrag |
|---|---|---|---|
| RemoveUserHistory | Verwijdert artikelen die de gebruiker al heeft gekocht, zodat ze niet opnieuw aan die gebruiker worden aanbevolen. | alle API's | Standaard alleen ingeschakeld voor de API 'Gebruikerskeuzes ophalen'. |
| KeepUserHistory | Houdt de geschiedenis bij van door de gebruiker gekochte artikelen die de aanbevelingsservice opnieuw voor dezelfde gebruiker kan overwegen. | alle API's | Standaard ingeschakeld voor alle API's behalve 'Gebruikerskeuzes ophalen'. |
| EnableShuffling | Verandert de volgorde van artikelen enigszins zonder de relevantie significant te beïnvloeden om te voorkomen dat gebruikers dezelfde aanbevelingen steeds opnieuw zien. | alle API's | Standaard alleen ingeschakeld voor de API 'Gebruikerskeuzes ophalen'. |
| DisableShuffling | Behoudt de volgorde van de aanbevolen artikelen zonder de resultaten te herschikken. | alle API's | Standaard ingeschakeld voor alle API's behalve 'Gebruikerskeuzes ophalen'. |
Zie ook
Overzicht van gegevenscontractenToewijzingstabel voor gegevensentiteitenEntiteiten met catalogusgegevensGegevensentiteiten voor interactiesGegevensentiteiten voor Reco-configuratieGegevensentiteiten voor afgemelde gebruikersGegevensentiteiten voor externe lijstenGegevensentiteiten voor toewijzing van afbeelding aan artikelIntelligent Recommendations-APISnelstartgids: Intelligent Recommendations instellen en uitvoeren met voorbeeldgegevens