Del via


Dataobjekter for eksterne lister

Intelligent Recommendations giver dig mulighed for at levere varelister, der er oprettet manuelt. Denne liste er nyttig, f.eks. i et koldstartscenario, hvor du ikke har nok data om brugerinteraktioner til at generere meningsfulde anbefalinger. Et andet scenario er oprettelse af kampagnelister, f.eks. et "skolestartudsalg" eller "Redaktørens favoritter".

Varens tilgængeligheder overholdes dog altid. Enhver vare, der ikke anses for tilgængelig, når anbefalings-API'en kaldes, returneres ikke som en del af svaret.

Følgende dataobjekter er en del af dataobjekterne for eksterne lister:

Lister over eksterne anbefalinger

Navn på dataobjekt:Reco_ExternalRecommendationsLists

Beskrivelse: Eksterne lister over anbefalinger

Attributter:

Navn Datatype Obligatorisk Standardværdi Ugyldig funktionsmåde for værdi Kommentarer
ListName Streng(64) Ja Trim værdi Entydigt liste-id, der også bruges, når der forespørges efter listen. Længden er begrænset til 64 tegn.
titel Streng(256) Ja Trim værdi Længden er begrænset til 256 tegn.
ListAvailabilityStartDate Datetime Nej 0001-01-01T00:00:00.000Z Leveringspost Se Påkrævede dataobjekter for hvert anbefalingsscenarie for at få vist DateTime-værdier.
ListAvailabilityEndDate Datetime Nej 9999-12-31T23:59:59.999Z Leveringspost Se Påkrævede dataobjekter for hvert anbefalingsscenarie for at få vist DateTime-værdier.

Retningslinjer:

  • Dette dataobjekt er til fremtidig brug.

  • Attributten ListName har følgende begrænsninger:

    • Sæt af tilladte tegn: A-Z, a-z, 0-9, _, -, ~, ..
    • Der er ikke forskel på store og små bogstaver.
    • Eksisterende værdier af typen RecoListName er reserveret og kan ikke bruges som værdier for ListName. Se en fuldstændig liste over reserverede navne på siden dataobjekter for forbedring.
    • Ved hjælp af start- og slutdatoer for listetilgængelighed kan du bestemme tilgængeligheden af listen, som kun kan betjenes af Intelligent Recommendations mellem disse angivne datoer.

Eksempeldata:

Overskrifter vises kun for nemheds skyld og bør ikke være en del af de faktiske data.

ListName titel ListAvailabilityStartDate ListAvailabilityEndDate
SummerSale2020 Bedste sommervarer i 2020 2020-07-01T00:00:00.000Z 2020-08-31T23:59:59.999Z

Varer til eksterne anbefalinger

Navn på dataobjekt:Reco_ExternalRecommendationsItems

Beskrivelse: Varer til eksterne lister over anbefalinger

Attributter:

Navn Datatype Obligatorisk Standardværdi Ugyldig funktionsmåde for værdi Kommentarer
ListName Streng(64) Ja Trim værdi Entydigt liste-id, der også bruges, når der forespørges efter listen. Længden er begrænset til 64 tegn. Du kan få vist tabellen over ListNames her.
ItemId Streng(16) Ja Leveringspost Se Påkrævede dataobjekter for hvert anbefalingsscenarie for itemId.
ItemVariantId Streng(16) Nej Leveringspost Se Påkrævede dataobjekter for hvert anbefalingsscenarie for itemVariantId.
Rangering Int Ja Leveringspost Den placeringsrækkefølge, som hvert enkelt vare skal vises i.

Retningslinjer:

  • Dette dataobjekt er til fremtidig brug.

  • Se Retningslinjer for ListName i dataobjektet Reco_ExternalRecommendationsLists.

  • Intelligent Recommendations garanterer ikke den interne rækkefølge mellem flere varer, der er tildelt med samme rang på den samme liste.

  • Hvis det samme vare eller varevariant vises på en liste mere end én gang, bruges dens højeste rangering, og alle andre poster ignoreres.

  • For alle ListName-værdier i dette dataobjekt skal der være en tilsvarende post med samme ListName-værdi i Reco_ExternalRecommendationsLists-dataobjektet. Ellers ignoreres posten.

Eksempeldata:

Overskrifter vises kun for nemheds skyld og bør ikke være en del af de faktiske data.

ListName ItemId ItemVariantId Rangering
SummerSale2020 Element2 0
SummerSale2020 Item3 Item3Var1 2
SummerSale2020 Element1 Item1Var2 3

Se også

Oversigt over datakontrakt
Tabel over tilknytning af dataobjekter
Katalogdataobjekter
Dataobjekter for tilknytning af billede til vare
Interaktionsdataobjekter
Dataobjekter for konfigurationer af anbefalinger
Dataobjekter for fravalgte brugere
Dataobjekter for forbedring af anbefalinger
Intelligent Recommendations-API
Startvejledning: Konfigurer og kør Intelligent Recommendations med prøvedata