İstekler API'si v1 Kullanım Senaryosu Rehberi
Alıcılara tutarlı ve yüksek kaliteli istekler gönderin.
API Sürümü: v1
İstekler API'si nedir?
Kullanabilirsiniz İstekler için Satış Ortağı API'si (Talep API'si) satıcıların alıcılara tutarlı, yüksek kaliteli talepler göndermesine olanak tanıyan uygulamalar oluşturmak. Satıcılar, tek bir şablon tabanlı e-posta göndererek hem ürün incelemesi hem de satıcı geri bildirimi talep edebilir.
Eğitim 1: Talep API'sini ayarlama
Bu kılavuz, geri bildirim istemeden önce Talep API"sinin nasıl kurulacağını gösterir..
Ön koşullar
Bu eğitimi tamamlamak için şunlara ihtiyacınız var:
- İsteğe uygun bir sipariş.
- Alıcı İsteği rolü veya Ürün Liste Kaydı rolü.
Adım 1. Abone ol ORDER_CHANGE
bildirim
ORDER_CHANGE
bildirimDaha fazla bilgi için bkz. Eğitim: ORDER_CHANGE Bildirimine abone olun.
Adım 2. Doğrula OrderStatus
parametre
OrderStatus
parametreAmazon Basit Kuyruk Hizmeti (SQS) iş akışları aşağıdaki yükü alır. ORDER_CHANGE
bildirim. Doğrulamak için Amazon SQS'yi kullanabilirsiniz. OrderStatus
parametre. Kontrol edin OrderStatus
Değer şu şekilde değişti Shipped
. Belirli bir sipariş için bir talebin gönderilip gönderilmediğinden emin olmak için işten çıkarılmaları ortadan kaldırın. SQS kuyruğunun nasıl anketileceği hakkında daha fazla bilgi için bkz. Eğitim: Bildirimleri ayarlama (Amazon Basit Kuyruk Hizmeti iş akışı).
Adım 3. Kontrol edin EarliestDeliveryDate
ve LatestDeliveryDate
parametreler
EarliestDeliveryDate
ve LatestDeliveryDate
parametrelerTalep talebinde bulunabilirsiniz, tarihten sonraki beş günlük bir zaman dilimi içinde talep edebilirsiniz. EarliestDeliveryDate
30 gün sonrasına kadar LatestDeliveryDate
. Talep API'sinin bu zaman dilimi dışında çağrılması beklenmedik API hatalarına yol açacaktır.
Adım 4. Anahtar tanımlayıcıları saklayın
Arşivleyin veya önbelleğe alın amazonOrderId
ve MarketplaceId
parametreleri. Bu tanımlayıcılar gelecekte inceleme istemek için gereklidir.
Artık geri bildirim istemeye hazırsınız.
Eğitici içerik: Bir sipariş için geri bildirim isteyin
Bu eğitici içerik, bir sipariş için nasıl ürün yorumu ve satıcı değerlendirmesi isteyebileceğinizi gösterir. Öncelikle bir siparişin isteğe uygun olduğunu doğrulayın ve ardından isteği oluşturun.
Ön koşullar
Bu eğitimi tamamlamak için şunlara ihtiyacınız var:
- İsteğe uygun bir sipariş.
- Alıcı İsteği rolü veya Ürün Liste Kaydı rolü.
1. Adım: Bir siparişin isteğe uygun olduğunu doğrulayın
Aşağıdaki parametreleri ileterek getSolicitationActionsForOrder
işlemini çağırın:
Yol parametresi
Parametre | Açıklama | Zorunlu mu? |
---|---|---|
amazonOrderId |
Amazon sipariş tanımlayıcısı. Kullanılabilir istek türlerinin listesini istediğiniz siparişi belirtir. Tür: dize |
Evet |
Sorgu parametresi
Parametre | Açıklama | Zorunlu mu? |
---|---|---|
marketplaceIds |
Pazaryeri tanımlayıcısı. Siparişin verildiği pazaryerini belirtir. Yalnızca bir pazaryeri belirtilebilir. Tür: dizi[Dize] |
Evet |
İstek örneği
GET https://sellingpartnerapi-na.amazon.com/solicitations/v1/orders/333-7777777-7777777
?marketplaceIds=ATVPDKIKX0DER
Yanıt örnekleri
İstek işlemleri olmadığında geçerli olan yanıt örneği:
{
"_links": {
"actions": [],
"self": {
"href": "/solicitations/v1/orders/111-1111111-1111111?marketplaceIds=ATVPDKIKX0DER"
}
},
"_embedded": {
"actions": []
}
}
İstek işlemleri olduğunda geçerli olan yanıt örneği:
{
"_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"
}
]
}
}
2. Adım: Ürün yorumu isteği oluşturun
Yanıtta productReviewAndSellerFeedback
işlemi varsa aşağıdaki parametreleri ileterek createProductReviewAndSellerFeedbackSolicitation
işlemini çağırın:
Yol parametresi
Parametre | Açıklama | Zorunlu mu? |
---|---|---|
amazonOrderId |
Amazon sipariş tanımlayıcısı. İsteğin gönderildiği siparişi belirtir. Tür: dize |
Evet |
Sorgu parametresi
Parametre | Açıklama | Zorunlu mu? |
---|---|---|
marketplaceIds |
Pazaryeri tanımlayıcısı. Siparişin verildiği pazaryerini belirtir. Yalnızca bir pazaryeri belirtilebilir. Tür: dizi[Dize] |
Evet |
İstek örneği
POST https://sellingpartnerapi-na.amazon.com/solicitations/v1/orders/333-7777777-7777777/solicitations/productReviewAndSellerFeedback
?marketplaceIds=ATVPDKIKX0DER
Yanıt örnekleri
Uygun olmayan bir sipariş için yanıt örneği:
{}
Uygun olmayan bir sipariş için yanıt örneği:
{
"errors": [
{
"code": "Unauthorized",
"message": "The requested solicitation is not available for this amazonOrderId.",
"details": ""
}
]
}
En iyi uygulamalar
İnceleme talep ettiğinizde, şunları yaptığınızdan emin olun:
- Teslim edilen siparişler için inceleme isteyin.
- İzin verilen zaman dilimi içinde geri bildirim isteyin.
Yapamayacağınızı unutmayın:
- Seçici olarak olumlu eleştiriler arayın.
- Mevcut incelemelerde değişiklik talep edin.
- İncelemeler için ödüller veya teşvikler sunun.
Taleplerde etik olarak nasıl gezinileceği hakkında daha fazla bilgi için, bkz. Müşteri İncelemeleri için Manipülasyon Önleme Politikası.
Olumsuz geri bildirimleri fırsatlara dönüştürün
Olumsuz yorumlar aldığınızda, alıcının sorununu çözme çabanız anlatıyı değiştirebilir. Alıcının sorununu çözdükten sonra, arayın createNegativeFeedbackRemoval
işlem tarafından Mesajlaşma API'si. Satıcılar, alıcıdan olumsuz geri bildirimi kaldırmasını istemek için bu işlemi kullanabilir. Bu, satıcılara ikinci bir şans sunar ve müşteri memnuniyetine olan bağlılıklarının altını çiziyor.
Updated 7 months ago