Rekommendationer för berikning dataentiteter
Den här artikeln ger vägledning om hur du konfigurerar rekommendationer berikning dataentiteter i datakontraktet Intelligent Recommendations.
Granskning av datatabeller
En dataentitet är en uppsättning med en eller flera datatextfiler som var och en har en lista med kolumner (kallas även attribut) och rader som innehåller faktiska datavärden.
Intelligent Recommendations definierar logiska grupper av dataentiteter, alla med sina egna syften.
Kommentar
Dataentiteter anses vara valfria (om inget annat uttryckligen anges), vilket innebär att deras data kan vara tomma eller helt saknas.
Gå till den fullständiga listan med dataentiteter
Introduktion
Intelligent Recommendations stöder manuell berikning av genererade rekommendationer som gör att du kan lägga till eller ta bort specifika objekt eller objektvarianter manuellt från alla rekommendationer.
De åtgärder som stöds är:
Inkludera: Lägger till den angivna objektet eller objektvarianten överst i den angivna listan. Dessa manuellt tillagda objekt sorteras efter attributet Rangordning.
Exkludera: Tar bort den angivna artikeln eller artikelvarianten från den angivna listan, oavsett rankningen för artikeln i den listan.
Tillgängligheten av artiklar respekteras alltid. Alla artiklar som inte anses vara tillgängliga i det ögonblick då API:t för rekommendation kommer inte att returneras som en del av svaret.
Följande dataenheter är en del av rekommendationerna berikningsdataenheter:
Gå till den fullständiga listan med dataentiteter
Rekommendationsberikning för ett visst objekt
Dataentitetsnamn:Reco_SeededRecommendationsEnrichment
Beskrivning: Berikning av rekommendationsresultat för en specifik artikel med hjälp av ItemId, känt som SeedItemId. Gäller endast listor som "Personer gillar också", som är av nyckelade för ett visst objekt.
Attribut:
Namn | Datatyp | Obligatorisk | Standardvärde | Ogiltigt värdebeteende | Kommentarer |
---|---|---|---|---|---|
RecoListName | Sträng | Ja | Trimvärde | Gå till tabellen ListNames för de listnamn som stöds. | |
AlgoType | Sträng | Nr | Trimvärde | För alla listnamn krävs inte det här värdet. Se tabellen AlgoTypes för de algoritmtyper som stöds för varje listnamn. | |
SeedItemId | Sträng(16) | Ja | Släpp post | Det ItemId som listan rekommenderar. Se Obligatoriska dataenheter per rekommendationsscenario för artiklarna-ID. | |
SeedItemVariantId | Sträng(16) | Nr | Släpp post | Det ItemVariantId som listan rekommenderar. Se Obligatoriska dataenheter per rekommendationsscenario för artikelvariant-ID. | |
ItemId | Sträng(16) | Ja | Släpp post | Se Obligatoriska dataenheter per rekommendationsscenario för artiklarna-ID. | |
ItemVariantId | Sträng(16) | Nej | Släpp post | Se Obligatoriska dataenheter per rekommendationsscenario för artikelvariant-ID. | |
EnrichmentAction | Sträng | Ja | Släpp post | Stöder endast Inkludera eller Exkludera för tillfället. | |
Rangordna | Int | Nr | Släpp post | För åtgärden Utelämna berikningsåtgärd ignoreras det här värdet. |
Riktlinjer:
Artiklar markerade med inkludera kan endast läggas till överst i en lista med genererade rekommendationer.
Om du utesluter en artikel från en lista som artikeln inte visas i betyder det ingenting.
Uteslutning vinner alltid. Om du både tar med och utesluter samma artikel från samma lista utesluts det från det slutliga API-svaret.
Rank-attributet anger endast ordningen mellan de tillagda artiklarna eller artikelvarianterna. I alla dessa fall läggs de alltid till överst i listan. Om det finns dubbla rangordningsvärden för flera artiklar läggs de till i slumpmässig ordning sinsemellan.
Berikande med ett värde av typen AlgoType som inte stöds ignoreras.
Exempeldata:
Rubriker visas endast för enkelhetens skull och bör inte vara en del av faktiska data.
RecoListName | AlgoType | SeedItemId | SeedItemVariantId | ItemId | ItemVariantId | EnrichmentAction | Rangordna |
---|---|---|---|---|---|---|---|
Liknande | MF | Objekt1 | Objekt2 | Ta med | 1 | ||
Liknande | MF | Objekt1 | Item3 | Item3Var1 | Ta med | 2 | |
Liknande | DAS | Item3 | Item3Var1 | Objekt1 | Item1Var2 | Exkludera | |
Vagn | Item3 | Objekt1 | Item1Var1 | Ta med | 1 |
Rekommendationer för berikning
Dataentitetsnamn:Reco_RecommendationsEnrichment
Beskrivning: Berikning av rekommenderade resultat
Attribut:
Namn | Datatyp | Obligatorisk | Standardvärde | Ogiltigt värdebeteende | Kommentarer |
---|---|---|---|---|---|
RecoListName | Sträng | Ja | Trimvärde | Gå till tabellen ListNames för de listnamn som stöds. | |
ItemId | Sträng(16) | Ja | Släpp post | Gå till Obligatoriska dataenheter per rekommendationsscenario för artiklarna-ID. | |
ItemVariantId | Sträng(16) | Nr | Släpp post | Gå till Obligatoriska dataenheter per rekommendationsscenario för artikelvariant-ID. | |
EnrichmentAction | Sträng | Ja | Släpp post | Stöder endast Inkludera eller Exkludera för tillfället. | |
Rangordna | Int | Nr | Släpp post | För åtgärden Utelämna berikningsåtgärd ignoreras det här värdet. |
Riktlinjer:
- Samma som Reco_SeededRecommendationsEnrichment.
Gå till den fullständiga listan med dataentiteter
ListNames, AlgoTypes och justeringar
Tabell med ListNames
Den aktuella listan med tillgängliga listnamn anges i tabellen:
ListName | Fakturering (Standard/Premium) | Modellering funktionsuppsättning |
---|---|---|
BrowseLists | Standard | Grundläggande |
ExternalLists | Standard | Grundläggande |
PeopleAlso | Standard | Grundläggande |
NextBestAction (formellt "kundvagn") | Standard | Grundläggande |
Val | Standard | Standard |
ViewedInSession | Standard | Standard |
VisualSimilarity | Premium | Premium |
TextualSimilarity | Premium | Premium |
Tabell med AlgoTypes
Tillgängliga AlgoTypes och de olika API:er du kan använda dem med anges i tabellen:
AlgoType | Beskrivning | API som stöds |
---|---|---|
RecentPurchases | Rekommendationer för plock beräknas utifrån användarens senaste köp (eller annan interaktion). | Kan endast fås med API för hämta användare. |
RecentViews | Rekommendationer för plock beräknas utifrån användarens senaste visningshistorik och inställningar. | Kan endast fås med API för hämta användare. |
FullHistory | Rekommendationer för plock beräknas utifrån användarens fullständiga köphistorik (eller annan interaktion). | Kan endast fås med API för hämta användare. |
MF(Matrisfaktorisering) | Standardvyn för liknande API. | Finns endast med liknande API |
Visuella element | Objektlikheterna beräknas utifrån visuella likheter mellan katalogbilder. | Finns endast med liknande API. |
Text | Objektlikheterna beräknas utifrån textspråkliga (språkförståelse) likheter mellan katalogtextrubriker och beskrivningar. | Finns endast med liknande API. |
BringSimilarItems | När denna AlgoType får en sammansatt bild föreslår den objekt som visuellt liknar de objekt som identifieras i den sammansatta bilden. | Finns endast med liknande API. |
CompleteSimilarStyles | När denna AlgoType erhåller ett produktförslag föreslår den andra sammansatta bilder i liknande stil som liknar produktförslaget. | Finns endast med liknande API. |
CompleteSimilarItems | När denna AlgoType erhåller ett produktförslag föreslår den artiklar från andra sammansatta bilder som liknar produktförslaget. | Finns endast med liknande API. |
DAS | "DAS" betyder Direct Associated Scoring. Denna AlgoType ger rekommendationer baserat på likheter med samexiteter av objekt i entiteten för interaktionsdata. Denna Algotype är standard för NextBestAction API. | Finns endast med ett liknande API och NextBestAction API (kallas för "Kundvagn"). |
Tabell för justeringar
De tillgängliga förfiningarna och de olika API:er som du kan använda dem med anges i tabellen: Du kan lägga till flera förfiningar avgränsade med komma, så länge de inte strider mot varandra.
Justering | Definition | API som stöds | standardbeteende |
---|---|---|---|
RemoveUserHistory | Tar bort objekt som användaren redan har köpt så att dessa inte rekommenderas för användaren igen. | alla API:er | Aktiverat som standard endast för API för Hämta användarval. |
KeepUserHistory | Sparar historiken över användarinköpta objekt som rekommendationstjänsten kan överväga för samma användare igen. | alla API:er | Aktiverad som standard för alla API:er utom "Hämta användarväljare". |
EnableShuffling | Ändrar ordningen på objekten något utan att nämnvärt påverka relevansen, för att förhindra att användare ser samma rekommendationer om och om igen. | alla API:er | Aktiverat som standard endast för API för Hämta användarval. |
DisableShuffling | Behåller ordningen på de rekommenderade objekten utan att resultaten blir olika. | alla API:er | Aktiverad som standard för alla API:er utom "Hämta användarväljare". |
Se även
Översikt över datakontrakt
Mappningstabell för dataenheter
Dataentiteter för katalog
Dataentiteter för interaktioner
Dataentiteter för reco-konfiguration
Entiteter för avanmälda användardata
Externa listor över dataentiteter
Bild till artikelmappning för dataentiteter
Intelligent Recommendations API
Snabbstartsguide: Konfigurera och köra Intelligent Recommendations med exempeldata