Entità catalogo dati

Questo articolo fornisce informazioni su come configurare le entità di dati di catalogo 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.

Vai all'elenco completo delle entità di dati

Introduzione alle entità di dati di catalogo

L'entità di dati di catalogo rappresenta tutti gli articoli e le varianti di articoli candidati per la visualizzazione nei risultati di raccomandazioni. I candidati sono determinati dall'applicazione di disponibilità agli articoli, una data che indica al sistema di includere un articolo nei risultati delle raccomandazioni. Senza una disponibilità valida, gli articoli vengono ignorati quando vengono restituiti i risultati.

Raccomandazioni intelligenti supporta le seguenti funzionalità e scenari:

• Articoli che hanno più varianti (ad esempio una camicia in taglie o colori diversi) o nessuna variazione. Ci riferiamo a queste variazioni come varianti. Gli articoli che non hanno varianti vengono chiamati articoli autonomi, mentre gli articoli che hanno almeno una variante vengono chiamati anagrafica articolo.

• Assegnazione di valori di filtro agli articoli (ad esempio, categoria, colore o dimensione). Successivamente, quando si esegue la query per le raccomandazioni, puoi filtrare in base a questi valori di filtro.

• Assegnazione di immagini agli articoli.

• Gli articoli possono essere disponibili all'interno di diverse entità logiche all'interno dell'organizzazione. Raccomandazioni intelligenti supporta due livelli di gerarchie:

  • Canale: gli articoli possono essere assegnati a un canale, consentendo a Raccomandazioni intelligenti di fornire consigli mirati solo ai prodotti inclusi in un canale specifico. Tutti gli articoli vengono automaticamente associati al canale predefinito, che utilizza la stringa 0 (zero) come ID canale riservato.

    Esempio:

    In questo esempio, il set di dati contiene solo tre articoli: X, Y e Z. Questi tre elementi vengono assegnati automaticamente al canale predefinito (Canale=0). Puoi anche assegnare questi articoli ai tuoi canali personalizzati. Ad esempio, puoi assegnare gli articoli X e Y a Canale=C1 e gli articoli Y e Z a Canale=C2.

    Pertanto, quando richiedi consigli, puoi passare questi altri parametri di query:

    • Nessun parametro del canale (uguale al canale predefinito): tutti e tre gli articoli possono essere restituiti nella risposta
    • Canale=0: come nessun parametro poiché questo è il canale predefinito
    • Canale=C1: solo gli articoli che appartengono al canale C1 (articoli X e Y) possono essere restituiti nella risposta
    • Canale=C2: solo gli articoli che appartengono al canale C2 (articoli Y e Z) possono essere restituiti nella risposta
    • Canale=SomethingElse: risposta vuota perché questo canale non è stato definito e non gli è stato assegnato alcun articolo

  • Catalogo: un catalogo è un altro livello più fine di granularità della disponibilità. Consente di definire più cataloghi all'interno di un canale e ottenere raccomandazioni per cataloghi specifici. Simile a un canale, tutti gli articoli vengono automaticamente associati al catalogo predefinito all'interno di un canale, che utilizza la stringa 0 (zero) come ID catalogo riservato.

    Esempio:

    Proseguendo con l'esempio del Canale, hai gli articoli X, Y e Z. Hai assegnato gli articoli X e Y al canale C1 e vengono assegnati automaticamente al catalogo predefinito nel canale (utilizzando Catalogo=0). Puoi avere un'ulteriore granularità assegnando questi articoli a cataloghi personalizzati all'interno del canale. Assegniamo l'articolo X a Catalogo=A e gli articoli X e Y a Catalogo=B.

    Pertanto, quando richiedi consigli, puoi passare questi altri parametri di query:

    • Canale=C1: nessun parametro del catalogo, è uguale al catalogo predefinito. Entrambi gli articoli X e Y possono essere restituiti nella risposta.
    • Channel=C1&Catalog=0: come il parametro nessun catalogo perché è il catalogo predefinito.
    • Channel=C1&Catalog=A: solo gli articoli che appartengono al catalogo A nel catalogo C1 (solo articolo X) possono essere restituiti nella risposta.
    • Channel=C1&Catalog=B: solo gli articoli che appartengono al catalogo B nel catalogo C1 (articoli X e Y) possono essere restituiti nella risposta.
    • Channel=C1&Catalog=SomethingElse: risposta vuota perché questo catalogo non è stato definito nel canale C1 e non gli è stato assegnato alcun articolo.

• Dichiara la disponibilità degli articoli:

  • Date di inizio/fine disponibilità: gli articoli che non rientrano nel loro intervallo di tempo di disponibilità saranno esclusi dalla risposta alla raccomandazione.
  • Granularità fine della disponibilità: definisci le date di inizio/fine all'interno di ID canale/catalogo specifici.

Il catalogo è composto da diverse entità di dati, tutte facoltative (a seconda delle funzionalità che si desidera utilizzare) e possono rimanere vuote (o mancanti) dalla cartella radice di Raccomandazioni intelligenti. Segui le linee guida nell'entità di dati Reco_ItemsAndVariants, descritta di seguito, se non desideri fornire questa entità dati.

Elenco delle entità di dati di catalogo

Fanno parte del catalogo le seguenti entità di dati:

• Articoli e varianti
• Categorie articoli
• Immagini di articoli e varianti
• Filtri di articoli e varianti
• Disponibilità di articoli e varianti

Vai all'elenco completo delle entità di dati

Articoli e varianti

Nome entità dati:Reco_ItemsAndVariants

Descrizione: Tutti gli articoli e le varianti di articolo

Attributi:

Linee guida:

• Le varianti articolo ereditano gli attributi della loro anagrafica articolo. Ad esempio, se una variante articolo non ha titolo, eredita il titolo della sua anagrafica articolo (ovvero la riga con lo stesso ItemId ma con un ItemVariantId vuoto) se esiste.

• ItemIds può avere una relazione uno a molti con ItemVariantIds. È possibile che un singolo ItemId sia mappato a più di un ItemVariantId per acquisire la relazione tra un'anagrafica articolo e le sue varianti articolo. È possibile avere una voce singola per una combinazione di ItemId e ItemVariantId specifica senza specificare altre combinazioni di ItemId e ItemVariantId.

• L'attributo ReleaseDate rappresenta la data in cui l'articolo è stato rilasciato (pubblicato, introdotto) sul mercato. Questo attributo è diverso dalla disponibilità di un articolo (quando un articolo/prodotto può essere restituito in una chiamata API), ma ReleaseDate potrebbe essere utilizzato in scenari come Nuovo e Di tendenza, che si basano sulle date per ordinare gli articoli.

• Se questa entità di dati è vuota (o mancante), Raccomandazioni intelligenti utilizzerà automaticamente tutti gli articoli e le varianti di articoli trovati nell'entità di dati Reco_Interactions come insieme di articoli del catalogo e assegna a ciascun articolo e variante articolo il titolo, la descrizione e la data di rilascio predefiniti. Questi articoli vengono considerati come sempre disponibile a meno che non siano state assegnate disponibilità esplicite nell'entità di dati Reco_ItemAndVariantAvailabilities.

• Raccomandazioni intelligenti può utilizzare gli attributi Titolo e Descrizione per fornire consigli testuali. Poiché Raccomandazioni intelligenti attualmente supporta solo le impostazioni locali en-us per le raccomandazioni testuali, fornendo l'estensione Titolo e Descrizione in qualsiasi altra impostazione locale potrebbe degradare la qualità dei suggerimenti testuali.

Dati di esempio:

Le intestazioni vengono visualizzate solo per comodità e non dovrebbero far parte dei dati effettivi.

Torna all'elenco delle entità di dati di catalogo

Categorie articoli

Nome entità dati:Reco_ItemCategories

Descrizione: tutte le categorie di articoli.

Attributi:

Linee guida:

• Ogni ItemId può avere più categorie, il che significa che può apparire in più voci nei dati.

• Se i tuoi dati sono costruiti utilizzando alberi di categoria, devi fornire l'insieme completo di categorie (semplice) per ogni elemento.

Dati di esempio:

Le intestazioni vengono visualizzate solo per comodità e non dovrebbero far parte dei dati effettivi.

Torna all'elenco delle entità di dati di catalogo

Immagini di articoli e varianti

Nome entità dati:Reco_ItemAndVariantImages

Descrizione: Tutte le immagini di articoli e varianti di articolo

Attributi:

Linee guida:

• È necessario assegnare esplicitamente le immagini a un ItemId e ad ogni relativo ItemVariantId. Le immagini assegnate a un articolo non vengono assegnate automaticamente a tutte le varianti di articolo e viceversa. Le immagini assegnate a una variante di articolo non vengono assegnate automaticamente all'anagrafica articolo di tale variante.

• Se più di un'immagine primaria è specificata per la stessa combinazione <ItemId, ItemVariantId>, solo una di queste immagini verrà utilizzata per la fase di inferenza delle raccomandazioni visive e le altre verranno utilizzate solo durante il training dell'intero modello visivo.

• Per qualsiasi immagine a cui Raccomandazioni intelligenti non riesce ad accedere, l'URL dell'immagine viene ignorato e non utilizzato per il modello di raccomandazione.

• Se il valore IsPrimaryImage non è valido, verrà utilizzato un valore di falso (ad esempio, immagine non primaria).

• Se per un articolo o una variante di articolo sono state specificate solo immagini non primarie, Raccomandazioni intelligenti utilizza una delle immagini specificate come immagine principale per fornire comunque consigli visivi per tale articolo o variante di articolo.

• Sono supportati due tipi di URL:

  • URL HTTPS pubblicamente disponibili: non richiede un'intestazione Autorizzazione. Questo URL non include gli URL dei BLOB di Azure disponibili pubblicamente/in modo anonimo, che non sono supportati.
  • URL di archiviazione BLOB di Azure che richiedono l'autenticazione: non sono disponibili pubblicamente/in modo anonimo. Le autorizzazioni per la lettura dei BLOB di immagini devono essere concesse a Raccomandazioni intelligenti, come spiegato in Distribuire Raccomandazioni intelligenti). Gli URL BLOB devono iniziare con il prefisso: https://<StorageAccountName>.blob.core.windows.net/.

• La dimensione massima supportata per una singola immagine è 512 KB. Qualsiasi immagine di dimensioni superiori a 512 KB verrà ignorata dal sistema.

• Il ContentType per l'immagine deve avere un tipo di contenuto immagine (dovrebbe iniziare con Immagine). Questo requisito si applica a tutte le immagini, sia disponibili tramite HTTPS che BLOB di immagini (tramite la proprietà ContentType del BLOB).

Dati di esempio:

Le intestazioni vengono visualizzate solo per comodità e non dovrebbero far parte dei dati effettivi.

Torna all'elenco dei tipi di entità del catalogo

Filtri di articoli e varianti

Nome entità dati:Reco_ItemAndVariantFilters

Descrizione: proprietà dell'articolo e della variante dell'articolo utilizzate per il filtraggio dei risultati di runtime

Attributi:

Linee guida:

• Gli articoli e le varianti di articolo hanno una relazione padre-figlio. Ciò significa che le varianti articolo erediteranno i filtri della loro anagrafica articolo. Ad esempio, se il filtro "Colore" è stato dichiarato per un determinato ItemId, tutte le varianti di articolo dello stesso ItemId ottengono lo stesso valore del filtro "Colore", a meno che non sia stato specificato un valore "Colore" diverso per la variante dell'articolo.

• I tipi di filtri testuali supportano l'operazione di filtro "uguale a". Ad esempio, le richieste API possono filtrare gli articoli con "Colore"="Blu".

• I tipi di filtri numerici supportano le operazioni di filtro "intervallo". Ad esempio, le richieste API possono filtrare gli articoli con "Dimensione" > 40..

• È possibile assegnare più valori di filtro allo stesso filtro. Ad esempio, per il filtro "Colore", puoi fornire più valori, come "Verde" e "Blu". In questo esempio, il relativo articolo ha due valori per il filtro "Colore" e verrà restituito quando filtri per articoli "Verdi" o "Blu". Per assegnare più valori allo stesso filtro, aggiungi una voce per ogni valore di filtro che desideri assegnare, utilizzando gli stessi valori FilterName e FilterType.

• Per ogni FilterName, una variante di articolo può ereditare i valori del filtro padre o sostituirli. L'unione dei due non è supportata. Per impostazione predefinita, se la variante non ha valori assegnati a un filtro, eredita i valori del filtro dell'elemento padre. Se almeno un valore di filtro è assegnato a un filtro per una variante di articolo, viene attivata la modalità di sostituzione e solo i valori di filtro della variante sono attivi (solo per il filtro specifico). Questo valore indica che per ottenere un comportamento di "unione", la variante dell'articolo deve ripetere i valori del filtro padre. Ad esempio, un articolo supporta due colori, blu e verde. Se una variante supporta un altro colore, il rosso, la variante deve elencare tutti e tre i colori assegnati all'ID variante: blu, verde e rosso. In questo esempio, la variante dell'articolo ha sovrascritto i valori per il filtro "Colore", ma può comunque ereditare i valori per altri filtri dal suo articolo padre.

• Le voci con tipi di filtro non supportati verranno ignorate.

• Puoi fornire fino a 20 diversi attributi FilterName.

• Fornire più voci con lo stesso FilterName ma un diverso FilterType genera un errore nel processo di inserimento dati delle raccomandazioni intelligenti.

• Gli articoli o le varianti degli articoli non possono avere filtri specificati. Se specifichi un filtro nella richiesta API, gli articoli o le varianti degli articoli senza il filtro specificato verranno esclusi.

Dati di esempio:

Le intestazioni vengono visualizzate solo per comodità e non dovrebbero far parte dei dati effettivi.

Torna all'elenco dei tipi di entità del catalogo

Disponibilità di articoli e varianti

Nome entità dati:Reco_ItemAndVariantAvailabilities

Descrizione: Tutte le disponibilità di articoli e varianti di articolo

Attributi:

Linee guida:

• Promemoria: le disponibilità indicano al sistema quali articoli o varianti di articoli sono considerati candidati per i risultati dei suggerimenti.

• La disponibilità di una variante articolo è l'unione delle disponibilità della sua anagrafica articolo con la disponibilità della variante articolo stessa. Anche le varianti articolo che non hanno voci ereditano le disponibilità dell'anagrafica articolo.

• Un articolo mancante da questa entità dati sarà considerato sempre disponibile nel canale e nel catalogo predefiniti. Più specificamente, Raccomandazioni intelligenti si comporta esattamente come se l'articolo fosse visualizzato nei dati con valori predefiniti per tutti gli attributi.

• ItemIds ha una relazione uno a molti con ItemVariantIds. Mentre un ItemId non è necessario per avere un ItemVariantId, è possibile che più di un ItemVariantId possa essere mappato su un singolo ItemId. Ad esempio, puoi aggiungere una voce per una specifica combinazione di ItemId e ItemVariantId senza aggiungere esplicitamente un'altra voce per l'attributo ItemId (e un ItemVariantId vuoto). Quando si determina se le varianti articolo hanno disponibilità valide, vengono considerate disponibili solo le varianti articolo specificate (agli intervalli di tempo specificati per ciascuna variante).

• Un catalogo è rilevante solo nel contesto di un canale (i cataloghi sono un sottoinsieme del canale). Ad esempio, catalog=MySale in canale=Europa è un catalogo diverso da catalog=MySale in canale=Asia.

• Se il tuo set di dati contiene più canali e cataloghi, devi aggiungere una voce per ogni canale pertinente e combinazione di catalogo per ogni articolo rilevante e variante di articolo.

• Le date di disponibilità sono rilevanti solo per il canale e il catalogo specifici specificati. Se desideri specificare le stesse date di disponibilità per canali e cataloghi diversi, devi aggiungere esplicitamente una voce per ogni canale e catalogo.

• Se è presente un valore non valido per uno degli attributi StartDate o EndDate, l'intera voce viene modificata per rappresentare un elemento non disponibile. I valori StartDate e EndDate vengono sovrascritti con DateTime che sono nel passato.

• L'attributo doppio può essere lasciato vuoto.

• Non utilizzare "0" come valore per "Canale". Questo valore è riservato al sistema. L'utilizzo di "0" comporterà un errore di elaborazione.

Dati di esempio:

Le intestazioni vengono visualizzate solo per comodità e non dovrebbero far parte dei dati effettivi.

Torna all'elenco dei tipi di entità del catalogo

Vedi anche

Panoramica del contratto dati
Tabella dei mapping di entità di dati
Entità di dati di interazioni
Entità di dati configurazione racomandazioni
Entità dati utenti rifiuto esplicito
Entità di dati elenchi esterni
Entità di dati di arricchimento raccomandazioni
Entità di dati di mapping da immagine a articolo
API di Raccomandazioni intelligenti
Guida rapida: impostare ed eseguire Raccomandazioni intelligenti con dati di esempio