Dataobjekter for forbedring af anbefalinger
Denne artikel giver vejledning om, hvordan du konfigurerer dataobjekter for forbedring af anbefalinger i datakontrakten til Intelligent Recommendations.
Gennemgang af dataobjekter
Et dataobjekt er et sæt af en eller flere datatekstfiler, der hver især har en liste over kolonner (også kaldet attributter) og rækker, der indeholder de faktiske dataværdier.
Intelligent Recommendations definerer logiske grupper af dataobjekter, som har deres egne formål.
Bemærk
Dataobjekter er valgfrie, medmindre andet udtrykkeligt er angivet, hvilket betyder, at deres data kan være tomme eller mangle.
Gå til hele listen over dataobjekter
Introduktion
Intelligent Recommendations understøtter manuel forbedring af genererede anbefalinger, som giver dig mulighed for manuelt at tilføje eller fjerne bestemte varer eller varevarianter på enhver anbefalingsliste.
De understøttede forbedringshandlinger er:
Inkluder: Tilføjer den angivne vare eller varevariant øverst på den angivne liste. Disse elementer, der tilføjes manuelt, sorteres efter attributten Rangering.
Udelad: Fjerner den angivne vare eller varevariant fra den angivne liste, uanset varens rangering på den angivne liste.
Varens tilgængeligheder overholdes altid. Enhver vare, der ikke anses for tilgængelig i det øjeblik, hvor anbefalings-API'en kaldes, returneres ikke som en del af svaret.
Følgende dataobjekter er en del af dataobjekterne for forbedring af anbefalinger:
Gå til hele listen over dataobjekter
Forbedring af anbefalinger for en bestemt vare
Navn på dataobjekt:Reco_SeededRecommendationsEnrichment
Beskrivelse: Resultaterne af forbedringen af anbefalinger for en bestemt vare ved hjælp af ItemId, der er kendt som SeedItemId. Gælder kun for lister, f.eks. "Andre synes også godt om", som er oprettet ud fra en bestemt vare.
Attributter:
| Navn | Datatype | Obligatorisk | Standardværdi | Ugyldig funktionsmåde for værdi | Kommentarer |
|---|---|---|---|---|---|
| RecoListName | Streng | Ja | Begrænsningsværdi | Gå til tabellen ListNames for at se de understøttede listenavne. | |
| AlgoType | Streng | Nej | Begrænsningsværdi | Ikke alle listenavne kræver, at denne værdi angives. Se AlgoTypes-tabellen for at få vist de understøttede algoritmetyper for hvert listenavn. | |
| SeedItemId | Streng(16) | Ja | Leveringspost | Det ItemId, som listen anbefales for. Se Påkrævede dataobjekter for hvert anbefalingsscenarie for at få vist vare-id'et. | |
| SeedItemVariantId | Streng(16) | Nej | Leveringspost | Det ItemVariantId, som listen anbefales for. Se Påkrævede dataobjekter for hvert anbefalingsscenarie for at få vist varevariant-id'et. | |
| ItemId | Streng(16) | Ja | Leveringspost | Se Påkrævede dataobjekter for hvert anbefalingsscenarie for at få vist vare-id'et. | |
| ItemVariantId | Streng(16) | Nej | Leveringspost | Se Påkrævede dataobjekter for hvert anbefalingsscenarie for at få vist varevariant-id'et. | |
| EnrichmentAction | Streng | Ja | Leveringspost | Understøtter p.t. kun Inkluder eller Udelad. | |
| Rangering | Int | Nej | Leveringspost | I forbindelse med forbedringshandlingen Udelad ignoreres denne værdi. |
Retningslinjer:
Varer, der er markeret med Inkluder, kan kun tilføjes øverst på en genereret liste med anbefalinger.
Hvis en vare udelades fra en liste, som varen ikke vises på, sker der ikke noget.
Udeladelse har altid forrang. Hvis du inkluderer og udelader den samme vare på den samme liste, bliver den udeladt i det endelige API-svar.
Attributten Rangering angiver kun rækkefølgen mellem de tilføjede varer eller varevarianter. De vil altid blive tilføjet øverst på listen. Hvis der er duplikerede rangeringsværdier for flere varer, bliver de tilføjet i vilkårlig rækkefølge mellem dem.
Forbedringer med en ikke-understøttet AlgoType-værdi ignoreres.
Eksempeldata:
Overskrifter vises kun for nemheds skyld og bør ikke være en del af de faktiske data.
| RecoListName | AlgoType | SeedItemId | SeedItemVariantId | ItemId | ItemVariantId | EnrichmentAction | Rangering |
|---|---|---|---|---|---|---|---|
| Lignende | MF | Element1 | Element2 | Medtag | 0 | ||
| Lignende | MF | Element1 | Item3 | Item3Var1 | Medtag | 2 | |
| Lignende | DAS | Item3 | Item3Var1 | Element1 | Item1Var2 | Udelad | |
| Indkøbsvogn | Item3 | Element1 | Item1Var1 | Medtag | 0 |
Forbedring af anbefalinger
Navn på dataobjekt:Reco_RecommendationsEnrichment
Beskrivelse: Resultater af forbedring for anbefalinger
Attributter:
| Navn | Datatype | Obligatorisk | Standardværdi | Ugyldig funktionsmåde for værdi | Kommentarer |
|---|---|---|---|---|---|
| RecoListName | Streng | Ja | Begrænsningsværdi | Gå til tabellen ListNames for at se de understøttede listenavne. | |
| ItemId | Streng(16) | Ja | Leveringspost | Gå til Påkrævede dataobjekter for hvert anbefalingsscenarie for at få vist vare-id'et. | |
| ItemVariantId | Streng(16) | Nej | Leveringspost | Gå til Påkrævede dataobjekter for hvert anbefalingsscenarie for at få vist varevariant-id'et. | |
| EnrichmentAction | Streng | Ja | Leveringspost | Understøtter p.t. kun Inkluder eller Udelad. | |
| Rangering | Int | Nej | Leveringspost | I forbindelse med forbedringshandlingen Udelad ignoreres denne værdi. |
Retningslinjer:
- Samme som Reco_SeededRecommendationsEnrichment.
Gå til hele listen over dataobjekter
ListNames, AlgoTypes og forbedringer
Tabel over ListNames
Den aktuelle liste over tilgængelige Listenavne er angivet i tabellen:
| ListName | Fakturering (standard/premium) | Modelleringsfunktionssæt |
|---|---|---|
| BrowseLists | Standard | Grundlæggende |
| ExternalLists | Standard | Grundlæggende |
| PeopleAlso | Standard | Grundlæggende |
| NextBestAction (formelt "Indkøbsvogn") | Standard | Grundlæggende |
| Udvalgte | Standard | Standard |
| ViewedInSession | Standard | Standard |
| VisualSimilarity | Premium | Premium |
| TextualSimilarity | Premium | Premium |
Tabel over AlgoTypes
De tilgængelige AlgoTypes og de forskellige API'er, du kan bruge dem med, er angivet i tabellen:
| AlgoType | Beskrivelse | Understøttet API |
|---|---|---|
| RecentPurchases | Valganbefalinger beregnes på baggrund af brugerens seneste køb (eller en anden interaktion). | Kun tilgængelig med API'en for brugervalg. |
| RecentViews | Valganbefalinger beregnes på baggrund af brugerens seneste visningshistorik og præferencer. | Kun tilgængelig med API'en for brugervalg. |
| FullHistory | Valganbefalinger beregnes på baggrund af brugerens komplette købshistorik (eller en anden interaktion). | Kun tilgængelig med API'en for brugervalg. |
| MF(Matrix Factorization) | Standardvisningen for lignende API. | Kun tilgængelig med den lignende API |
| Visuelt element | Ligheder mellem varer beregnes ud fra visuelle ligheder mellem katalogbilleder. | Kun tilgængelig med den lignende API. |
| Tekstbaserede | Ligheder mellem varer beregnes ud fra tekstmæssige ligheder (sprogforståelse) i katalogteksttitler og -beskrivelser. | Kun tilgængelig med den lignende API. |
| BringSimilarItems | Når denne AlgoType får et sammensat billede, foreslår den elementer, der visuelt ligner de elementer, der identificeres i det sammensatte billede. | Kun tilgængelig med den lignende API. |
| CompleteSimilarStyles | Når denne AlgoType får et punkt, foreslår den andre sammensatte billeder af lignende typografier, som svarer til elementet. | Kun tilgængelig med den lignende API. |
| CompleteSimilarItems | Når denne AlgoType får et punkt, foreslår varer fra andre sammensatte billeder, som svarer til elementet. | Kun tilgængelig med den lignende API. |
| DAS | "DAS" betyder Direct Associated Scoring (direkte tilknyttet vurdering). Denne AlgoType indeholder anbefalinger baseret på ligheder ved hjælp af sideordnede forekomster af varer i dataobjektet for interaktioner. Denne AlgoType er standardindstillingen for NextBestAction-API'en? | Kun tilgængelig med den lignende API og NextBestAction-API'en (formelt kaldet "Indkøbsvogn"). |
Tabel med forbedringer
De tilgængelige finjusteringer og de forskellige API'er, du kan bruge dem sammen med, er angivet i tabellen: Du kan tilføje flere finjusteringer adskilt af komma, så længe de ikke er i modstrid med hinanden.
| Forbedring | Definition | Understøttet API | standardfunktionsmåde |
|---|---|---|---|
| RemoveUserHistory | Fjerner elementer, som brugeren allerede har købt, så de ikke anbefales til den pågældende bruger igen. | alle API'er | Kun aktiveret som standard for 'Hent brugervalg' API. |
| KeepUserHistory | Opbevarer en oversigt over elementer, som brugeren har købt, som anbefalingstjenesten kan overveje for den samme bruger igen. | alle API'er | Aktiveret som standard for alle API'er undtagen 'Hent brugervalg'. |
| EnableShuffling | Let ændring af varernes rækkefølge uden relevansen ændres meget, der forhindrer brugere i at se samme anbefalinger igen og igen. | alle API'er | Kun aktiveret som standard for 'Hent brugervalg' API. |
| DisableShuffling | Bevarer rækkefølgen af de anbefalede elementer uden resultaterne. | alle API'er | Aktiveret som standard for alle API'er undtagen 'Hent brugervalg'. |
Se også
Oversigt over datakontrakt
Tabel over tilknytning af dataobjekter
Katalogdataobjekter
Interaktionsdataobjekter
Dataobjekter for konfigurationer af anbefalinger
Dataobjekter for fravalgte brugere
Dataobjekter for eksterne lister
Dataobjekter for tilknytning af billede til vare
API for Intelligent Recommendations
Startvejledning: Konfigurer og kør Intelligent Recommendations med eksempeldata