Gegevensentiteiten voor externe lijsten

  • Artikel

Met Intelligent Recommendations kunt u handmatig ontworpen itemlijsten cureren. Deze lijst is bijvoorbeeld handig bij een geheel nieuw scenario, waarbij u niet over voldoende gegevens over gebruikersinteracties beschikt om zinvolle aanbevelingen te genereren. Een ander scenario is voor het maken van promotionele lijsten, zoals voor een "terug naar school"-uitverkoop of "Keuze van de redactie".

In alle gevallen wordt de beschikbaarheid van artikelen altijd gerespecteerd. Elk artikel dat niet beschikbaar wordt geacht op het moment dat de aanbevelings-API wordt aangeroepen, wordt niet geretourneerd als onderdeel van de respons.

De volgende gegevensentiteiten maken deel uit van de gegevensentiteiten voor externe lijsten:

Lijsten met externe aanbevelingen

Naam gegevensentiteit:Reco_ExternalRecommendationsLists

Beschrijving: Externe lijsten met aanbevelingen

Kenmerken:

Meting Gegevenstype Verplicht Default value Ongeldig gedrag van waarde Opmerkingen
ListName String(64) Ja Waarde inkorten Unieke lijst-id, ook gebruikt bij het opvragen van de lijst. Lengte is beperkt tot 64 tekens.
Title Tekenreeks(256) Ja Waarde inkorten Lengte is beperkt tot 256 tekens.
ListAvailabilityStartDate Datum en tijd Nee 0001-01-01T00:00:00.000Z Invoer verwijderen Zie Vereiste gegevensentiteiten per aanbevelingsscenario voor DateTime-waarden.
ListAvailabilityEndDate Datum en tijd Nee 9999-12-31T23:59:59.999Z Invoer verwijderen Zie Vereiste gegevensentiteiten per aanbevelingsscenario voor DateTime-waarden.

Richtlijnen

  • Deze gegevensentiteit is voor toekomstig gebruik.

  • Het kenmerk ListName heeft de volgende beperkingen:

    • Toegestane tekens: A-Z, a-z, 0-9, _, -, ~, ..
    • Dit is hoofdlettergevoelig.
    • Bestaande RecoListName waarden zijn gereserveerd en kunnen niet worden gebruikt als ListName waarden. Bekijk de volledige lijst met gereserveerde namen op de pagina Verrijkingsgegevensentiteiten.
    • Met behulp van de begin- en einddatums van de lijstbeschikbaarheid kunt u de beschikbaarheid van de lijst bepalen, die door Intelligent Recommendations alleen tussen deze opgegeven datums kan worden geleverd.

Voorbeeldgegevens:

Headers worden alleen voor het gemak weergegeven en mogen geen deel uitmaken van de daadwerkelijke gegevens.

ListName Title ListAvailabilityStartDate ListAvailabilityEndDate
SummerSale2020 De leukste zomeritems van 2020 2020-07-01T00:00:00.000Z 2020-08-31T23:59:59.999Z

Artikelen met externe aanbevelingen

Naam gegevensentiteit:Reco_ExternalRecommendationsItems

Beschrijving: Artikelen voor de externe lijsten met aanbevelingen

Kenmerken:

Meting Gegevenstype Verplicht Default value Ongeldig gedrag van waarde Opmerkingen
ListName String(64) Ja Waarde inkorten Unieke lijst-id, die ook wordt gebruikt bij het opvragen van de lijst. Lengte is beperkt tot 64 tekens. U kunt de tabel met lijstnamen hier bekijken.
ItemId Tekenreeks(16) Ja Invoer verwijderen Zie Vereiste gegevensentiteiten per aanbevelingsscenario voor itemId.
ItemVariantId Tekenreeks(16) Nee Invoer verwijderen Zie Vereiste gegevensentiteiten per aanbevelingsscenario voor itemVariantId.
Rang Int Ja Invoer verwijderen De positievolgorde waarin u elk item wilt weergeven.

Richtlijnen

  • Deze gegevensentiteit is voor toekomstig gebruik.

  • Zie ListName richtlijnen in gegevensentiteit Reco_ExternalRecommendationsLists.

  • Intelligent Recommendations garandeert geen interne volgorde tussen meerdere items die zijn toegewezen met dezelfde rangschikking in dezelfde lijst.

  • In het geval dat hetzelfde artikel of dezelfde artikelvariant meer dan eens in een lijst voorkomt, wordt de hoogste rangschikking gebruikt en worden alle andere vermeldingen genegeerd.

  • Voor elk waarde ListName in deze gegevensentiteit, moet er een corresponderende invoer met dezelfde waarde ListName zijn in de gegevensentiteit Reco_ExternalRecommendationsLists; anders wordt de invoer genegeerd.

Voorbeeldgegevens:

Headers worden alleen voor het gemak weergegeven en mogen geen deel uitmaken van de daadwerkelijke gegevens.

ListName ItemId ItemVariantId Rank
SummerSale2020 Item2 0
SummerSale2020 Item3 Item3Var1 2
SummerSale2020 Item1 Item1Var2 5

Zie ook

Overzicht gegevenscontract
Toewijzingstabel voor gegevensentiteiten
Entiteiten met catalogusgegevens
Gegevensentiteiten voor toewijzing van afbeelding aan artikel
Gegevensentiteiten voor interacties
Gegevensentiteiten voor reco-configuratie
Gegevensentiteiten voor afgemelde gebruikers
Gegevensentiteiten voor verrijking van aanbevelingen
Intelligent Recommendations-API
Aan de slag: Intelligent Recommendations instellen en uitvoeren met voorbeeldgegevens