Skip to content

Latest commit

 

History

History
executable file
·
85 lines (69 loc) · 9.82 KB

3-create-isp.md

File metadata and controls

executable file
·
85 lines (69 loc) · 9.82 KB
Raw

Build An Alexa Skill with In-Skill Purchases - Premium Hello World

Create In-Skill Products

On page #1 of this guide, we created a voice user interface for the intents and utterances we expect from our users. On page #2, we created the AWS Hosted Lambda function that contains all of our logic for the skill. Now we will create the in-skill products that customers can purchase.

This sample implements a "One-Time Purchase" product called "Greeting Pack", which provides greetings in a variety of languages as premium content, and a monthly subscription called "Premium Subscription", which greets the customer using a variety of voices using Amazon Polly.

  1. Create a "One-Time Purchase"
  2. Create a "Subscription"

Create a "One-Time Purchase"

  1. Navigate to the Monetization Tool by clicking on the In-Skill Products section while on the Build tab of the Developer Console.

    If you cannot see the correct section in the left nav, click on the Permissions section, then click on In-Skill Products.

  2. Click Create in-skill product.

  3. Enter a Reference name. This is code-friendly name you want to assign to your in-skill product. For this sample, the code is expecting the reference name Greetings_Pack.

    Be sure to enter all the reference names exactly as provided. They are used in the sample code and it won't work properly if the name does not match exactly.

  4. Choose One-Time Purchase.

  5. Click Create in-skill product.

  6. On the Distribution sub-section, enter the following details for the subscription:

    Field Description Value for Sample
    Display Name The display name of the product. Customers will see and hear this. Greetings Pack
    One sentence description Summary description of the product. Customers will hear this. The Greetings Pack says hello in a variety of languages like French, Spanish, Hindi, and more.
    Detailed Description A full description explaining the product's functionality and any prerequisites to using it. Customers will see this. The Greetings Pack says hello in a variety of languages like French, Spanish, Hindi, and more.
    Example Phrases Example phrases customers can use to access your in-skill products. You should populate all three examples. say hello in other languages, give me the special greeting, get greetings pack
    Small Icon Small icon used with product when displayed in the skill store or Alexa app. You can use this placeholder icon if you don't have an image you would like to use. https://s3.amazonaws.com/ask-samples-resources/icons/moneyicon_108.png
    Large Icon Large icon used with product when displayed in the skill store or Alexa app. You can use this placeholder icon if you don't have an image you would like to use. https://s3.amazonaws.com/ask-samples-resources/icons/moneyicon_512.png
    Keywords Keywords that will be used with search. greetings
    Purchase prompt description The description of the product a customer hears when making a purchase or when they cancel a subscription. The Greetings Pack says hello in a variety of languages like French, Spanish, Hindi, and more.
    Purchase confirmation description A description of the product that displays on the skill card in the Alexa app. Customers will see this. You now have the Greetings Pack, which says hello in a variety of languages like French, Spanish, Hindi, and more.
    Privacy Policy URL A URL to the privacy policy for this locale. For this sample, we'll use a placeholder value. https://localhost/privacy.html

    Need help creating icons for your ISP or skill? Check out the Alexa Skill Icon Builder

  7. Click Save and continue.

  8. On the Pricing sub-section, the default values (amazon.com, $0.99 USD, releasing "today") are fine for the sample, however you can change the values if you like.

  9. Set the Tax Category to 'Information Services'. This is suitable for this sample, however you should consult your tax professional for guidance on what to choose for this value. The available options are listed here

  10. Click Save and continue.

  11. Normally you would provide testing instructions to help the certification team find and test your in-skill product. (These testing instructions are specific to this in-skill product, and are in addition to the skill testing instructions you will provide on the Certification tab.) We're going to leave them blank for now.

  12. Click Save and finish.

  13. If you've provided all the necessary information, you will be able to click Link to skill which will link this in-skill product with your skill. If that's not an option, click Continue and then go back and fill in any missing information.

  14. Congrats! You have added a "One-time Purchase" product to your skill. Now you are ready to test!

Before leaving the In-skill Products page, take a note of the links which say Reset test purchases. During testing if you want to 'un-buy' one of your products so you can re-buy it, click on these links.

Create a "Subscription"

  1. Navigate to the Monetization Tool by clicking on the In-Skill Products section while on the Build tab of the Developer Console.

    If you cannot see the correct section in the left nav, click on the Permissions section, then click on In-Skill Products.

  2. Click Create in-skill product.

  3. Enter a Reference name. This is code-friendly name you want to assign to your in-skill product. For this sample, the code is expecting the reference name Premium_Subscription.

    Be sure to enter all the reference names exactly as provided. They are used in the sample code and it won't work properly if the name does not match exactly.

  4. Choose Subscription.

  5. Click Create in-skill product.

  6. On the Distribution sub-section, enter the following details for the subscription:

    Field Description Value for Sample
    Display Name The display name of the product. Customers will see and hear this. Premium Subscription
    One sentence description Summary description of the product. Customers will hear this. The Premium Subscription greets the user in a variety of voices.
    Detailed Description A full description explaining the product's functionality and any prerequisites to using it. Customers will see this. The Premium Subscription Pack unlocks the magic of Polly Voice, and greets you in a variety of languages, like hindi, spanish, italian, and more.
    Example Phrases Example phrases customers can use to access your in-skill products. You should populate all three examples. Surprise me, switch personality
    Small Icon Small icon used with product when displayed in the skill store or Alexa app. You can use this placeholder icon if you don't have an image you would like to use. https://s3.amazonaws.com/ask-samples-resources/icons/moneyicon_108.png
    Large Icon Large icon used with product when displayed in the skill store or Alexa app. You can use this placeholder icon if you don't have an image you would like to use. https://s3.amazonaws.com/ask-samples-resources/icons/moneyicon_512.png
    Keywords Keywords that will be used with search. personality,polly,voice
    Purchase prompt description The description of the product a customer hears when making a purchase or when they cancel a subscription. The Premium Subscription Pack unlocks the magic of Polly Voice, and greets you in a variety of languages using Amazon Polly.
    Purchase confirmation description A description of the product that displays on the skill card in the Alexa app. Customers will see this. You now have the Premium Subscription, which will greet you in multiple languages in a variety of voices using Amazon Polly.
    Privacy Policy URL A URL to the privacy policy for this locale. For this sample, we'll use a placeholder value. https://localhost/privacy.html

    Need help creating icons for your ISP or skill? Check out the Alexa Skill Icon Builder

  7. Click Save and continue.

  8. On the Pricing sub-section, the default values (amazon.com, $2.99 USD, Monthly billing, 7 day trial, releasing "today") are fine for the sample, however you can change the values if you like.

  9. Set the Tax Category to 'Information Services'. This is suitable for this sample, however you should consult your tax professional for guidance on what to choose for this value. The available options are listed here

  10. Click Save and continue.

  11. Normally you would provide testing instructions to help the certification team find and test your in-skill product. (These testing instructions are specific to this in-skill product, and are in addition to the skill testing instructions you will provide on the Certification tab.) We're going to leave them blank for now.

  12. Click Save and finish.

  13. If you've provided all the necessary information, you will be able to click Link to skill which will link this in-skill product with your skill. If that's not an option, click Continue and then go back and fill in any missing information.

  14. Congrats! You have added a "One-time Purchase" product to your skill. Now you are ready to test!

Next