Rekomendacje wzbogacania encji danych
Ten artykuł zawiera wskazówki dotyczące konfigurowania jednostek danych wzbogacania rekomendacji w kontrakcie dotyczącym danych Intelligent Recommendations.
Omówienie jednostek danych
Jednostka danych to zestaw plików tekstowych dotyczących danych zawierający listę kolumn (nazywanych również atrybutami) oraz wiersze zawierające wartości rzeczywistych danych.
Intelligent Recommendations definiują grupy logiczne obiektów danych, z których każdy ma własny cel.
Uwaga
Encje danych są opcjonalne (chyba że określono inaczej), co oznacza, że ich dane mogą być puste lub brakujące.
Przejdź do pełnej listy jednostek danych
Wprowadzenie
Intelligent Recommendations obsługują ręczne wzbogacanie generowanych rekomendacji, co umożliwia ręczne dodawanie lub usuwanie określonych pozycji lub wariantów pozycji z dowolnej listy rekomendacji.
Obsługiwane akcje wzbogacenia są:
Uwzględnij: Dodaje określony element lub wariant elementu w górnej części określonej listy. Te ręcznie dodane elementy zostaną posortowane według ich atrybutu Klasyfikacja .
Wykluczanie: określony element lub wariant elementu jest usuwany z określonej listy, niezależnie od klasyfikacji elementu na tej liście.
Dostępność elementu jest zawsze respektowana. Żaden element nie jest uznawany za dostępny w momencie, gdy jest wywoływany interfejs API rekomendacji, nie zostanie zwrócony jako część odpowiedzi.
Następujące encje danych są częścią rekomendacji dotyczących wzbogacania danych:
Przejdź do pełnej listy jednostek danych
Wzbogacanie rekomendacji dla określonego elementu
Nazwa encji danych:Reco_SeededRecommendationsEnrichment
Description: Wzbogacenie wyników rekomendacji dla określonego elementu przy użyciu elementu ItemId znanego jako SeedItemId. Dotyczy to jedynie list, takich jak „Osoby również takie”, które są wydedytowane poza określonym elementem.
Atrybuty:
| Nazwa/nazwisko | Typ danych | Obowiązkowy | Domyślna wartość | Nieprawidłowe zachowanie wartości | Komentarze |
|---|---|---|---|---|---|
| RecoListName | String | Tak | Wartość trymu | W przypadku obsługiwanych nazw list należy przejść do tabeli ListNames. | |
| AlgoType | String | Nie. | Wartość trymu | Nie wszystkie nazwy list wymagają ustawienia tej wartości. W tabeli AlgoTypes dla obsługiwanych typów algorytmu dla każdej nazwy listy. | |
| SeedItemId | Ciąg(16) | Tak | Wpisanie do rejestru zrzutów | Lista ItemId jest zalecane. Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji, aby uzyskać identyfikator elementu. | |
| SeedItemVariantId | Ciąg(16) | Nie. | Wpisanie do rejestru zrzutów | Lista ItemVariantId jest zalecana. Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji, aby uzyskać identyfikator wariantu elementu. | |
| ItemId | Ciąg(16) | Tak | Wpisanie do rejestru zrzutów | Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji, aby uzyskać identyfikator elementu. | |
| ItemVariantId | Ciąg(16) | Nie. | Wpisanie do rejestru zrzutów | Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji, aby uzyskać identyfikator wariantu elementu. | |
| EnrichmentAction | String | Tak | Wpisanie do rejestru zrzutów | Obsługuje tylko Uwzględnij lub Wyklucz. | |
| Ranga | Int | Nie. | Wpisanie do rejestru zrzutów | Dla akcji Wykluczanie wzbogacenia ta wartość zostanie zignorowana. |
Wytyczne:
Oznaczone elementy mogą być dodawane tylko u góry wygenerowanej listy rekomendacji.
Wykluczenie elementu z listy, na której go nie ma, nic nie da.
Wyłączenie zawsze jest wykluczane. Jeśli oba te elementy zostaną uwzględnić i wykluczyć z tej samej listy, będą one wyłączone z końcowej odpowiedzi interfejsu API.
Atrybut Klasyfikacja określa jedynie kolejność między dodanymi elementami a uporządkowaniami elementów. W każdym przypadku będą one zawsze dodawane do górnej części listy. Jeśli istnieją zduplikowane wartości klasyfikacji dla wielu elementów, zostaną one dodane w losowo wybranej kolejności.
Wzbogacanie z nieobsługiwaną wartością AlgoType zostanie zignorowane.
Przykładowe dane:
Nagłówki są wyświetlane jedynie dla ułatwienia i nie powinny być częścią rzeczywistych danych.
| RecoListName | AlgoType | SeedItemId | SeedItemVariantId | ItemId | ItemVariantId | EnrichmentAction | Ranga |
|---|---|---|---|---|---|---|---|
| Podobne | MF | Element1 | Element2 | Uwzględnij | 1 | ||
| Podobne | MF | Element1 | Item3 | Item3Var1 | Uwzględnij | 2 | |
| Podobne | DAS | Item3 | Item3Var1 | Element1 | Item1Var2 | Wyklucz | |
| Koszyk | Item3 | Element1 | Item1Var1 | Uwzględnij | 1 |
Wzbogacanie rekomendacji
Nazwa encji danych:Reco_RecommendationsEnrichment
Opis: Wzbogacenie wyników rekomendacji
Atrybuty:
| Nazwa/nazwisko | Typ danych | Obowiązkowy | Domyślna wartość | Nieprawidłowe zachowanie wartości | Komentarze |
|---|---|---|---|---|---|
| RecoListName | String | Tak | Wartość trymu | W przypadku obsługiwanych nazw list należy przejść do tabeli ListNames. | |
| ItemId | Ciąg(16) | Tak | Wpisanie do rejestru zrzutów | Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji, aby uzyskać identyfikator elementu. | |
| ItemVariantId | Ciąg(16) | Nie. | Wpisanie do rejestru zrzutów | Przejdź do Scenariusz wymaganych encji danych w scenariuszu rekomendacji, aby uzyskać identyfikator wariantu elementu. | |
| EnrichmentAction | String | Tak | Wpisanie do rejestru zrzutów | Obsługuje tylko Uwzględnij lub Wyklucz. | |
| Ranga | Int | Nie. | Wpisanie do rejestru zrzutów | Dla akcji Wykluczanie wzbogacenia ta wartość zostanie zignorowana. |
Wytyczne:
- Tak samo jak Reco_SeededRecommendationsEnrichment.
Przejdź do pełnej listy jednostek danych
Nazwy ListNames, Udoskonalenia i AlgoTypes
Tabela ListNames
Poniżej znajduje się bieżąca lista dostępnych nazw ListNames.
| ListName | Rozliczenia (standardowe/premium) | Zestaw funkcji modelowania |
|---|---|---|
| BrowseLists | Standardowa | Podstawowe |
| ExternalLists | Standardowa | Podstawowe |
| PeopleAlso | Standardowa | Podstawowe |
| NextBestAction (formalnie „Koszyk”) | Standardowa | Podstawowe |
| Wybory | Standardowa | Standardowa |
| ViewedInSession | Standardowa | Standardowa |
| VisualSimilarity | Premium | Premium |
| TextualSimilarity | Premium | Premium |
Tabela AlgoTypes
Poniżej znajduje się tabela dostępnych typów AlgoType i różnych interfejsów API, z którymi można ich używać.
| AlgoType | opis | Obsługiwane API |
|---|---|---|
| RecentPurchases | Zalecenia dotyczące wyboru są obliczane na podstawie najnowszych zakupów (lub innej interakcji) użytkownika. | Dostępne tylko za pomocą Interfejsu API wyboru użytkownika. |
| RecentViews | Rekomendacje typów są obliczane na podstawie najnowszej historii przeglądania i preferencji użytkownika. | Dostępne tylko za pomocą Interfejsu API wyboru użytkownika. |
| FullHistory | Rekomendacje typów są obliczane na podstawie pełnej historii zakupów (lub innych interakcji) użytkownika. | Dostępne tylko za pomocą Interfejsu API wyboru użytkownika. |
| Współczynnik macierzy (MF) | Domyślny widok dla interfejsu API Podobne. | Dostępne tylko przy użyciu podobnego interfejsu API. |
| Element wizualny | Podobieństwa elementów są obliczane na podstawie wizualnego podobieństwa obrazów katalogu. | Dostępne tylko przy użyciu podobnego interfejsu API. |
| Tekstowy | Podobieństwa elementów są obliczane na podstawie tekstu (znajomości języka) podobieństw tekstowych i opisów katalogu. | Dostępne tylko przy użyciu podobnego interfejsu API. |
| BringSimilarItems | Na obrazie złożonym ten typ algotype zasugeruje elementy wizualne podobne do elementów zidentyfikowanych na obrazie złożonym. | Dostępne tylko przy użyciu podobnego interfejsu API. |
| CompleteSimilarStyles | Po otrzymaniu elementu początkowego ten AlgoType zasugeruje inne złożone obrazy o podobnych stylach, które są podobne do elementu początkowego. | Dostępne tylko przy użyciu podobnego interfejsu API. |
| CompleteSimilarItems | Po otrzymaniu elementu początkowego ten AlgoType zasugeruje elementy z innych obrazów złożonych, które są podobne do elementu początkowego. | Dostępne tylko przy użyciu podobnego interfejsu API. |
| DAS | „DAS” to skrót od Direct Associated Scoring. Ten AlgoType zapewnia rekomendacje oparte na podobieństwach przy użyciu współwystępowania elementów w jednostce danych interakcji. Ten Algotyp jest domyślnym dla interfejsu API NextBestAction. | Dostępne tylko z podobnym API i NextBestAction API (formalnie nazywanym „Koszykiem”). |
Tabela udoskonaleń
Poniżej znajduje się tabela dostępnych typów AlgoType, Udoskonaleń i różnych interfejsów API, z którymi można ich używać. Możesz dodać wiele udoskonaleń oddzielonych przecinkami, o ile nie są one sprzeczne ze sobą.
| Udoskonalenia | Definicja | Obsługiwane API | zachowanie domyślne |
|---|---|---|---|
| RemoveUserHistory | Usuwa przedmioty, które użytkownik już zakupił, aby nie były one ponownie polecane temu użytkownikowi. | Wszystkie API | Domyślnie włączone tylko dla interfejsu API "Uzyskaj wybory użytkownika". |
| KeepUserHistory | Przechowuje historię zakupów dokonanych przez użytkownika, aby serwis rekomendacji mógł ponownie wziąć pod uwagę tego samego użytkownika. | Wszystkie API | Domyślnie włączone dla wszystkich interfejsów API, z wyjątkiem "Pobierz wybór użytkownika". |
| EnableShuffling | Nieznacznie zmienia kolejność elementów, nie wpływając znacząco na ich trafność, aby użytkownicy nie widzieli ciągle tych samych rekomendacji. | Wszystkie API | Domyślnie włączone tylko dla interfejsu API "Uzyskaj wybory użytkownika". |
| DisableShuffling | Zachowuje kolejność polecanych elementów bez przemieszczania wyników. | Wszystkie API | Domyślnie włączone dla wszystkich interfejsów API, z wyjątkiem "Pobierz wybór użytkownika". |
Zobacz też
Omówienie kontraktu danychTabela mapowania encji danychEncje katalogu danychEncje danych interakcjiJednostki danych konfiguracji RecoEncje danych użytkowników, z których nie można zrezygnowaćElementy danych wykazów zewnętrznychOdwzorowanie obrazu na elementy danychIntelligent Recommendations APIPrzewodnik szybkiego startu: Skonfiguruj i uruchom Intelligent Recommendations z przykładowymi danymi