Datenentitäten externer Listen
Mit Intelligent Recommendations können Sie manuell erstellte Artikellisten zusammenstellen. Diese Liste ist beispielsweise in einem Kaltstartszenario nützlich, in dem Sie nicht über genügend Daten zu Benutzerinteraktionen verfügen, um aussagekräftige Empfehlungen zu generieren. Ein weiteres Szenario ist das Erstellen von Werbelisten, z. B. für Angebote zum neuen Schuljahr oder „Empfehlungen der Redaktion“.
Die Verfügbarkeit von Artikeln wird im jedem Fall berücksichtigt. Jedes Element, das zum Zeitpunkt des Aufrufs der Empfehlungs-API nicht als verfügbar gilt, wird nicht als Teil der Antwort zurückgegeben.
Die folgenden Entitäten gehören zu den Datenentitäten externer Listen:
Externe Empfehlungslisten
Name der Datenentität:Reco_ExternalRecommendationsLists
Beschreibung: Externe Empfehlungslisten
Attribute:
| Name des Dataflows | Datentyp | Obligatorisch | Standardwert | Verhalten bei ungültigen Werten | Anmerkungen |
|---|---|---|---|---|---|
| ListName | String(64) | Ja | Wert trimmen | Eindeutiger Listenbezeichner, der auch beim Abfragen der Liste verwendet wird. Länge auf 64 Zeichen begrenzt. | |
| Titel | String(256) | Ja | Wert trimmen | Länge auf 256 Zeichen begrenzt. | |
| ListAvailabilityStartDate | DateTime | Nein | 0001-01-01T00:00:00.000Z | Eintrag löschen | Siehe Benötigte Entitäten pro Empfehlungsszenario für DateTime-Werte. |
| ListAvailabilityEndDate | DateTime | Nein | 9999-12-31T23:59:59.999Z | Eintrag löschen | Siehe Benötigte Entitäten pro Empfehlungsszenario für DateTime-Werte. |
Richtlinien:
Diese Datenentität dient zur zukünftigen Verwendung.
Das ListName-Attribut hat die folgenden Einschränkungen:
- Folgende Zeichen sind erlaubt: A bis Z, a bis z, 0 bis 9, _, -, ~,..
- Groß- und Kleinschreibung werden nicht berücksichtigt.
- Vorhandene RecoListName-Werte sind reserviert und können als ListName-Werte nicht verwendet werden. Eine vollständige Liste der reservierten Namen finden Sie auf der Seite Anreicherungsdatenentitäten.
- Anhand des Start- und Enddatums der Listenverfügbarkeit können Sie die Verfügbarkeit der Liste bestimmen, die intelligente Empfehlungen nur zwischen diesen Terminen bedienen können.
Beispieldaten:
Kopfzeilen erscheinen nur aus Gründen der Übersichtlichkeit und sollten nicht Teil der eigentlichen Daten sein.
| ListName | Titel | ListAvailabilityStartDate | ListAvailabilityEndDate |
|---|---|---|---|
| SummerSale2020 | Die besten Sommerartikel des Jahres 2020 | 2020-07-01T00:00:00.000Z | 2020-08-31T23:59:59.999Z |
Externe Empfehlungsartikel
Name der Datenentität:Reco_ExternalRecommendationsItems
Beschreibung: Artikel für die externen Empfehlungslisten
Attribute:
| Name des Dataflows | Datentyp | Obligatorisch | Standardwert | Verhalten bei ungültigen Werten | Anmerkungen |
|---|---|---|---|---|---|
| ListName | String(64) | Ja | Wert trimmen | Eindeutiger Listenbezeichner, der auch beim Abfragen der Liste verwendet wird. Länge auf 64 Zeichen begrenzt. Sie können die Tabelle der ListNames hier einsehen. | |
| ItemId | String(16) | Ja | Eintrag löschen | Unter Erforderliche Datenentitäten pro Empfehlungsszenario finden Sie die itemId. |
|
| ItemVariantId | String(16) | Nein | Eintrag löschen | Unter Erforderliche Datenentitäten pro Empfehlungsszenario finden Sie die itemVariantId. |
|
| Rang | Int | Ja | Eintrag löschen | Die Positionsreihenfolge, in der die einzelnen Artikel angezeigt werden sollen. |
Richtlinien:
Diese Datenentität dient zur zukünftigen Verwendung.
Siehe ListName-Richtlinien unter Datenentität Reco_ExternalRecommendationsLists.
Intelligent Recommendations garantiert die interne Sortierung zwischen mehreren Artikeln nicht, denen in der gleichen Liste derselbe Rang zugewiesen wurde.
Für den Fall, dass derselbe Artikel oder die gleiche Artikelvariante mehr als einmal in einer Liste vorkommt, wird dessen höchster Rang verwendet und alle anderen Einträge werden ignoriert.
Für jeden Listennamen-Wert muss in dieser Datenentität ein entsprechender Eintrag mit dem gleichen Listennamen-Wert in der Reco_ExternalRecommendationsLists Datenentität vorhanden sein, andernfalls wird der Eintrag ignoriert.
Beispieldaten:
Kopfzeilen erscheinen nur aus Gründen der Übersichtlichkeit und sollten nicht Teil der eigentlichen Daten sein.
| ListName | ItemId | ItemVariantId | Rang |
|---|---|---|---|
| SummerSale2020 | Element2 | 1 | |
| SummerSale2020 | Item3 | Item3Var1 | 2 |
| SummerSale2020 | Element1 | Item1Var2 | 3 |
Siehe auch
Übersicht über den Datenvertrag
Zuordnungstabelle der Datenentitäten
Katalog-Datenentitäten
Datenentitäten zu Bild-zu-Artikel-Zuordnung
Interaktions-Datenentitäten
Entitäten für Reco-Konfigurationsdaten
Abgewählte Benutzer-Datenentitäten
Empfehlungsanreicherungs-Daten Entitäten
Intelligent Recommendations API
Schnellstarthandbuch: Intelligent Recommendations mit Beispieldaten festlegen und ausführen