Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
GetPersonalizedRanking
Riordina un elenco di elementi consigliati per un determinato utente. Il primo elemento dell'elenco è considerato quello con più probabilità di interesse per l'utente.
Nota
La soluzione di supporto della campagna deve essere stata creata con una ricetta di tipo PERSONALIZED_RANKING.
Sintassi della richiesta
POST /personalize-ranking HTTP/1.1
Content-type: application/json
{
"campaignArn": "string
",
"context": {
"string
" : "string
"
},
"filterArn": "string
",
"filterValues": {
"string
" : "string
"
},
"inputList": [ "string
" ],
"metadataColumns": {
"string
" : [ "string
" ]
},
"userId": "string
"
}
Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- campaignArn
-
L'Amazon Resource Name (ARN) della campagna da utilizzare per generare il ranking personalizzato.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+
Campo obbligatorio: sì
- context
-
I metadati contestuali da utilizzare per ricevere consigli. I metadati contestuali includono tutte le informazioni di interazione che potrebbero essere rilevanti per ottenere i consigli di un utente, come la posizione corrente dell'utente o il tipo di dispositivo.
Tipo: mappatura stringa a stringa
Voci sulla mappa: numero massimo di 150 elementi.
Limiti di lunghezza della chiave: lunghezza massima di 150.
Modello di chiave:
[A-Za-z\d_]+
Limiti di lunghezza del valore: lunghezza massima di 1000.
Campo obbligatorio: no
- filterArn
-
L'Amazon Resource Name (ARN) di un filtro che hai creato per includere o escludere articoli dai consigli per un determinato utente. Per ulteriori informazioni, consulta la pagina con le indicazioni per filtrare le raccomandazioni.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+
Campo obbligatorio: no
- filterValues
-
I valori da utilizzare per filtrare i consigli. Per ogni parametro segnaposto nell'espressione di filtro, fornite il nome del parametro (in caso di corrispondenza tra maiuscole e minuscole) come chiave e il valore o i valori del filtro come valore corrispondente. Separa più valori per un parametro con una virgola.
Per le espressioni di filtro che utilizzano un
INCLUDE
elemento per includere elementi, è necessario fornire valori per tutti i parametri definiti nell'espressione. Per i filtri con espressioni che utilizzano unEXCLUDE
elemento per escludere elementi, puoi ometterefilter-values
.In questo caso, Amazon Personalize non utilizza quella parte dell'espressione per filtrare i consigli.Per ulteriori informazioni, consulta la pagina con le indicazioni per filtrare le raccomandazioni.
Tipo: mappatura stringa a stringa
Voci sulla mappa: numero massimo di 25 elementi.
Limiti di lunghezza della chiave: lunghezza massima di 50.
Modello di chiave:
[A-Za-z0-9_]+
Limiti di lunghezza del valore: lunghezza massima di 1000.
Campo obbligatorio: no
- inputList
-
Un elenco di elementi (per
itemId
) da classificare. Se un elemento non è stato incluso nel set di dati di addestramento, l'elemento viene aggiunto alla fine dell'elenco riclassificato. Se includi i metadati nei consigli, il massimo è 50. Altrimenti, il massimo è 500.Tipo: matrice di stringhe
Limitazioni di lunghezza: lunghezza massima di 256.
Campo obbligatorio: sì
- metadataColumns
-
Se hai abilitato i metadati nei consigli quando hai creato o aggiornato la campagna, specifica le colonne di metadati del set di dati Items da includere nella classifica personalizzata. La chiave della mappa è
ITEMS
e il valore è un elenco di nomi di colonne dal set di dati Items. Il numero massimo di colonne che puoi fornire è 10.Per informazioni sull'abilitazione dei metadati per una campagna, consulta Attivazione dei metadati nei consigli per una campagna.
Tipo: mappatura da stringa a matrice di stringhe
Voci sulla mappa: numero massimo di 1 elemento.
Limiti di lunghezza della chiave: lunghezza massima di 256.
Membri dell'array: numero massimo di 99 elementi.
Vincoli di lunghezza: lunghezza massima di 150.
Campo obbligatorio: no
- userId
-
L'utente per il quale desideri che la campagna fornisca un posizionamento personalizzato.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Campo obbligatorio: sì
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"personalizedRanking": [
{
"itemId": "string",
"metadata": {
"string" : "string"
},
"promotionName": "string",
"reason": [ "string" ],
"score": number
}
],
"recommendationId": "string"
}
Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- personalizedRanking
-
Un elenco di elementi in ordine di maggiore probabile interesse per l'utente. Il massimo è 500.
Tipo: matrice di oggetti PredictedItem
- recommendationId
-
L'ID della raccomandazione.
▬Tipo: stringa
Errori
- InvalidInputException
-
Fornisci un valore valido per il campo o il parametro.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
La risorsa specificata non esiste.
Codice di stato HTTP: 404
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: