GetRecommendations - Amazon Personalize
Sintassi della richiestaParametri della richiesta URI:Corpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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à.

GetRecommendations

Restituisce un elenco di articoli consigliati. Per le campagne, è richiesto l'Amazon Resource Name (ARN) della campagna e l'input richiesto per l'utente e l'articolo dipende dal tipo di ricetta utilizzato per creare la soluzione a supporto della campagna, come segue:

  • USER_PERSONALIZATION: obbligatorio, non utilizzato userId itemId

  • RELATED_ITEMS: obbligatorio, non utilizzato itemId userId

Nota

Le campagne supportate da una soluzione creata utilizzando una ricetta di tipo PERSONALIZED_RANKING utilizzano l'API. GetPersonalizedRanking

Per i consiglieri, l'ARN del consulente è obbligatorio e l'elemento richiesto e l'input dell'utente dipendono dal caso d'uso (ricetta basata sul dominio) che supporta il programma di raccomandazione. Per informazioni sui requisiti dei casi d'uso, vedi Scelta dei casi d'uso dei consiglieri.

Sintassi della richiesta

POST /recommendations HTTP/1.1
Content-type: application/json

{
   "campaignArn": "string",
   "context": { 
      "string" : "string" 
   },
   "filterArn": "string",
   "filterValues": { 
      "string" : "string" 
   },
   "itemId": "string",
   "metadataColumns": { 
      "string" : [ "string" ]
   },
   "numResults": number,
   "promotions": [ 
      { 
         "filterArn": "string",
         "filterValues": { 
            "string" : "string" 
         },
         "name": "string",
         "percentPromotedItems": number
      }
   ],
   "recommenderArn": "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 ricevere consigli.

Tipo: String

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: arn:([a-z\d-]+):personalize:.*:.*:.+

Obbligatorio: no

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.

Obbligatorio: no

filterArn

L'ARN del filtro da applicare ai consigli restituiti. Per ulteriori informazioni, consulta la pagina con le indicazioni per filtrare le raccomandazioni.

Quando utilizzate questo parametro, assicuratevi che la risorsa del filtro siaACTIVE.

Tipo: String

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: arn:([a-z\d-]+):personalize:.*:.*:.+

Obbligatorio: no

filterValues

I valori da usare 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 un EXCLUDE elemento per escludere elementi, puoi omettere filter-values .In questo caso, Amazon Personalize non utilizza quella parte dell'espressione per filtrare i consigli.

Per ulteriori informazioni, consulta Filtrare consigli e segmenti di utenti.

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.

Obbligatorio: no

itemId

L'ID dell'articolo per cui fornire consigli.

Obbligatorio per il tipo di RELATED_ITEMS ricetta.

Tipo: String

Limitazioni di lunghezza: lunghezza massima di 256.

Obbligatorio: no

metadataColumns

Se hai abilitato i metadati nei consigli quando hai creato o aggiornato la campagna o il programma di raccomandazione, specifica le colonne di metadati del set di dati Items da includere nei consigli sugli articoli. 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. Per informazioni sull'abilitazione dei metadati per un programma di raccomandazione, consulta Abilitazione dei metadati nei consigli per un consigliatore.

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.

Obbligatorio: no

numResults

Il numero di risultati da restituire. Il valore predefinito è 25. Se includi i metadati nei consigli, il massimo è 50. Altrimenti, il massimo è 500.

Tipo: numero intero

Intervallo valido: valore minimo di 0.

Obbligatorio: no

promotions

Le promozioni da applicare alla richiesta di raccomandazione. Una promozione definisce regole aziendali aggiuntive che si applicano a un sottoinsieme configurabile di articoli consigliati.

Tipo: matrice di oggetti Promotion

Membri dell'array: numero massimo di 1 elementi.

Obbligatorio: no

recommenderArn

L'Amazon Resource Name (ARN) del programma di raccomandazione da utilizzare per ricevere consigli. Fornisci un ARN di raccomandazione se hai creato un gruppo di set di dati di dominio con un programma di raccomandazione per un caso d'uso del dominio.

Tipo: String

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: arn:([a-z\d-]+):personalize:.*:.*:.+

Obbligatorio: no

userId

L'ID utente per cui fornire consigli.

Obbligatorio per il tipo di USER_PERSONALIZATION ricetta.

Tipo: String

Limitazioni di lunghezza: lunghezza massima di 256.

Obbligatorio: no

Sintassi della risposta

HTTP/1.1 200
Content-type: application/json

{
   "itemList": [ 
      { 
         "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.

itemList

Un elenco di consigli ordinati in ordine decrescente per punteggio di previsione. L'elenco può contenere un massimo di 500 elementi.

Tipo: matrice di oggetti PredictedItem

recommendationId

L'ID della raccomandazione.

Tipo: String

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 una delle lingue specifiche AWS SDKs, consulta quanto segue: