Steps to Add Alexa Shopping Actions to Your Skill

With Alexa Shopping Actions, you can recommend products to the customer for purchase and hand-off the purchase flow to Alexa.

Complete the following steps to add Alexa Shopping Actions to your custom skill.

Prerequisites

To use Alexa Shopping Actions, your skill must comply with the following prerequisites:

  • Your skill uses the custom voice interaction model.
    For details about custom skills, see Understand Custom Skills.
  • You can offer skills with Alexa Shopping Actions in the available locales.
  • Register your skill for the developer preview. If your skill ID isn't on the allow list, Alexa Shopping Actions return a 500 status code response.

Add Alexa Shopping Actions to the skill manifest

To enable Alexa Shopping Actions, add the isAlexaShoppingActionsEnabled field to the privacyAndCompliance in your skill manifest file. To modify your skill's manifest by using SMAPI, see SMAPI skill operations.

The following example shows the skill manifest configured with Alexa Shopping Actions.

"privacyAndCompliance": {
    "allowsPurchases": false,
    "containsAds": false,
    "isChildDirected": false,
    "isExportCompliant": true,
    "isAlexaShoppingActionsEnabled": true,
    "locales": {
       "en-US": {}
    },
    "usesPersonalInfo": false
}

Design the purchase recommendation

When you create skills that are highly engaging, user-centric, and built on a foundation of trust, you build a loyal customer base for your skills. When you recommend products for purchase, you should choose product recommendations that add value to the customer. Also, you should place the recommendations in a place that doesn't add friction to the skill experience.

The product suggestion should include the following parts:

  1. A brief description of the product and its availability to customers.
  2. An explicit confirmation (Yes/No) to confirm interest in the product, such as, "Want to learn more?" or "Would you like to learn how to add the {product} to your cart on Amazon?"

You also design a graceful handoff from the Amazon shopping flow back to your skill. Design a follow-up action for a successful purchase or add-to-cart request, and design a flow for customer errors.

For best practices to follow when you design voice-first interactions, see the Alexa Design Guide.

Implement the shopping flow in your skill code

After the customer confirms interest in a product, your skill starts the Alexa Shopping flow by using the skill connections interface. To add the product to the customer cart, you invoke the AddToShoppingCart task to transfer the shopping process to Alexa. To purchase a given product, you invoke the BuyShoppingProducts task to transfer the shopping and checkout process to Alexa. For details, see Implement Alexa Shopping Actions in Your Skill. Both tasks start a multi-turn interaction between Alexa and the customer to complete the shopping experience. Before you transfer control to Alexa, make sure that you save any important session information.

After the task completes, Alexa hands control back to your skill. Resume your skill based on the results of the task. Make sure that your skill handles decline and errors gracefully. For details about the error types, see Alexa Shopping Actions Error Reference.

Handle cancel order requests

Customers can cancel the order and ask for refund by visiting Amazon.com or by asking Alexa to cancel the last order after exiting the skill. Your skill should handle the AMAZON.CancelIntent. For details, see Standard Built-in Intents. When you receive this intent, remind the customer to go to their Amazon account to alter the order.

Test your skill

Use the developer console to test your skill and the Alexa Shopping Actions implementation. For details about how to test your skill by using the developer console, see Validate and test your skill.

Include the following test scenarios:

  • Product recommendations.
    • Verify that the recommendation and purchase suggestion makes sense.
    • Verify that the purchase prompt doesn't include any pricing information.
    • Make sure that the customer doesn't receive a purchase suggestion for a product they already own.
  • Buy action flows.
    • Customer declines the recommendation.
    • Customer purchases the product.
    • Customer declines the purchase during the interaction with Alexa.
  • Add to cart flows.
    • Customer declines the recommendation.
    • Customer adds the product to their Cart.
    • Customer declines the product during the interaction with Alexa.
  • Customer asks for a refund.
    • Verify that the skill reminds the customer to go to Amazon.com to change their order.
  • Don't continue to recommend a product that received a success response.
  • If your skill supports multiple marketplaces, test in each marketplace. You can use the Alexa Simulator to test in the default locale for each marketplace.

Certify and publish your skill

Your skill must meet the certification requirements that apply to all custom skills. For details, see Certification Requirements for Custom Skills.

Your skill must also meet the following certification requirements for skills that include Alexa Shopping Actions.

  1. Preserve the customer identifier. Don't continue to suggest a product to a customer who already consented or declined the product recommendation.
  2. Handle a request to cancel an order. Remind the user that they can go to their Amazon account to alter the order.
  3. When you define Alexa skill store details and availability, to enable shopping for products on Amazon, your skill description must note that the skill uses Alexa Shopping. It must also contain the following sentence in the appropriate language.

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.

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アプリで音声確認コードの設定や、購入をオフにしたり、製品と注文の詳細を確認できます。

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.

For details about how to validate and submit your skill, see Submit Your Skill for Certification.

Monitor the skill

Monitor your live skill in the Analytics section of the Alexa developer console. New metrics for Alexa Shopping Actions include recommendations and conversions.