Guida ai casi d'uso dell'API Sollecitazioni v1
Invia sollecitazioni coerenti e di alta qualità agli acquirenti.
Versione API: v1
Cos'è l'API Sollecitazioni?
Puoi usare API per le sollecitazioni dei partner di vendita (API Solicitations) per creare applicazioni che consentano ai venditori di inviare richieste coerenti e di alta qualità agli acquirenti. I venditori possono richiedere sia una recensione del prodotto che il feedback del venditore inviando un'unica email basata su un modello.
Tutorial 1: Configurare l'API Solicitations
Questa guida illustra come configurare l'API Solicitations prima di richiedere un feedback.
Prerequisiti
Per completare questo tutorial, hai bisogno di:
- Un ordine disponibile per la sollecitazione.
- Il ruolo Sollecitazione dell'acquirente o il ruolo Offerte di prodotti.
Fase 1. Abbonati al ORDER_CHANGE
notifica
ORDER_CHANGE
notificaPer ulteriori informazioni, fare riferimento a Tutorial: iscriviti alla notifica ORDER_CHANGE.
Fase 2. Convalida il OrderStatus
parametro
OrderStatus
parametroI flussi di lavoro di Amazon Simple Queue Service (SQS) ricevono il payload di ORDER_CHANGE
notifica. Puoi usare Amazon SQS per convalidare il OrderStatus
parametro. Verificare che il OrderStatus
il valore è cambiato in Shipped
. Elimina le ridondanze per accertarti che sia già stata inviata una richiesta per un ordine specifico. Per ulteriori informazioni su come effettuare il polling della coda SQS, consulta Tutorial: Configurazione delle notifiche (flusso di lavoro Amazon Simple Queue Service).
Fase 3 Controlla il EarliestDeliveryDate
e LatestDeliveryDate
parametri
EarliestDeliveryDate
e LatestDeliveryDate
parametriÈ possibile richiedere una sollecitazione entro un periodo di cinque giorni dopo il EarliestDeliveryDate
a 30 giorni dopo il LatestDeliveryDate
. La chiamata all'API Solicitations al di fuori di questo lasso di tempo comporterà errori API imprevisti.
Fase 4. Memorizza gli identificatori chiave
Archivia o memorizza nella cache il amazonOrderId
e MarketplaceId
parametri. Questi identificatori sono necessari per sollecitare revisioni future.
Ora sei pronto per richiedere un feedback.
Tutorial: Sollecitare un feedback per un ordine
Questo tutorial mostra come sollecitare la recensione di un prodotto e il feedback del venditore per un ordine. Verifica innanzitutto che un ordine sia disponibile per la sollecitazione, quindi crea la richiesta di sollecitazione.
Prerequisiti
Per completare questo tutorial, hai bisogno di:
- Un ordine disponibile per la sollecitazione.
- Il ruolo Sollecitazione dell'acquirente o il ruolo Offerte di prodotti.
Passaggio 1. Verifica che un ordine sia disponibile per la sollecitazione
Chiama l'operazione getSolicitationActionsForOrder
, passando i seguenti parametri:
Parametro del percorso
Parametro | Descrizione | Obbligatorio |
---|---|---|
amazonOrderId |
Un identificativo di ordine Amazon. Specifica l'ordine per il quale desideri un elenco dei tipi di sollecitazione disponibili. Tipo: stringa |
Sì |
Parametro di query
Parametro | Descrizione | Obbligatorio |
---|---|---|
marketplaceIds |
Un identificativo del marketplace. Specifica il marketplace in cui è stato effettuato l'ordine. È possibile specificare un solo marketplace. Tipo: array [stringa] |
Sì |
Esempio di richiesta
GET https://sellingpartnerapi-na.amazon.com/solicitations/v1/orders/333-7777777-7777777
?marketplaceIds=ATVPDKIKX0DER
Esempi di risposta
Esempio di risposta quando non sono disponibili azioni di sollecitazione:
{
"_links": {
"actions": [],
"self": {
"href": "/solicitations/v1/orders/111-1111111-1111111?marketplaceIds=ATVPDKIKX0DER"
}
},
"_embedded": {
"actions": []
}
}
Esempio di risposta quando sono disponibili azioni di sollecitazione:
{
"_links": {
"actions": [
{
"href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback?marketplaceIds=ATVPDKIKX0DER",
"name": "productReviewAndSellerFeedback"
}
],
"self": {
"href": "/solicitations/v1/orders/111-1111111-1111111?marketplaceIds=ATVPDKIKX0DER"
}
},
"_embedded": {
"actions": [
{
"_links": {
"schema": {
"href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback/schema",
"name": "productReviewAndSellerFeedback"
},
"self": {
"href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback?marketplaceIds=ATVPDKIKX0DER",
"name": "productReviewAndSellerFeedback"
}
},
"_embedded": {
"schema": {
"_links": {
"self": {
"href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback/schema",
"name": "productReviewAndSellerFeedback"
}
},
"type": "object",
"name": "productReviewAndSellerFeedback",
"title": "Request seller feedback and product review",
"description": "Request seller feedback and product review",
"properties": {},
"required": [],
"$schema": "http://json-schema.org/draft-04/schema#",
"x-ui-hidden": true
}
},
"name": "productReviewAndSellerFeedback",
"title": "Request seller feedback and product review"
}
]
}
}
Passaggio 2. Crea una richiesta di recensione del prodotto
Se l'azione productReviewAndSellerFeedback
è elencata nella risposta, chiama l'operazione createProductReviewAndSellerFeedbackSolicitation
, trasmettendo i seguenti parametri:
Parametro del percorso
Parametro | Descrizione | Obbligatorio |
---|---|---|
amazonOrderId |
Un identificativo di ordine Amazon. Specifica l'ordine per il quale viene inviata una sollecitazione. Tipo: stringa |
Sì |
Parametro di query
Parametro | Descrizione | Obbligatorio |
---|---|---|
marketplaceIds |
Un identificativo del marketplace. Specifica il marketplace in cui è stato effettuato l'ordine. È possibile specificare un solo marketplace. Tipo: array [stringa] |
Sì |
Esempio di richiesta
POST https://sellingpartnerapi-na.amazon.com/solicitations/v1/orders/333-7777777-7777777/solicitations/productReviewAndSellerFeedback
?marketplaceIds=ATVPDKIKX0DER
Esempi di risposta
Esempio di risposta per un ordine non idoneo:
{}
Esempio di risposta per un ordine non idoneo:
{
"errors": [
{
"code": "Unauthorized",
"message": "The requested solicitation is not available for this amazonOrderId.",
"details": ""
}
]
}
Best practice
Quando richiedi recensioni, assicurati di:
- Richiedi recensioni per gli ordini che sono stati consegnati.
- Richiedi un feedback entro il periodo di tempo consentito.
Tieni presente che non puoi:
- Cerca selettivamente recensioni positive.
- Richiedi modifiche alle recensioni esistenti.
- Offri premi o incentivi per le recensioni.
Per ulteriori informazioni su come gestire in modo etico le sollecitazioni, consulta la Politica anti-manipolazione per le recensioni dei clienti.
Trasforma i feedback negativi in opportunità
Quando ricevi recensioni negative, il tuo impegno per risolvere il problema dell'acquirente può cambiare la narrazione. Una volta risolto il problema dell'acquirente, chiama il createNegativeFeedbackRemoval
operazione dal API di messaggistica. I venditori possono utilizzare questa operazione per chiedere all'acquirente di rimuovere il feedback sfavorevole. Ciò offre ai venditori una seconda possibilità e sottolinea il loro impegno per la soddisfazione del cliente.
Updated 7 months ago