アクセスいただきありがとうございます。こちらのページは現在英語のみのご用意となっております。順次日本語化を進めてまいりますので、ご理解のほどよろしくお願いいたします。

In-Skill Product Schemas

This topic contains examples of the in-skill product schemas and descriptions of the schema parts.

Subscription Schema

The following shows a subscription product schema.

{
  "version": "1.0",
  "type": "SUBSCRIPTION",
  "referenceName": "treasure_finders_plus",
  "subscriptionInformation": {
    "subscriptionPaymentFrequency": "MONTHLY",
    "subscriptionTrialPeriodDays": 7
  },
  "publishingInformation": {
    "locales": {
      "en-US": {
        "name": "Treasure Finders Plus",
        "smallIconUri": "small-icon-uri",
        "largeIconUri": "large-icon-uri",
        "summary": "1 new members-only adventure each month + over 10 previously released adventures.",
        "description": "Get access to a new adventure each month for members only, along with a growing collection of over 10 previously released members-only adventures. Includes Crystal Catchers, The Light Stone, The Dark Pool, The Cave Fish, Long Way Down and more.",
        "examplePhrases": [
          "Alexa, open treasure finders plus",
          "Alexa, play with treasure finders plus"
        ],
        "keywords": [
          "Games"
        ],
        "customProductPrompts": {
          "purchasePromptDescription": "{PREMIUM CONTENT_TITLE} includes access to all of our current adventures and a new one each month.",
          "boughtCardDescription": "Enjoy {PREMIUM CONTENT_TITLE}! Ask for a list of adventures to explore your purchase.."
        }
      }
    },
    "distributionCountries": [
      "US"
    ],
    "pricing": {
      "amazon.com": {
        "releaseDate": "2018-12-28T01:25Z",
        "defaultPriceListing": {
          "price": 1.99,
          "currency": "USD"
        }
      }
    },
    "taxInformation": {
      "category": "SOFTWARE"
    }
  },
  "privacyAndCompliance": {
    "locales": {
      "en-US": {
        "privacyPolicyUrl": "url-to-privacy-policy"
      }
    }
  },
  "testingInstructions": "Sample testing instructions.",
  "purchasableState": "PURCHASABLE"
}

Entitlement Schema

The following shows an entitlement product schema.

{
  "version": "1.0",
  "type": "ENTITLEMENT",
  "referenceName": "cave_quest",
  "publishingInformation": {
    "locales": {
      "en-US": {
        "name": "Cave Quest",
        "smallIconUri": "small-icon-uri",
        "largeIconUri": "large-icon-uri",
        "summary": "  5 new adventures for your collection",
        "description": "The Cave Quest expansion pack includes 5 brand new adventures for your collection. Venture into even deeper and darker caves with Emerald and her friends, and collect up to 30 unique treasures. Adventures will automatically be playable once you've completed your purchase, and you can play them as often as you'd like.",
        "examplePhrases": [
          "Alexa, play cave quest",
          "Alexa, buy cave quest"
        ],
        "keywords": [
          "Games"
        ],
        "customProductPrompts": {
          "purchasePromptDescription": "{PREMIUM CONTENT_TITLE} includes 5 new adventures with Emerald and her friends.",
          "boughtCardDescription": "Enjoy {PREMIUM CONTENT_TITLE} by asking Alexa to play cave quest."
        }
      }
    },
    "distributionCountries": [
      "US"
    ],
    "pricing": {
      "amazon.com": {
        "releaseDate": "2018-01-28T01:25Z",
        "defaultPriceListing": {
          "price": 1.99,
          "currency": "USD"
        }
      }
    },
    "taxInformation": {
      "category": "SOFTWARE"
    }
  },
  "privacyAndCompliance": {
    "locales": {
      "en-US": {
        "privacyPolicyUrl": "url-to-privacy-policy"
      }
    }
  },
  "testingInstructions": "Ask Alexa if she has any new adventures",
  "purchasableState": "PURCHASABLE"
}

Product schema parts

Following are descriptions of the in-skill product schema parts.

Product object

A product contains the following fields.

Field Description Type
version The version indicator. String. Valid value: 1.0
type The type of in-skill product. String. Valid values: ENTITLEMENT, SUBSCRIPTION
referenceName The canonical name of the in-skill product. This name is used when referring to the product in code. String 3-50 characters long, with no spaces.
publishingInformation An object that contains information about how the product is presented to end users, by locale. publishingInformation object
privacyAndCompliance An object provides privacy policy URLs by locale. Currently en-US is the only supported locale. privacyAndCompliance object
testingInstructions Testing instructions such as test account credentials. String 1-4000 characters, inclusive.
purchasableState Indicates whether the product is purchasable. String enumeration value: PURCHASABLE or NOT_PURCHASABLE
subscriptionInformaton Required for subscriptions only. Describes the billing frequency and trial period length for the subscription. SubscriptionInformation Object

SubscriptionInformation object

Required for subscriptions only. Describes the billing frequency and trial period length for the subscription.

Field Description Type
subscriptionPaymentFrequency Required for subscriptions only. Indicates how often the customer is billed for the subscription. String. Valid values: MONTHLY, YEARLY
subscriptionTrialPeriodDays Required for subscriptions only. Indicates the duration of the trial period, in days. Integer between 0 and 31, inclusive.

PublishingInformation object for an in-skill product

A publishingInformation object contains the following fields.

Field Description Type
locales A map of locale objects that provide specific information for each supported locale. Currently the only supported locale is en-US. Object that contains a map of locale objects
distributionCountries List specifying distribution country/region strings in ISO 3166-1 alpha-2 format. Currently the only valid value is US. String list
pricing Contains details about pricing of the product. pricing object
taxInformation Provides the tax information for the product. Object
taxInformation.category The tax category for the product. String. Valid values: INFORMATION_SERVICES, NEWSPAPERS, PERIODICALS, SOFTWARE, STREAMING_RADIO, VIDEO

Publishing information locale

Each publishingInformation object contains a map of locale objects that describe publishing information specific to that locale. Each locale is identified with a 2-letter language code, a hyphen followed by the 2-letter country/region code. Currently the only supported locale is "en-US".

Field Description Type
<locale> 2-letter language code, a hyphen followed by the 2-letter country/region code. String. Valid value: en-US
<locale>.name The name for the product for this locale. This name is included in purchase confirmation prompts, Alexa app purchasing cards and email receipts. String 2-50 characters, inclusive.
<locale>.summary Summary description of the product. String from 1-160 characters, inclusive.
<locale>.description A full description explaining the product's functionality and any prerequisites to using it. String 1-4000 characters, inclusive.
<locale>.smallIconUri A URI to a 108px x 108 PNG with transparency, which represents the in-skill product. Because the image is rounded when displayed, it is recommended that the image has 75px padding on all sides. You can reuse the small icon associated with your skill, or provide a unique image to represent your in-skill product. Properly formatted URL string
<locale>.largeIconUri A URI to a 512 X 512 PNG with transparency, which represents the in-skill product. Because the image is rounded when displayed, it is recommended that the image has 75px padding on all sides. You can reuse the large icon associated with your skill, or provide a unique image to represent your in-skill product. Properly formatted URL string
<locale>.examplePhrases List of example phrases that illustrate how users can ask for your product. These phrases must be supported in your voice model. String list that contains 1-3 entries. Each string in the list can be 2-200 character, inclusive.
<locale>.keywords Keyword phrases that describe the product offering. String list that contains 1-30 entries. Each string in the list should be 1-150 characters, inclusive.
<locale>.customProductPrompts An object that contains prompts and descriptions for this product for this locale. customProductPrompts object

customProductPrompts object

A customProductPrompts object contains two fields that provide descriptions of your product when a customer makes a purchase. These should be in the language of of the specified locale.

Field Description Type
purchasePromptDescription The description of the product a customer hears when making a purchase or when they cancel a subscription. A purchasePromptDescription should:
  • Include the product name or "{PREMIUM_CONTENT_TITLE}", and Amazon will provide the value of the name field. Do not use "{" or "}" anywhere else in the prompt.
  • Include what is unique about this product
  • Be as brief as possible
  • NOT include the product price, as Amazon automatically appends the price in the purchase flow.
  • Avoid repeating the same phrases customers may have heard in the previous step

String between 1 and 160 characters long that optionally contains the placeholder {PREMIUM CONTENT_TITLE}.
boughtCardDescriptionA description of the product that displays on the skill card in the Alexa app.String between 1-160 characters, inclusive that optionally contains the placeholder {PREMIUM CONTENT_TITLE}.

pricing object

A pricing object contains a map of marketplace objects, which contain details about pricing in that marketplace. Currently the only supported marketplace is "amazon.com".

Field Description Type
<marketplace> Describes where the product is offered for sale. String. Accepted values: amazon.com
<marketplace>.releaseDate Future UTC date that indicates when the product releases. Note that this date cannot be changed once a skill is published live, regardless of the date specified. Date/time string in ISO 8601 format. For example, yyyy-MM-dd'T'HH:mm'Z' or yyyy-MM-dd.
<marketplace>.defaultPriceListing The default price and currency assigned to the product for this marketplace. Object
defaultPriceListing.price Price for the product. A number (long) between .99 and 99.99, inclusive.
defaultPriceListing.currency The ISO 4217- 3 digit alpha code that indicates the currency of the specified price. String. Valid value: USD

Back to product schema parts

privacyAndCompliance object

A privacyAndCompliance object contains a map of locale objects, which in turn contains privacy information specific to that locale. Each locale is identified with a 2-letter language code, a hyphen followed by the 2-letter country/region code. Currently the only supported locale is "en-US". Each locale identified in the publishingInformation object must have an entry in this map, and a valid privacyPolicyUrl for the locale.

Field Description Type
<locale> A language tag that contains the 2-letter language code, a hyphen followed by the 2-letter country/region code. String. Valid value: en-US
<locale>.privacyPolicyUrl A URL to the privacy policy for this locale. Properly formatted URL string

Back to product schema parts