要請API v1ユースケースガイド
購入者に一貫性のある質の高い要請を送りましょう。
APIバージョン:v1
要請APIとは何ですか?
次のものを使用できます 勧誘用の販売パートナー API (勧誘 API) 出品者が一貫性のある質の高い勧誘を買い手に送信できるアプリケーションを構築すること。出品者は、テンプレートベースのメールを 1 通送信するだけで、商品レビューと出品者フィードバックの両方をリクエストできます。
チュートリアル 1: 勧誘 API の設定
このガイドでは、フィードバックを求める前に勧誘APIを設定する方法を示します。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 要請に使用可能な注文。
- 購入者への要請ロールまたは商品の出品ロール。
ステップ 1:を購読する ORDER_CHANGE
通知
ORDER_CHANGE
通知詳細については、「」を参照してください。 チュートリアル:ORDER_CHANGE 通知を購読する。
ステップ 2:を検証します。 OrderStatus
パラメータ
OrderStatus
パラメータAmazon シンプルキューサービス (SQS) ワークフローは、のペイロードを受け取ります ORDER_CHANGE
通知。Amazon SQS を使用して以下を検証することができます。 OrderStatus
パラメーター。次の点を確認してください。 OrderStatus
値がに変わりました Shipped
。重複を排除して、特定の注文に関する勧誘がすでに発送されているかどうかを確認してください。SQS キューをポーリングする方法の詳細については、「」を参照してください。 チュートリアル:通知を設定する (Amazon シンプルキューサービスワークフロー)。
ステップ 3:をチェックしてください。 EarliestDeliveryDate
そして LatestDeliveryDate
パラメーター
EarliestDeliveryDate
そして LatestDeliveryDate
パラメーター勧誘を依頼できる期間は、次の日から5日以内です。 EarliestDeliveryDate
30 日後まで LatestDeliveryDate
。この時間枠外に勧誘 API を呼び出すと、予期しない API エラーが発生します。
ステップ 4:キー識別子を保存
アーカイブまたはキャッシュ amazonOrderId
そして MarketplaceId
パラメーター。これらの識別子は、今後レビューを依頼する際に必要になります。
これで、フィードバックを求める準備ができました。
チュートリアル:注文に関するフィードバックを要請する
このチュートリアルでは、注文についての商品レビューや出品者に関するフィードバックを要請する方法を説明します。まず、注文を要請に使用できることを確認し、次に要請リクエストを作成します。
前提条件
このチュートリアルを完了するには、以下が必要です。
- 要請に使用可能な注文。
- 購入者への要請ロールまたは商品の出品ロール。
ステップ1. 注文を要請に使用できることを確認する
getSolicitationActionsForOrder
オペレーションを呼び出して、以下のパラメーターを渡します。
パスパラメーター
パラメーター | 説明 | 必須 |
---|---|---|
amazonOrderId |
Amazonの注文識別子。利用可能な要請タイプのリストが必要な注文を指定します。 タイプ:文字列 |
はい |
クエリーパラメーター
パラメーター | 説明 | 必須 |
---|---|---|
marketplaceIds |
マーケットプレイス識別子。注文が行われたマーケットプレイスを指定します。指定できるマーケットプレイスは1つだけです。 タイプ:配列[文字列] |
はい |
リクエストの例
GET https://sellingpartnerapi-na.amazon.com/solicitations/v1/orders/333-7777777-7777777
?marketplaceIds=ATVPDKIKX0DER
レスポンスの例
利用可能な要請アクションがない場合のレスポンスの例:
{
"_links": {
"actions": [],
"self": {
"href": "/solicitations/v1/orders/111-1111111-1111111?marketplaceIds=ATVPDKIKX0DER"
}
},
"_embedded": {
"actions": []
}
}
要請アクションが利用可能な場合のレスポンスの例:
{
"_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. 商品レビューの要請を作成する
productReviewAndSellerFeedback
アクションがレスポンスにリストされている場合は、createProductReviewAndSellerFeedbackSolicitation
オペレーションを呼び出して、以下のパラメーターを渡します。
パスパラメーター
パラメーター | 説明 | 必須 |
---|---|---|
amazonOrderId |
Amazonの注文識別子。要請の送信対象となる注文を指定します。 タイプ:文字列 |
はい |
クエリーパラメーター
パラメーター | 説明 | 必須 |
---|---|---|
marketplaceIds |
マーケットプレイス識別子。注文が行われたマーケットプレイスを指定します。指定できるマーケットプレイスは1つだけです。 タイプ:配列[文字列] |
はい |
リクエストの例
POST https://sellingpartnerapi-na.amazon.com/solicitations/v1/orders/333-7777777-7777777/solicitations/productReviewAndSellerFeedback
?marketplaceIds=ATVPDKIKX0DER
レスポンスの例
不適格な注文のレスポンスの例:
{}
不適格な注文のレスポンスの例:
{
"errors": [
{
"code": "Unauthorized",
"message": "The requested solicitation is not available for this amazonOrderId.",
"details": ""
}
]
}
ベストプラクティス
レビューを依頼するときは、以下の点を確認してください。
- 配達された注文のレビューを依頼してください。
- 許可された時間枠内でフィードバックを求める。
次のことはできないことに注意してください。
- 肯定的なレビューを選択的に求める。
- 既存のレビューの変更をリクエストします。
- レビューに対する報酬やインセンティブを提供する。
勧誘を倫理的に進める方法の詳細については、 カスタマーレビューの改ざん防止ポリシー。
ネガティブなフィードバックをチャンスに変える
否定的なレビューを受けた場合、購入者の問題を解決しようと努力した結果、説明が変わる可能性があります。購入者の問題を解決したら、購入者に電話してください createNegativeFeedbackRemoval
操作 から メッセージング API。出品者はこの操作を使用して、購入者に不利な評価を削除するよう依頼できます。これにより、売り手には二度目のチャンスが与えられ、顧客満足への取り組みが強調されます。
Updated 7 months ago