Empfehlungsanreicherung Daten Entitäten
Dieser Artikel beschreibt, wie Sie die Entitäten zur Anreicherung von Empfehlungen im Datenvertrag für Intelligent Recommendations konfigurieren können.
Überprüfung der Entitäten
Eine Daten Entität ist eine Menge von einer oder mehreren Daten Textdateien, die jeweils eine Liste von Spalten (auch Attribute genannt) und Zeilen mit den eigentlichen Datenwerten enthalten.
Intelligent Recommendations definieren logische Gruppen von Entitäten, von denen jede ihren eigenen Zweck hat.
Notiz
Daten Entitäten sind optional, sofern nicht ausdrücklich anders angegeben, d.h. ihre Daten können leer sein oder fehlen.
Zur vollständigen Liste der Entitäten gehen
Einführung
Intelligent Recommendations unterstützt die manuelle Anreicherung der generierten Empfehlungen, was es Ihnen erlaubt, bestimmte Elemente oder Elementvarianten manuell zu jeder Empfehlungsliste hinzuzufügen oder zu entfernen.
Die unterstützten Anreicherungsaktionen sind:
Hinzufügen: Fügt das angegebene Element oder die Elementvariante an den Anfang der angegebenen Liste. Diese manuell hinzugefügten Elemente werden nach ihrem Rang-Attribut sortiert.
Ausschließen: Entfernt das angegebene Element oder die Elementvariante aus der angegebenen Liste, unabhängig vom Rang des Elements in dieser Liste.
Die Verfügbarkeiten von Elementen werden immer beachtet. 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 sind Teil der Datenentitäten für die Anreicherung von Empfehlungen:
Zur vollständigen Liste der Entitäten gehen
Anreicherung von Empfehlungen für ein bestimmtes Element
Datenentität name:Reco_SeededRecommendationsEnrichment
Beschreibung: Anreicherung der Empfehlungsergebnisse für ein bestimmtes Element unter Verwendung der ItemId, auch bekannt als SeedItemId. Gilt nur für Listen wie „Leute, die auch mögen“, die auf ein bestimmtes Element verschlüsselt sind.
Attribute:
Name des Dataflows | Datentyp | Obligatorisch | Standardwert | Verhalten bei ungültigen Werten | Anmerkungen |
---|---|---|---|---|---|
RecoListName | Zeichenfolge | Ja | Wert trimmen | Gehen Sie zur ListNames Tabelle für die unterstützten Listennamen. | |
AlgoType | Zeichenfolge | Nein | Wert trimmen | Nicht für alle Listennamen muss dieser Wert festgelegt werden. Sehen Sie die AlgoTypes Tabelle für die unterstützten Algorithmus Typen für jeden Listennamen. | |
SeedItemId | String(16) | Ja | Eintrag löschen | Die ItemId, für die die Liste eine Empfehlung ausspricht. Siehe Erforderliche Entitäten für das Empfehlungsszenario für die Artikel-ID. | |
SeedItemVariantId | String(16) | Nein | Eintrag löschen | Die ItemVariantId, für die die Liste eine Empfehlung ausspricht. Siehe Benötigte Entitäten pro Empfehlungsszenario für die Artikelvarianten-ID. | |
ItemId | String(16) | Ja | Eintrag löschen | Siehe Erforderliche Entitäten für das Empfehlungsszenario für die Artikel-ID. | |
ItemVariantId | String(16) | Nein | Eintrag löschen | Siehe Benötigte Entitäten pro Empfehlungsszenario für die Artikelvarianten-ID. | |
EnrichmentAction | Zeichenfolge | Ja | Eintrag löschen | Unterstützt vorerst nur Einschließen oder Ausschließen. | |
Rang | Int | Nein | Eintrag löschen | Für die Anreicherungsaktion Ausschließen wird dieser Wert ignoriert. |
Richtlinien:
Elemente, die mit einschließen gekennzeichnet sind, können nur an den Anfang einer generierten Empfehlungsliste gestellt werden.
Der Ausschluss eines Elements aus einer Liste, in der das Element nicht vorkommt, bewirkt nichts.
Ausschluss gewinnt immer. Wenn Sie dasselbe Element in derselben Liste sowohl ein- als auch ausschließen, wird es aus der endgültigen API-Antwort ausgeschlossen.
Das Attribut Rang gibt nur die Reihenfolge zwischen den hinzugefügten Elementen oder Elementvarianten an. In jedem Fall werden sie immer an den Anfang der Liste gesetzt. Wenn es doppelte Rangwerte für mehrere Elemente gibt, werden sie in einer zufälligen Reihenfolge hinzugefügt.
Anreicherungen mit einem nicht unterstützten AlgoType Wert werden ignoriert.
Beispieldaten:
Kopfzeilen erscheinen nur aus Gründen der Übersichtlichkeit und sollten nicht Teil der eigentlichen Daten sein.
RecoListName | AlgoType | SeedItemId | SeedItemVariantId | ItemId | ItemVariantId | EnrichmentAction | Rang |
---|---|---|---|---|---|---|---|
Ähnliche | MF | Element1 | Element2 | Einschließen | 1 | ||
Ähnliche | MF | Element1 | Item3 | Item3Var1 | Einschließen | 2 | |
Ähnliche | DAS | Item3 | Item3Var1 | Element1 | Item1Var2 | Ausschließen | |
Warenkorb | Item3 | Element1 | Item1Var1 | Einschließen | 1 |
Empfehlungsanreicherung
Daten Entität:Reco_RecommendationsEnrichment
Beschreibung: Anreicherung der Empfehlungsergebnisse
Attribute:
Name des Dataflows | Datentyp | Obligatorisch | Standardwert | Verhalten bei ungültigen Werten | Anmerkungen |
---|---|---|---|---|---|
RecoListName | Zeichenfolge | Ja | Wert trimmen | Gehen Sie zur ListNames Tabelle für die unterstützten Listennamen. | |
ItemId | String(16) | Ja | Eintrag löschen | Gehen Sie zu Erforderliche Entitäten pro Empfehlungsszenario für die Element-ID. | |
ItemVariantId | String(16) | Nein | Eintrag löschen | Gehen Sie zu Benötigte Entitäten pro Empfehlungsszenario für die ID der Artikelvariante. | |
EnrichmentAction | Zeichenfolge | Ja | Eintrag löschen | Unterstützt vorerst nur Einschließen oder Ausschließen. | |
Rang | Int | Nein | Eintrag löschen | Für die Anreicherungsaktion Ausschließen wird dieser Wert ignoriert. |
Richtlinien:
- Dasselbe wie Reco_SeededRecommendationsEnrichment.
Zur vollständigen Liste der Entitäten gehen
ListNames, AlgoTypes und Verfeinerungen
Tabelle der ListNames
Die aktuelle Liste der verfügbaren ListNames finden Sie in der Tabelle:
ListName | Abrechnung (Standard/Premium) | Funktionen für die Modellierung festlegen |
---|---|---|
BrowseLists | Standard | Grundlegend |
ExternalLists | Standard | Grundlegend |
PeopleAlso | Standard | Grundlegend |
NextBestAction (ehemals „Warenkorb") | Standard | Grundlegend |
Kommissionierungen | Standard | Standard |
ViewedInSession | Standard | Standard |
VisualSimilarity | Premium | Premium |
TextualSimilarity | Premium | Premium |
Tabelle der AlgoTypes
Die verfügbaren AlgoTypes und die verschiedenen APIs, mit denen Sie sie verwenden können, sind in der Tabelle aufgeführt:
AlgoType | Eigenschaft | Unterstützte API |
---|---|---|
RecentPurchases | Kommissionierungen werden auf der Grundlage der letzten Einkäufe (oder sonstigen Interaktionen) des Benutzers berechnet. | Nur verfügbar mit der Benutzer kommissioniert API. |
RecentViews | Kommissionierungen werden auf der Grundlage der letzten Einkäufe und Vorlieben des Nutzers berechnet. | Nur verfügbar mit der Benutzer kommissioniert API. |
FullHistory | Kommissionierungen werden auf der Grundlage der gesamten Kauf- (oder sonstigen Interaktions-) Historie des Benutzers berechnet. | Nur verfügbar mit der Benutzer kommissioniert API. |
MF(Matrix Factorization) | Die Standardansicht für die Similar API. | Nur verfügbar mit der Similar-API. |
Visuell | Element-Ähnlichkeiten werden auf der Grundlage visueller Ähnlichkeiten von Katalogbildern berechnet. | Nur verfügbar mit der Similar-API. |
Textuelle | Element-Ähnlichkeiten werden auf der Grundlage von textlichen (sprachlichen) Ähnlichkeiten von Katalogtiteln und -beschreibungen errechnet. | Nur verfügbar mit der Similar-API. |
BringSimilarItems | Bei einem zusammengesetzten Bild schlägt dieser AlgoType Elemente vor, die den im zusammengesetzten Bild identifizierten Elementen optisch ähneln. | Nur verfügbar mit der Similar-API. |
CompleteSimilarStyles | Wenn ein Startelement angegeben wird, schlägt dieser AlgoType andere zusammengesetzte Bilder mit ähnlichen Stilen vor, die dem Startelement ähneln. | Nur verfügbar mit der Similar-API. |
CompleteSimilarItems | Wenn ein Startelement angegeben wird, schlägt dieser AlgoType andere zusammengesetzte Bilder vor, die dem Startelement ähneln. | Nur verfügbar mit der Similar-API. |
DAS | „DAS“ steht für Direct Associated Scoring. Dieser Algotyp liefert Empfehlungen auf der Grundlage von Ähnlichkeiten unter Verwendung des gemeinsamen Auftretens von Elementen innerhalb der Entität der Interaktionsdaten. Dieser Algotyp ist der Standard für die NextBestAction API. | Nur verfügbar mit der Similar API und der NextBestAction API (formell „Cart“ genannt). |
Tabelle der Verfeinerungen
Die verfügbaren Verfeinerungen und die verschiedenen APIs, mit denen Sie sie verwenden können, sind in der Tabelle aufgeführt: Sie können mehrere Verfeinerungen durch Komma getrennt hinzufügen, solange sie sich nicht widersprechen.
Verfeinerung | Definition | Unterstützte API | Standardverhalten |
---|---|---|---|
RemoveUserHistory | Entfernt Artikel, die der Benutzer bereits gekauft hat, sodass sie dem Benutzer nicht erneut empfohlen werden. | alle APIs | Standardmäßig nur für die 'Get User Picks' API aktiviert. |
KeepUserHistory | Behält die Historie der vom Benutzer gekauften Artikel, die der Empfehlungsdienst für denselben Benutzer erneut in Betracht ziehen kann. | alle APIs | Standardmäßig aktiviert für alle APIs außer 'Get User Picks'. |
EnableShuffling | Ändert die Reihenfolge der Artikel geringfügig, ohne die Relevanz wesentlich zu beeinflussen, damit Benutzer nicht immer wieder die gleichen Empfehlungen sehen. | alle APIs | Standardmäßig nur für die 'Get User Picks' API aktiviert. |
DeaktivierenSie | Behält die Reihenfolge der empfohlenen Artikel bei, ohne die Ergebnisse zu mischen. | alle APIs | Standardmäßig aktiviert für alle APIs außer 'Get User Picks'. |
Siehe auch
Übersicht über den Datenvertrag
Zuordnungstabelle der Datenentitäten
Katalog-Datenentitäten
Interaktions-Datenentitäten
Reco-Konfigurations-Datenentitäten
Ausgewählte Benutzer-Datenentitäten
Datenentitäten externen Listen
Datenentitäten zu Bild-zu-Artikel-Zuordnung
Intelligent Recommendations API
Schnellstarthandbuch: Intelligent Recommendations mit Beispieldaten festlegen und ausführen