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 są sortowane według ich atrybutów Rankingu.
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 jest 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 te elementy zostaną uwzględnione i wykluczone z tej samej listy, są 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, są one dodane w losowo wybranej kolejności.
Ignorowane jest wzbogacanie z nieobsługiwaną wartością AlgoType.
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
Bieżąca lista dostępnych nazw ListNames jest podana w tabeli:
| 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
Dostępne typy AlgoTypes i różne interfejsy API, z których można korzystać, są podane w tabeli:
| AlgoType | Podpis | 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 sugeruje elementy wizualne podobne do elementów zidentyfikowanych na obrazie złożonym. | Dostępne tylko przy użyciu podobnego interfejsu API. |
| CompleteSimilarStyles | Kiedy jest dostępny element złożony, ten typ AlgoType sugeruje inne obrazy złożone o podobnych stylach, które są podobne do elementu porządku. | Dostępne tylko przy użyciu podobnego interfejsu API. |
| CompleteSimilarItems | Kiedy jest dostępny element złożony, ten typ AlgoType sugeruje obiekty z innych obrazów złożonych o podobnych stylach, które są podobne do elementu porządku. | 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ń
Dostępne precyzowania i różne interfejsy API, z których można korzystać, podano w tabeli: można dodać kilka doprecyzowań rozdzielonych przecinkami, o ile nie są one rozdzielane.
| Udoskonalenia | Definicja | Obsługiwane API | zachowanie domyślne |
|---|---|---|---|
| RemoveUserHistory | Usuwa elementy, które zostały już zakupione przez użytkownika, więc nie są one zalecane ponownie dla tego użytkownika. | 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 danych
Tabela mapowania encji danych
Encje katalogu danych
Encje danych interakcji
Jednostki danych konfiguracji Reco
Encje danych użytkowników, z których nie można zrezygnować
Elementy danych wykazów zewnętrznych
Odwzorowanie obrazu na elementy danych
Intelligent Recommendations API
Przewodnik szybkiego startu: Skonfiguruj i uruchom Intelligent Recommendations z przykładowymi danymi