Entiteter för katalogdata
Den här artikeln ger vägledning om hur du konfigurerar katalogdataenheter 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 till entiteter för katalogdata
Dataentiteten Katalog representerar alla artikel och artikelvarianter som är kandidater för att visas i rekommendationsresultat. Kandidater bestäms genom att ansöka tillgänglighet för artikel, ett datum då systemet ska ta med en artikel i rekommendationerna. Utan en giltig tillgänglighet ignoreras artiklar när resultatet returneras.
Intelligent Recommendations stöder följande funktioner och scenarier:
Artikel med flera variationer (till exempel en skjorta i olika storlek eller färg) eller inga variationer alls. Vi kallar dessa variationer som varianter. Artikel som inte har några varianter kallas fristående artikel, medan artikel med minst en variant kallas artikel för artikelmallar.
Tilldela filtervärden till artikel (till exempel kategori, färg eller storlek). Senare, när du söker efter rekommendationer, kan du filtrera med dessa filtervärden.
Tilldela bilder till artikel.
Artiklar kan vara tillgängliga i olika logiska entiteter i organisationen. Intelligent Recommendations stöder två hierarkinivåer:
Kanal: Artiklar kan tilldelas till en kanal, vilket gör att Intelligent Recommendations endast kan ge rekommendationer om produkter som ingår i en viss kanal. Alla artikel associeras automatiskt med standardkanal, där strängen 0 (noll) används som reserverat kanal-ID.
Exempel:
I det här exemplet datauppsättning endast tre artikel: X, Y och Z. Dessa tre artikel tilldelas automatiskt till standardkanal (Channel=0). Du kan också tilldela artikelen till dina egna anpassade kanaler. Du kan till exempel tilldela artiklarna X och Y till Channel=C1 och artiklarna Y och Z till Channel=C2.
När du begär rekommendationer kan du skicka dessa andra frågeparametrar:
- Ingen kanalparameter (lika med standardkanal): Alla tre artiklar kan returneras i svaret
- Channel=0: Samma som ingen parameter eftersom det här är standardkanal
- Channel=C1: Endast artiklar som tillhör C1-kanalen (artiklarna X och Y) kan returneras i svaret
- Channel=C2: Endast artiklar som tillhör C2-kanalen (artiklarna Y och Z) kan returneras i svaret
- Channel=SomethingElse: Tomt svar eftersom den här kanalen inte har definierats och inga artiklar har tilldelats den
Katalog: En katalog är en annan, bättre granularitetsnivå för tillgänglighet. Du kan definiera flera kataloger i en kanal och få rekommendationer för specifika kataloger. Liknande en kanal associeras artiklar automatiskt med standardkatalog i en kanal, där strängen 0 (noll) används som reserverat katalog-ID.
Exempel:
I exemplet Kanal har du artiklarna X, Y och Z. Du tilldelade artiklarna X och Y C1 och de tilldelas automatiskt till standardkatalogen i kanalen (med Katalog=0). Du kan få ytterligare granularitet genom att tilldela dessa artiklarna till anpassade kataloger i kanalen. Nu tilldelar vi artiklarna X till Katalog=A och artiklarna X och Y till Katalog=B.
När du begär rekommendationer kan du skicka dessa andra frågeparametrar:
- Channel=C1: Ingen katalogparameter, lika med standardkatalogen. Både artiklarna X och Y kan returneras i svaret.
- Channel=C1&Catalog=0: Samma som ingen katalogparameter eftersom detta är standardkatalogen.
- Channel=C1&Catalog=A: Endast artiklar som tillhör katalog A i kanal C1 (endast artikel X) får returneras i svaret.
- Channel=C1&Catalog=B: Endast artiklar som tillhör katalog B i kanal C1 (artiklar X och Y) får returneras i svaret.
- Channel=C1&Catalog=SomethingElse: Tomt svar då denna katalog inte definierats i kanal C1 och inga artiklar tilldelats till den.
Ange tillgänglighet för artikeln:
- Start- och slutdatum för tillgänglighet: Artiklar som ligger utanför tillgänglighetens tidsintervall utesluts från rekommendationssvaret.
- Detaljerad tillgänglighet: Definiera start- och slutdatum inom specifika kanal-/katalog-ID.
Katalogen består av flera dataentiteter, alla valfria (beroende på vilka funktioner du vill använda) och kan förbli tomma (eller saknas) i rotmappen för Intelligent Recommendations. Följ riktlinjerna i Reco_ItemsAndVariants dataentitet som beskrivs nedan om du inte vill tillhandahålla den här dataentiteten.
Lista över entiteter för katalogdata
Följande dataentiteter ingår i katalogen:
- Artiklar och varianter
- Artikelkategorier
- Artikel- och variantbilder
- Artikel- och variantfilter
- Artikel- och varianttillgängligheter
Gå till den fullständiga listan med dataentiteter
Artiklar och varianter
Dataentitetsnamn:Reco_ItemsAndVariants
Beskrivning: Alla artiklar och artikelvarianter
Attribut:
| Name | Datatyp | Obligatorisk | Default value | Ogiltigt värdebeteende | Kommentarer |
|---|---|---|---|---|---|
| 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. | |
| Title | Sträng(256) | Nej | Trimvärde | Längd begränsad till 256 tecken. | |
| Beskrivning | Sträng(2048) | Nej | Trimvärde | Längd begränsad till 2048 tecken. | |
| ReleaseDate | Datum/tid | Nej | 1970-01-01T00:00:00.000Z | Släpp post | Se Obligatoriska dataenheter per rekommendationsscenario för DateTime-värden. |
Riktlinjer:
Artikelvarianter ärver attributen för artikelns huvudartiklarna. Om en artikelvariant till exempel inte har någon titel ärver artikelns huvudrubrik ( det vill säga raden med samma ItemId men med ett tomt ItemVariantId) om det finns.
ItemIds kan ha en 1 till många-relation med ItemVariantIds. Ett ItemId är möjligt att mappa till fler än ett ItemVariantId för att fånga relationen från en artikelhanterare till artikelvarianter. Det är möjligt att ha en enda post för en specifik kombination ItemId och ItemVariantId utan att ange annan kombination ItemId för ItemVariantId.
Attributet ReleaseDate representerar datumet då artikeln publicerades (publicerades, introducerades) på marknaden. Detta skiljer sig från tillgängligheten för ett objekt (när ett objekt/en produkt kan returneras i ett API-samtal), men ReleaseDate kan användas i scenarier som Nytt och Trending, som bygger på datum för artikelbeställning.
Om denna dataenhet är tom (eller saknas), Intelligent Recommendations kommer automatiskt att använda alla artiklar och artikelvarianter som finns i Reco_Interactions dataentitet som en uppsättning katalogartiklar och tilldela varje artikel och artikelvariant standardtitel, beskrivning och releasedatum. Dessa objekt betraktas som alltid tillgängliga såvida de inte tilldelats explicita tillgängligheter i dataentiteten Reco_ItemAndVariantAvailabilities.
Intelligent Recommendations kan använda attributen Rubrik och Beskrivning för att ge textbaserade rekommendationer. Eftersom Intelligent Recommendations stöder för närvarande endast en-us-språket för textrekommendationer, vilket ger Rubrik och Beskrivning på alla andra språk kan försämra kvaliteten på textrekommendationerna.
Exempeldata:
Rubriker visas endast för enkelhetens skull och bör inte vara en del av faktiska data.
| ItemId | ItemVariantId | Title | Beskrivning | ReleaseDate |
|---|---|---|---|---|
| Objekt1 | 2018-05-15T13:30:00.000Z | |||
| Objekt1 | Item1Var1 | Svarta solglasögon | Svarta solglasögon för barn | 2018-08-01T10:45:00.000Z |
| Objekt1 | Item1Var2 | Bruna solglasögon | Bruna solglasögon för vuxna | |
| Objekt2 | Glasögon rengöringsduk | 2019-09-20T18:00:00.000Z | ||
| Item3 | Item3Var1 |
Återgå till listan med katalog dataentiteter
Artikelkategorier
Dataentitetsnamn:Reco_ItemCategories
Beskrivning: alla artikelkategorier.
Attribut:
| Name | Datatyp | Obligatorisk | Default value | Ogiltigt värdebeteende | Kommentarer |
|---|---|---|---|---|---|
| ItemId | Sträng(16) | Ja | Släpp post | Se Obligatoriska dataenheter per rekommendationsscenario för artiklarna-ID. | |
| Kategori | Sträng(64) | Ja | Trimvärde | Längd begränsad till 64 tecken. |
Riktlinjer:
Varje ItemId kan ha flera kategorier, vilket betyder att det kan visas i flera poster i dina data.
Om dina data konstrueras med hjälp av kategoriträd måste du tillhandahålla samtliga kategorier (förfallna) för varje artikel.
Exempeldata:
Rubriker visas endast för enkelhetens skull och bör inte vara en del av faktiska data.
| ItemId | Kategori |
|---|---|
| Objekt1 | Kategori1 |
| Objekt1 | Category1_subCategoryX |
| Objekt1 | Category1_subCategoryY |
| Objekt2 | Category1_subCategoryX |
Återgå till listan med katalog dataentiteter
Artikel- och variantbilder
Dataentitetsnamn:Reco_ItemAndVariantImages
Beskrivning: Alla artikel och variantbilder
Attribut:
| Name | Datatyp | Obligatorisk | Default value | Ogiltigt värdebeteende | Kommentarer |
|---|---|---|---|---|---|
| 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. | |
| ImageFullUrl | Sträng(2048) | Ja | Släpp post | Måste vara en absolut URL. URL:en ska vara korrekt kodad (med procentkodning). Längd begränsad till 2048 tecken. | |
| IsPrimaryImage | Bool | Ja | Se riktlinjer | Se Obligatoriska dataenheter per rekommendationsscenario för booleska värden. |
Riktlinjer:
Du måste uttryckligen tilldela bilder till ett ItemId och till varje relevant ItemVariantId. Bilder som tilldelas en artikel tilldelas inte automatiskt till alla artikelvarianter och vice versa. Bilder som tilldelas en artikelvariant tilldelas inte automatiskt artikelns huvudpost för den varianten.
Om mer än en primär bild anges för samma kombination används för samma <ItemId, ItemVariantId>-kombination kommer endast en av dessa bilder att användas för det visuella rekommendationsinferenssteget, och de andra används bara när hela den visuella modellen programmeras.
För bilder som Intelligent Recommendations inte har tillgång till ignoreras bild-URL:en och används inte för rekommendationsmodellen.
Om värdet IsPrimaryImage är ogiltigt används ett värde av falskt (t.ex. en icke-primär bild).
Om endast icke-primära bilder har angetts för ett objekt eller en objektvariant använder Intelligent Recommendations en av de angivna bilderna som en primär bild för att fortsatt tillhandahålla visuella rekommendationer för objektet eller objektvarianten.
Det finns två typer av URL som stöds:
- Offentlig HTTPS-URL:er: Kräver ingen rubrik för Auktorisering. Denna URL omfattar inte URL:er för Azure-blobbar som är offentlig/anonymt tillgängliga och som inte stöds.
-
Azure Blob Storage URL:e som kräver autentisering: Är inte offentligt/anonymt tillgänglig. Behörigheter för att läsa bild blobbar bör ges till Intelligent Recommendations enligt vad som förklaras i Distribuera Intelligent Recommendations). Blobb-URL:er måste börja med prefixet:
https://<StorageAccountName>.blob.core.windows.net/.
Den maximala storleken för en enskild bild är 512 KB. Bilder som är större än 512 KB ignoreras av systemet.
ContentType för bilden måste ha en innehållstyp (den ska börja med bild). Detta krav gäller alla bilder, både tillgängliga via HTTPS och bildblobbar (via egenskapen blogg ContentType).
Exempeldata:
Rubriker visas endast för enkelhetens skull och bör inte vara en del av faktiska data.
| ItemId | ItemVariantId | ImageFullUrl | IsPrimaryImage |
|---|---|---|---|
| Objekt1 | https://my.server.org/images/Item1_primary.jpg |
Sann | |
| Objekt1 | https://my.server.org/images/Item1_secondary.jpg |
Falsk | |
| Objekt1 | Item1Var1 | https://my.server.org/images/Item1Var1.jpg |
Sann |
| Objekt2 | https://my.server.org/images/Item2.jpg |
Sann |
Återgå till listan med katalogentitetstyper
Artikel- och variantfilter
Dataentitetsnamn:Reco_ItemAndVariantFilters
Beskrivning: Egenskaper för objekt- och objektvariant som används för filtrering av körtidsresultat
Attribut:
| Name | Datatyp | Obligatorisk | Default value | Ogiltigt värdebeteende | Kommentarer |
|---|---|---|---|---|---|
| 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. | |
| FilterName | Sträng(64) | Ja | Trimvärde | ||
| FilterValue | Sträng(64) | Ja | Trimvärde | Längd begränsad till 64 tecken. | |
| FilterType | String | Ja | Släpp post | Möjliga värden är: Textuell, Numerisk. |
Riktlinjer:
Artikel och artikelvarianter har en överordnad-underordnad relation. Denna riktlinje innebär att artikelvarianter ärver filtren för huvudartikeln. Om exempelvis filtret "Färg" deklarerades för ett visst ItemId får samtliga artikelvarianter med samma ItemId att få samma "Färg"-filtervärde, detta såvida inte ett annat "Färg"-värde angavs för artikelvarianten.
Textfiltertyper stöder "lika med"-filtrering. API-förfrågningar kan till exempel filtrera objekt med "Färg"="Blå".
Numeriska filtertyper har stöd för åtgärder för intervallfiltrering. API-förfrågningar kan till exempel filtrera objekt med "Storlek" > 40.
Du kan tilldela samma filter flera filtervärden. För filtret "Färg" kan du till exempel ange flera värden, som "Grön" och "Blå". I det här exemplet får den relevanta artikeln två värden för "Färg"-filter och returneras när du filtrerar för antingen gröna eller blå artiklar. Om du vill tilldela flera värden till samma filter lägger du till en post för varje filtervärde du vill tilldela, med samma FilterName- och FilterType-värden.
För varje FilterName kan en objektvariant antingen ärver sina överordnade filtervärden eller åsidosätter dem. Sammanfogning av de två stöds inte. Om varianten inte har tilldelats några filter ärver den som standard de överordnade artikelfiltervärdena. Om minst ett filtervärde tilldelas ett filter för en artikelvariant åsidosätts läget och endast variantfiltervärdena är effektiva (endast för det specifika filtret). Detta värde innebär att filtervarianten måste upprepa sina överordnade filtervärden för att funktionen ska kunna kopplas. Ett objekt har till exempel stöd för två färger, blå och grön. Om en variant har stöd för en annan färg, Röd, måste varianten innehålla en lista över alla tre färgerna som tilldelats variant-ID:t: Blå, Grön och Röd. I det här exemplet har artikelvarianten åsidosatt värdena för färgfiltret, men den kan fortfarande ärver värdena för andra filter från det överordnade artikeln.
Poster med filtertyper som inte stöds ignoreras.
Du kan ange upp till 20 olika FilterName.
Om du tillhandahåller flera poster med samma FilterName men en annan FilterType misslyckas datainkationsprocessen för Intelligent Recommendations.
Artikel eller artikelvarianter kan inte ha några filter angivna. När du anger ett filter i API-begäran filtreras artiklarna eller artikelvarianterna utan det angivna filtret ut.
Exempeldata:
Rubriker visas endast för enkelhetens skull och bör inte vara en del av faktiska data.
| ItemId | ItemVariantId | FilterName | FilterValue | FilterType |
|---|---|---|---|---|
| Objekt1 | Color | Röd | Text | |
| Objekt1 | Item1Var1 | Color | Bourgogne | Text |
| Objekt1 | Item1Var2 | Formatmall | Rektangulär | Text |
| Objekt2 | Size | 38 | Numerisk | |
| Objekt2 | Color | Blått | Text | |
| Objekt2 | Color | Grönt | Text |
Återgå till listan med katalogentitetstyper
Artikel- och varianttillgängligheter
Dataentitetsnamn:Reco_ItemAndVariantAvailabilities
Beskrivning: Alla artikel och varianttillgänglighet
Attribut:
| Name | Datatyp | Obligatorisk | Default value | Ogiltigt värdebeteende | Kommentarer |
|---|---|---|---|---|---|
| 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. | |
| StartDate | Datum/tid | Nej | 0001-01-01T00:00:00.000Z | Se riktlinjer | Se Obligatoriska dataenheter per rekommendationsscenario för DateTime-värden. |
| EndDate | Datum/tid | Nej | 9999-12-31T23:59:59.999Z | Se riktlinjer | Se Obligatoriska dataenheter per rekommendationsscenario för DateTime-värden. |
| Dubbelt attribut | Dubbel | Nej | Ett dubbelt attribut som kan användas efter verksamhetens behov och som inte påverkar modelleringsprocessen. | ||
| Kanal | Sträng (64) | Nr | 0 | Trimvärde | Längd begränsad till 64 tecken. |
| Katalog | Sträng (64) | Nej | 0 | Trimvärde | Längd begränsad till 64 tecken. |
Riktlinjer:
Påminnelse: tillgänglighet ger systemet vilken information om vilka artiklar eller artikelvarianter som kandiderar till rekommendationer.
Tillgängligheten för en artikelvariant är tillgängligheten för objektets huvudartiklarna och tillgängligheten för själva artikelvarianten. Även för artikelvarianter som inte har några poster ärver de tillgängligheten från sina huvudartiklar.
En artikel som saknas i den här dataentiteten betraktas som alltid tillgängligt i standardkanal och -katalog. Intelligent Recommendations fungerar mer specifikt som om artikeln visas i datan med standardvärden för alla attribut.
ItemIds har en 1 till många-relation med ItemVariantIds. Även om ett ItemId inte krävs för att ha ett ItemVariantId, är det möjligt att fler än ett ItemVariantId kan mappas till ett enda ItemId. Du kan till exempel lägga till en post för en specifik ItemId- och ItemVariantId-kombination utan att uttryckligen lägga till ytterligare en post för ItemId (och ett tomt ItemVariantId). För att avgöra om artikelvarianter har giltiga tillgänglighet, kommer endast de specificerade artikelvarianterna att betraktas som tillgängliga (vid de angivna tidsintervallen för varje variant).
En katalog är endast relevant för en kanal (kataloger är en deluppsättning av kanalen). Till exempel, catalog=MySale i channel=Europe är en annan katalog än catalog=MySale i channel=Asia.
Om din datauppsättning innehåller flera kanaler och kataloger måste du lägga till en post för varje relevant kanal- och katalogkombination för varje relevant artikel- och artikelvariant.
Tillgänglighetsdatum är endast relevanta för den angivna kanalen och katalogen. Om du vill ange samma tillgänglighetsdatum för olika kanaler och kataloger måste du uttryckligen lägga till en post för varje kanal och katalog.
Om det finns ett ogiltigt värde för något av attributen StartDate eller EndDate ändras hela posten så att den motsvarar en artikel som inte är tillgänglig. Både värdet StartDate och värdet EndDate åsidosätts med tidigare DateTime-värden.
Dubbla attributet kan lämnas tomt.
Använd inte 0 som värde för Kanal. Det här värdet är reserverat för systemet. Om du använder 0 uppstår ett bearbetningsfel.
Exempeldata:
Rubriker visas endast för enkelhetens skull och bör inte vara en del av faktiska data.
| ItemId | ItemVariantId | StartDate | EndDate | Dubbelt attribut | Kanal | Katalog |
|---|---|---|---|---|---|---|
| Objekt1 | 2020-08-20T10:00:00.000Z | |||||
| Objekt1 | Item1Var1 | 2020-08-01T12:00:00.000Z | ||||
| Objekt2 | 2020-04-01T10:00:00.000Z | 2020-04-15T23:59:59.999Z | 15.0 | |||
| Objekt2 | 2020-04-01T10:00:00.000Z | 9.76 | ||||
| Item3 | 2020-05-01T12:00:00.000Z | Europa | MySale |
Återgå till listan med katalogentitetstyper
Se även
Översikt över datakontrakt
Mappningstabell för dataenheter
Dataentiteter för interaktioner
Dataentiteter för Reco-konfiguration
Entiteter för avanmälda användardata
Externa listor för dataenheter
Rekommendationer
Bild till artikelmappning för dataentiteter
Intelligent Recommendations API
Snabbstartsguide: Konfigurera och köra Intelligent Recommendations med exempeldata