Entità di dati di arricchimento raccomandazioni
Questo articolo fornisce informazioni su come configurare le entità di dati di arricchimento delle raccomandazioni nel contratto dati di Raccomandazioni intelligenti.
Revisione delle entità di dati
Una entità di dati è un insieme di uno o più file di testo di dati, ciascuno con un elenco di colonne (chiamato anche attributi) e righe contenenti i valori dei dati effettivi.
Raccomandazioni intelligenti definisce gruppi logici di entità di dati, ciascuno con il proprio scopo.
Nota
Le entità dei dati sono considerate facoltative se non diversamente specificato, il che significa che i loro dati possono essere vuoti o mancanti.
Vai all'elenco completo delle entità di dati
Introduzione
Raccomandazioni intelligenti supporta l'arricchimento manuale delle raccomandazioni generate, che consente di aggiungere o rimuovere manualmente articoli specifici o varianti di articoli da qualsiasi elenco di raccomandazioni.
Le azioni di arricchimento supportate sono:
Includi: aggiunge l'articolo o la variante di articolo specificati in cima all'elenco specificato. Questi articoli aggiunti manualmente vengono ordinati in base al relativo attributo Classificazione.
Escludi: rimuove l'articolo specificato o la variante dell'articolo dall'elenco specificato, indipendentemente dalla classificazione dell'articolo in tale elenco.
Le disponibilità degli articoli sono sempre rispettate. Qualsiasi articolo non considerato disponibile nel momento in cui viene chiamata l'API di raccomandazione non viene restituito come parte della risposta.
Fanno parte delle entità dati di arricchimento delle raccomandazioni le seguenti entità di dati:
Vai all'elenco completo delle entità di dati
Arricchimento delle raccomandazioni per un articolo specifico
Nome entità dati:Reco_SeededRecommendationsEnrichment
Descrizione: Arricchimento dei risultati della raccomandazione per un articolo specifico utilizzando ItemId noto come SeedItemId. Si applica solo a elenchi come "Alle persone piace anche", in cui è stato escluso un articolo specifico.
Attributi:
| Nome | Tipo di dati | Obbligatorio | Default value | Comportamento del valore non valido | Commenti |
|---|---|---|---|---|---|
| RecoListName | Stringa | Sì | Valore di ritaglio | Vai alla Tabella ListNames per i nomi degli elenchi supportati. | |
| AlgoType | Stringa | No | Valore di ritaglio | Non tutti i nomi di elenchi richiedono l'impostazione di questo valore. Vedi la Tabella AlgoTypes per i tipo di algoritmi supportati per ogni nome di elenco. | |
| SeedItemId | Stringa(16) | Sì | Elimina voce | ItemId consigliato dall'elenco. Vedi Entità di dati obbligatorie per scenario di raccomandazioni per l'ID articolo. | |
| SeedItemVariantId | Stringa(16) | No | Elimina voce | ItemVariantId consigliato dall'elenco. Vedi Entità di dati obbligatorie per scenario di raccomandazioni per l'ID variante. | |
| ItemId | Stringa(16) | Sì | Elimina voce | Vedi Entità di dati obbligatorie per scenario di raccomandazioni per l'ID articolo. | |
| ItemVariantId | Stringa(16) | No | Elimina voce | Vedi Entità di dati obbligatorie per scenario di raccomandazioni per l'ID variante. | |
| EnrichmentAction | Stringa | Sì | Elimina voce | Supporta solo Includi o Escludi per adesso. | |
| Classificazione | Int | No | Elimina voce | Per l'azione di arricchimento Escludi, questo valore viene ignorato. |
Linee guida:
Gli articoli contrassegnati come includi possono essere aggiunti solo all'inizio di un elenco di suggerimenti generato.
L'esclusione di un articolo da un elenco in cui l'articolo non compare non avrà alcun effetto.
L'esclusione vince sempre. Se includi ed escludi lo stesso articolo dallo stesso elenco, viene escluso dalla risposta finale dell'API.
L'attributo Classificazione specifica solo l'ordine tra gli articoli aggiunti o le varianti di articolo. In ogni caso, verranno sempre aggiunti in cima alla lista. Se sono presenti valori di classificazione duplicati per più articoli, vengono aggiunti in un ordine casuale tra di loro.
Gli arricchimenti con un valore AlgoType non supportato vengono ignorati.
Dati di esempio:
Le intestazioni vengono visualizzate solo per comodità e non dovrebbero far parte dei dati effettivi.
| RecoListName | AlgoType | SeedItemId | SeedItemVariantId | ItemId | ItemVariantId | EnrichmentAction | Classificazione |
|---|---|---|---|---|---|---|---|
| simili | MF | Item1 | Item2 | Includi | 1 | ||
| simili | MF | Item1 | Item3 | Item3Var1 | Includi | 2 | |
| simili | DAS | Item3 | Item3Var1 | Item1 | Item1Var2 | Escludi | |
| Cartello | Item3 | Item1 | Item1Var1 | Includi | 1 |
Arricchimento raccomandazioni
Nome entità dati:Reco_RecommendationsEnrichment
Descrizione: arricchimento dei risultati delle raccomandazioni
Attributi:
| Nome | Tipo di dati | Obbligatorio | Default value | Comportamento del valore non valido | Commenti |
|---|---|---|---|---|---|
| RecoListName | Stringa | Sì | Valore di ritaglio | Vai alla Tabella ListNames per i nomi degli elenchi supportati. | |
| ItemId | Stringa(16) | Sì | Elimina voce | Vai a Entità di dati obbligatorie per scenario di raccomandazioni per l'ID articolo. | |
| ItemVariantId | Stringa(16) | No | Elimina voce | Vai a Entità di dati obbligatorie per scenario di raccomandazioni per l'ID variante. | |
| EnrichmentAction | Stringa | Sì | Elimina voce | Supporta solo Includi o Escludi per adesso. | |
| Classificazione | Int | No | Elimina voce | Per l'azione di arricchimento Escludi, questo valore viene ignorato. |
Linee guida:
- Uguale a Reco_SeededRecommendationsEnrichment.
Vai all'elenco completo delle entità di dati
ListName, AlgoType e perfezionamenti
Tabella di ListNames
L'elenco corrente dei ListName disponibili è riportato nella tabella:
| ListName | Fatturazione (standard/premium) | Set di funzionalità di modellazione |
|---|---|---|
| BrowseLists | Standard | Di base |
| ExternalLists | Standard | Di base |
| PeopleAlso | Standard | Di base |
| NextBestAction (formalmente "Cart") | Standard | Di base |
| Prelievi | Standard | Standard |
| ViewedInSession | Standard | Standard |
| VisualSimilarity | Premium | Premium |
| TextualSimilarity | Premium | Premium |
Tabella di AlgoTypes
Gli AlgoType disponibili e le diverse API con cui puoi utilizzarli sono riportati nella tabella:
| AlgoType | Descrizione | API supportata |
|---|---|---|
| RecentPurchases | I suggerimenti sulle scelte vengono calcolati in base agli acquisti più recenti (o altra interazione) dell'utente. | Disponibile solo con l'API scelte dall'utente. |
| RecentViews | I suggerimenti sulle scelte sono calcolati in base alla cronologia di visualizzazione più recente e alle preferenze dell'utente. | Disponibile solo con l'API scelte dall'utente. |
| FullHistory | I suggerimenti sulle scelte sono calcolati in base alla cronologia completa degli acquisti (o altra interazione) dell'utente. | Disponibile solo con l'API scelte dall'utente. |
| MF(Matrix Factorization) | Lla visualizzazione predefinita per l'API somiglianze. | Disponibile solo con l'API somiglianze |
| Rappresentazione grafica | Le somiglianze degli articoli vengono calcolate in base alle somiglianze visive delle immagini del catalogo. | Disponibile solo con l'API somiglianze. |
| Testuale | Le somiglianze degli articoli vengono calcolate in base alle somiglianze di titoli (comprensione del linguaggio) delle descrizioni di testo del catalogo. | Disponibile solo con l'API somiglianze. |
| BringSimilarItems | Quando viene fornita un'immagine composita, questo AlgoType suggerisce articoli visivamente simili agli articoli identificati nell'immagine composita. | Disponibile solo con l'API somiglianze. |
| CompleteSimilarStyles | Quando viene fornito un articolo seme, questo AlgoType suggerisce altre immagini composite di stili simili che sono simili all'articolo seme. | Disponibile solo con l'API somiglianze. |
| CompleteSimilarItems | Quando viene fornito un articolo seme, questo AlgoType suggerisce articoli di altre immagini composite che sono simili all'articolo seme. | Disponibile solo con l'API somiglianze. |
| DAS | "DAS" significa Direct Associated Scoring, punteggio associato diretto. Questo AlgoType fornisce suggerimenti basati su somiglianze che utilizzano co-occorrenze di articoli all'interno dell'entità dati interazioni. Questo Algotype è il valore predefinito per l'API NextBestAction. | Disponibile solo con API simile e API NextBestAction (formalmente chiamata "Cart"). |
Tabella di perfezionamenti
I perfezionamenti disponibili e le diverse API con cui puoi utilizzarli sono riportati nella tabella: Puoi aggiungere più perfezionamenti separati da virgola, purché non siano in contraddizione tra loro.
| Perfezionamento | Definizione | API supportata | Comportamento predefinito |
|---|---|---|---|
| RemoveUserHistory | Rimuove gli articoli che l'utente ha già acquistato in modo che non gli vengano consigliati nuovamente. | Tutte le API | Abilitato per impostazione predefinita solo per l'API "Ottieni scelte dell'utente". |
| KeepUserHistory | Conserva la cronologia degli articoli acquistati dall'utente che il servizio di raccomandazione può prendere nuovamente in considerazione per lo stesso utente. | Tutte le API | Abilitato per impostazione predefinita per tutte le API tranne "Ottieni scelte dell'utente". |
| EnableShuffling | Modifica leggermente l'ordine degli articoli senza influire in modo significativo sulla pertinenza, per impedire agli utenti di vedere gli stessi consigli più e più volte. | Tutte le API | Abilitato per impostazione predefinita solo per l'API "Ottieni scelte dell'utente". |
| DisableShuffling | Mantiene l'ordine degli articoli consigliati senza mescolare i risultati. | Tutte le API | Abilitato per impostazione predefinita per tutte le API tranne "Ottieni scelte dell'utente". |
Vedi anche
Panoramica del contratto dati
Tabella dei mapping di entità di dati
Entità di dati del catalogo
Entità di dati di interazioni
Entità di dati configurazione raccomandazioni
Entità dati utenti rifiuto esplicito
Entità di dati elenchi esterni
Entità di dati di mapping da immagine a articolo
API di Raccomandazioni intelligenti
Guida rapida: impostare ed eseguire Raccomandazioni intelligenti con dati di esempio