Alexaショッピングアクションの追加方法

Alexaショッピングアクションの追加方法

Alexaショッピングアクションでは、ユーザーに商品を提案し、Alexaに購入フローを引き渡します。スキルがAmazon Associates on Alexaプログラムに参加している場合、ユーザーに商品をお勧めしたり、対象の購入により紹介料を得たりすることができます。Alexaショッピングの概要については、AlexaスキルへのAlexaショッピングアクションの追加を参照してください。

カスタムスキルにAlexaショッピングアクションを追加するには、以下の手順を実施します。

前提条件

Alexaショッピングアクションを使用するには、スキルが以下の前提条件を満たす必要があります。

Alexaショッピングアクションをスキルマニフェストに追加する

Alexaショッピングアクションを有効にするには、shoppingKitフィールドをスキルマニフェストファイルのprivacyAndComplianceオブジェクトに追加します。ファイルを保存したら、Alexa Skills Kitコマンドラインインターフェースを使用してスキルマニフェストを更新します。

以下は、Alexaショッピングアクションの設定を行ったスキルマニフェストの例です。

"privacyAndCompliance": {
    "allowsPurchases": false,
    "containsAds": false,
    "isChildDirected": false,
    "isExportCompliant": true,
    "shoppingKit": {
        "isShoppingActionsEnabled": true
    },
    "locales": {
       "ja-JP": {}
    },
    "usesPersonalInfo": false
}

商品のお勧めをデザインする

商品をお勧めする場合は、ユーザーに付加価値を提供できる商品を選びます。独自の商品やAmazonの別の出品者が出品している商品をお勧めすることができます。商品のお勧め音声フローをデザインする方法について詳しくは、Design the Product Recommendationを参照してください。

スキルコードにショッピングフローを実装する

ユーザーが商品に関心を持っていることを確認したら、スキルはSkill Connectionsインターフェースを使ってAlexaショッピングフローを開始し、次のいずれかのショッピングアクションを呼び出します。

  • ユーザーのカートに商品を追加するには、AMAZON.AddToShoppingCartを使用します。
  • ユーザーのほしい物リストに商品を追加するには、AMAZON.AddToListを使用します。
  • ユーザーが商品を購入できるようにするには、AMAZON.BuyShoppingProductsアクションを使用してショッピングとレジのプロセスをAlexaに転送します。
  • ユーザーがさらにお勧めを聞けるよう複数の商品（最大10個）の商品を提案するには、AMAZON.RecommendShoppingProductsアクションを使用します。

どのアクションでも、ショッピングエクスペリエンスを実行するには、Alexaとユーザーの間でマルチターンの対話を開始します。Alexaに制御を移す前に、重要なセッション情報をすべて保存してください。アクションが完了すると、Alexaからスキルに制御が戻されます。アクションの結果に基づいて、スキルを再開します。スキルが拒否やエラーをスムーズに処理できるようにしてください。

詳しくは、スキルにAlexaショッピングアクションを実装するを参照してください。

注文のキャンセルリクエストを処理する

ユーザーは、Amazonリテールウェブサイトを開くか、スキルの終了後に最後の注文をキャンセルするようAlexaにリクエストすることで、発注をキャンセルして返金をリクエストできます。スキルは、AMAZON.CancelIntentを処理する必要があります。詳しくは、標準ビルトインインテントを参照してください。このインテントを受信したら、ユーザーにAmazonアカウントサービスを開き、注文を変更するよう知らせます。

スキルをテストする

開発者コンソールを使って、実装したAlexaショッピングアクションとスキルをテストします。開発者コンソールを使ってスキルをテストする方法について詳しくは、スキルを検証してテストするを参照してください。

ショッピングフローを確認するには、次のテストシナリオを含めます。

  • スキルがAmazon Associates on Alexaプログラムに登録されている場合、商品提案のガイダンスに従ってスキルが紹介料を得ることを開示していることを確認する必要があります。
  • 商品のお勧め
    • お勧め情報の配置が適切であることを確認する。
    • さらに情報を提供する提案に対しては商品への関心を確認するために「はい／いいえ」で回答する必要があることを確認する。
    • 購入プロンプトに価格情報が含まれていないことを確認する。
    • ユーザーが既に所有している商品の提案を受け取らないようにする。
  • 購入アクションフロー
    • 購入提案の配置が適切であることを確認する。
    • 商品購入の提案に対しては商品への関心を確認するために「はい／いいえ」で回答する必要があることを確認する。
    • ユーザーが提案を拒否した場合。
    • ユーザーが商品を購入する場合。
    • ユーザーがAlexaとの対話中に購入を拒否した場合。
  • カートへの追加フロー
    • ユーザーが提案を拒否した場合。
    • ユーザーが商品をカートに追加する場合。
    • ユーザーがAlexaとの対話中に商品を拒否した場合。
  • リストへの追加フロー
    • ユーザーが提案を拒否した場合。
    • ユーザーが商品をほしい物リストに追加する場合。
    • ユーザーがAlexaとの対話中に商品を拒否した場合。
  • 商品のお勧めフロー
    • ユーザーが提案を拒否した場合。
    • ユーザーが詳細を知りたいことを確認した場合。
    • ユーザーがAlexaとの対話中に提案を拒否した場合。
    • スキルがセッションエラー応答を受信した場合。
  • ユーザーが返金を依頼した場合
    • Amazonリテールウェブサイトを開いて注文を変更するよう、スキルがユーザーに知らせる。
  • 成功応答を受け取った商品を引き続き提案しないこと
  • マーケットプレイスでのテスト（スキルが複数のマーケットプレイスに対応している場合）。各マーケットプレイスのデフォルトロケールで、Alexaシミュレーターを使用できます。

スキルの認定を受けて公開する

テストが完了したら、Alexaスキルストアに掲載されるスキルの詳細を定義し、スキルの認定を申請します。

スキルの詳細を定義する

Alexa開発者コンソールでスキルの詳細と公開範囲を定義します。Alexaショッピングアクションについては、以下の情報をすべて入力します。

Alexaショッピングアクションを使用するスキルの詳細を定義する

  1. このスキルはAlexaショッピングアクションを使用しますか？で、はいをクリックします。
  2. Amazonアソシエイトプログラムの一環として、スキルでAlexaショッピング機能を使用していますか？で、スキルをAmazon Associates on Alexaプログラムに登録している場合ははい、それ以外の場合はいいえをクリックします。

認定の要件

スキルは、すべてのカスタムスキルに適用される認定要件を満たす必要があります。詳細については、カスタムスキルの認定要件を参照してください。

また、スキルは、以下のAlexaショッピングアクションを含むスキルの認定要件も満たす必要があります。

  1. ユーザーIDを保存します。既にユーザーが同意したか、拒否した商品を引き続き提案しないようにします。
  2. 注文のキャンセルリクエストを処理します。ユーザーに、Amazonアカウントサービスで注文が変更できることを知らせます。
  3. Alexaのスキルストア詳細と利用可能状況を定義する際、Amazonでの商品購入を有効にするには、スキルの説明にAlexaショッピングを使用することを記載する必要があります。スキルの説明には、適切な言語で次の文章を含めてください。

This skill uses Alexa Shopping to make purchases on Amazon.Alexa allows purchasing by voice using your default payment and shipping settings.You can set a voice confirmation code, turn off purchasing, and see product and order details in your Alexa app.

Cette Skill utilise Alexa Shopping pour gérer les achats sur Amazon.Alexa vous permet de faire des achats vocaux selon vos paramètres de paiement et d'expédition par défaut.Vous pouvez définir un code de confirmation vocale, désactiver les achats et afficher les détails des produits et de vos commandes dans votre application Alexa.

Dieser Skill verwendet Alexa Shopping, um Shopping-Aktionen auf Amazon auszuführen.Alexa ermöglicht das Einkaufen per Sprachbefehl mit Ihren Standard-Bezahl- und Lieferoptionen.In Ihrer Alexa-App können Sie einen Sprach-Bestätigungscode einrichten, Einkaufen per Sprachbefehl ausschalten, und Details zu Ihren Produkten und Bestellungen einsehen.

यह स्किल Amazon पर खरीदारियां करने के लिए Alexa शॉपिंग का इस्तेमाल करती है.Alexa आपके डिफ़ॉल्ट भुगतान और शिपिंग सेटिंग का इस्तेमाल करते हुए वॉयस से खरीदारी करने की अनुमति देती है. आप अपने Alexa ऐप में वॉयस कन्फ़र्मेशन कोड सेट कर सकते हैं, खरीदारी बंद कर सकते हैं और प्रोडक्ट और ऑर्डर का विवरण देख सकते हैं.

Questa Skill usa Alexa Shopping per aggiungere al carrello o comprare su Amazon.Alexa consente l'acquisto con la voce utilizzando le impostazioni di pagamento e spedizione predefinite.Puoi impostare un codice di conferma vocale, disattivare l'acquisto e visualizzare i dettagli del prodotto e dell'ordine nella tua app Alexa.

このスキルは、アレクサショッピングを使用してAmazonでショッピングアクションを実行します。Alexaでは、デフォルトの支払い設定と配送設定を使用して音声で購入できます。 Alexaアプリで音声確認コードの設定や、購入をオフにしたり、製品と注文の詳細を確認できます。

Essa skill usa compras com a Alexa para comprar na Amazon.Com a Alexa, você compra por voz usando suas configurações padrão de pagamento e de envio.Defina um código de confirmação de voz, desative a compra e veja detalhes do produto e do pedido no app da Alexa.

Esta Skill usa Alexa Shopping para realizar compras en Amazon.Alexa te permite comprar con la voz utilizando tu configuración predeterminada de pago y envío.Puedes añadir un código de confirmación de voz, desactivar las compras y ver los detalles del producto y del pedido en la app Alexa.

スキルを検証して認定を申請する方法について詳しくは、スキルの認定を申請するを参照してください。

スキルをモニタリングして支払いを確認する

公開中のスキルは、Alexa開発者コンソールのレポートセクションでモニタリングします。Alexaショッピングアクション用の新しいメトリクスには、商品のお勧め回数とコンバージョンが含まれます。

スキルをAmazon Associates on Alexaプログラムに登録している場合、アソシエイトポータルで支払いを確認できます。

Last updated: Dec 02, 2022