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 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) 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) 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 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 Valore di ritaglio Vai alla Tabella ListNames per i nomi degli elenchi supportati.
ItemId Stringa(16) 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 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:

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