Gegevensentiteiten voor externe lijsten
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 wanneer 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. | |
| Titel | 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 | Titel | 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