Dela via


Externa listor över dataentiteter

Med Intelligent Recommendations kan du ta hand om manuellt redigerade objektlistor. Den här listan är användbar, till exempel i ett scenario med kallstart där du inte har tillräckligt med data för användarinteraktion för att skapa meningsfulla rekommendationer. Ett annat scenario är att skapa kampanjlistor, till exempel för en "tillbaka till skolan" rea eller "Redaktörens val".

Tillgängligheten av artiklar respekteras alltid. Alla artiklar som inte anses vara tillgängliga i det ögonblick då rekommendations-API anropas returneras inte som en del av svaret.

Följande dataentiteter ingår i dataentiteterna externa listor:

Externa rekommendationslistor

Dataentitetsnamn:Reco_ExternalRecommendationsLists

Beskrivning: Externa listor med rekommendationer

Attribut:

Namn Datatyp Obligatorisk Standardvärde Ogiltigt värdebeteende Kommentarer
ListName Sträng(64) Ja Trimvärde Unik listidentifierare som även används vid sökning efter listan. Längd begränsad till 64 tecken.
Rubrik Sträng(256) Ja Trimvärde Längd begränsad till 256 tecken.
ListAvailabilityStartDate Datum/tid Nr 0001-01-01T00:00:00.000Z Släpp post Se Obligatoriska dataenheter per rekommendationsscenario för DateTime-värden.
ListAvailabilityEndDate Datum/tid Nr 9999-12-31T23:59:59.999Z Släpp post Se Obligatoriska dataenheter per rekommendationsscenario för DateTime-värden.

Riktlinjer:

  • Den här dataentiteten är för framtida användning.

  • ListName attributet har följande begränsningar:

    • Uppsättning med tillåtna tecken: A–Ö, a–ö, 0–9, _, -, ~, ..
    • Det är skiftlägeskänsligt.
    • Befintliga RecoListName-värden är reserverade och kan inte användas som ListName-värden. Se den fullständiga listan med reserverade namn på sidan berikning dataentiteter.
    • Med hjälp av listans start- och slutdatum för tillgänglighet kan du avgöra tillgängligheten för listan, som endast kan användas med Intelligent Recommendations mellan de angivna datumen.

Exempeldata:

Rubriker visas endast för enkelhetens skull och bör inte vara en del av faktiska data.

ListName Rubrik ListAvailabilityStartDate ListAvailabilityEndDate
SummerSale2020 Bästa sommarobjekt för 2020 2020-07-01T00:00:00.000Z 2020-08-31T23:59:59.999Z

Externa rekommendationsobjekt

Dataentitetsnamn:Reco_ExternalRecommendationsItems

Beskrivning: Objekt för externa listor med rekommendationer

Attribut:

Namn Datatyp Obligatorisk Standardvärde Ogiltigt värdebeteende Kommentarer
ListName Sträng(64) Ja Trimvärde Unik listidentifierare som även används vid sökning efter listan. Längd begränsad till 64 tecken. Du kan visa tabellen med ListNames här.
ItemId Sträng(16) Ja Släpp post Se Obligatoriska dataenheter per rekommendationsscenario för itemId.
ItemVariantId Sträng(16) Nr Släpp post Se Obligatoriska dataenheter per rekommendationsscenario för itemVariantId.
Rangordna Int Ja Släpp post Positionsordningen som du vill att varje objekt ska visas i.

Riktlinjer:

  • Den här dataentiteten är för framtida användning.

  • Se riktlinjer för ListName i dataentiteten Reco_ExternalRecommendationsLists.

  • Intelligent Recommendations garanterar inte intern sortering mellan flera objekt som tilldelats med samma rang i samma lista.

  • Om samma objekt eller objektvariant visas i en lista mer än en gång används den högsta rangordningen och alla andra poster ignoreras.

  • För varje värde ListName den här dataentiteten måste det finnas en motsvarande post med samma värde ListName i dataentiteten Reco_ExternalRecommendationsLists annars ignoreras posten.

Exempeldata:

Rubriker visas endast för enkelhetens skull och bör inte vara en del av faktiska data.

ListName ItemId ItemVariantId Rangordna
SummerSale2020 Objekt2 1
SummerSale2020 Item3 Item3Var1 2
SummerSale2020 Objekt1 Item1Var2 3

Se även

Översikt över datakontrakt
Mappningstabell för dataenheter
Dataentiteter för katalog
Bild till artikelmappning för dataentiteter
Dataentiteter för interaktioner
Dataentiteter för Reco-konfiguration
Entiteter för avanmälda användardata
Rekommendationer för berikning dataentiteter
Intelligent Recommendations API
Snabbstartsguide: Konfigurera och köra Intelligent Recommendations med exempeldata