Entità di dati elenchi esterni
Raccomandazioni intelligenti consente di curare gli elenchi di elementi creati manualmente. Questo elenco è utile, ad esempio, in uno scenario di avvio a freddo, in cui non disponi di dati sulle interazioni utente sufficienti per generare elementi consigliati significativi. Un altro scenario è la creazione di elenchi promozionali, ad esempio per una vendita "ritorno a scuola" o "scelte dell'editore".
In ogni caso, le disponibilità degli articoli sono sempre rispettate. Qualsiasi articolo che non è considerato disponibile nel momento in cui viene chiamata l'API di raccomandazione non viene restituito nella risposta.
Fanno parte delle entità dati di elenchi esterni le seguenti entità di dati:
Elenchi di elementi consigliati esterni
Nome entità dati: Reco_RecommendationsEnrichment
Descrizione: Elenchi esterni di raccomandazioni
Attributi:
| Nome | Tipo di dati | Obbligatorio | Default value | Comportamento del valore non valido | Commenti |
|---|---|---|---|---|---|
| ListName | Stringa(64) | Sì | Valore di ritaglio | Identificatore univoco dell'elenco, utilizzato anche quando si esegue una query per l'elenco. Lunghezza limitata a 64 caratteri. | |
| Titolo | Stringa(256) | Sì | Valore di ritaglio | Lunghezza limitata a 256 caratteri. | |
| ListAvailabilityStartDate | Data/Ora | No | 0001-01-01T00:00:00.000Z | Elimina voce | Vedi Entità di dati obbligatorie per scenario di raccomandazioni per i valori datetime. |
| ListAvailabilityEndDate | Data/Ora | No | 9999-12-31T23:59:59.999Z | Elimina voce | Vedi Entità di dati obbligatorie per scenario di raccomandazioni per i valori datetime. |
Linee guida:
Questa entità di dati è per uso futuro.
L'attributo ListName ha le seguenti restrizioni:
- Set di caratteri consentiti: A-Z, a-z, 0-9, _, -, ~, ..
- Nessuna distinzione tra maiuscole e minuscole.
- I valori RecoListName esistenti sono riservati e non possono essere utilizzati come valori ListName . Consulta l'elenco completo dei nomi riservati nella pagina delle entità di dati di arricchimento.
- Utilizzando le date di inizio e di fine della disponibilità dell'elenco, è possibile determinare la disponibilità dell'elenco, che Intelligent Recommendations può servire solo tra queste date specificate.
Dati di esempio:
Le intestazioni vengono visualizzate solo per comodità e non dovrebbero far parte dei dati effettivi.
| ListName | Titolo | ListAvailabilityStartDate | ListAvailabilityEndDate |
|---|---|---|---|
| SummerSale2020 | I migliori articoli estivi per il 2020 | 2020-07-01T00:00:00.000Z | 2020-08-31T23:59:59.999Z |
Elenchi di elementi consigliati esterni
Nome entità dati: Reco_ExternalRecommendationsItems
Descrizione: elementi per elenchi esterni di raccomandazioni
Attributi:
| Nome | Tipo di dati | Obbligatorio | Default value | Comportamento del valore non valido | Commenti |
|---|---|---|---|---|---|
| ListName | Stringa(64) | Sì | Valore di ritaglio | Identificatore univoco dell'elenco che è utilizzato anche quando si esegue una query per l'elenco. Lunghezza limitata a 64 caratteri. Puoi visualizzare la tabella di ListNames qui. | |
| ItemId | Stringa(16) | Sì | Elimina voce | Vedi Entità di dati obbligatorie per scenario di raccomandazioni per itemId. |
|
| ItemVariantId | Stringa(16) | No | Elimina voce | Vedi Entità di dati obbligatorie per scenario di raccomandazioni per itemVariantId. |
|
| Classificazione | Int | Sì | Elimina voce | L'ordine di posizione in cui desideri che ciascun elemento appaia. |
Linee guida:
Questa entità di dati è per uso futuro.
Vedi le linee guida ListName nell'entità dati Reco_ExternalRecommendationsLists.
Raccomandazioni intelligenti non garantisce l'ordinamento interno tra più elementi a cui è stato assegnato lo stesso livello nello stesso elenco.
Nel caso in cui lo stesso articolo o variante dell'articolo appaia in un elenco più di una volta, viene utilizzata la posizione più alta e tutte le altre voci vengono ignorate.
Per ciascun valore ListName in questa entità di dati, deve esserci una voce corrispondente con lo stesso valore ListName nell'entità di dati Reco_ExternalRecommendationsLists; in caso contrario, la voce viene ignorata.
Dati di esempio:
Le intestazioni vengono visualizzate solo per comodità e non dovrebbero far parte dei dati effettivi.
| ListName | ItemId | ItemVariantId | Classificazione |
|---|---|---|---|
| SummerSale2020 | Item2 | 1 | |
| SummerSale2020 | Item3 | Item3Var1 | 2 |
| SummerSale2020 | Item1 | Item1Var2 | 3 |
Vedi anche
Panoramica del contratto dati
Tabella dei mapping di entità di dati
Entità dati del catalogo
Entità di dati di mapping da immagine a articolo
Entità di dati di interazioni
Entità di dati configurazione raccomandazioni
Entità dati utenti rifiuto esplicito
Entità di dati di arricchimento raccomandazioni
API di Raccomandazioni intelligenti
Guida rapida: impostare ed eseguire Raccomandazioni intelligenti con dati di esempio