スキル内課金のスキーマ



スキル内課金のスキーマ

このトピックでは、スキル内商品のスキーマのサンプルおよびスキーマの各部分の説明を提供します。

サブスクリプション型スキーマ

以下にサブスクリプション型商品のスキーマを示します。

{
  "version": "1.0",
  "type": "SUBSCRIPTION",
  "referenceName": "treasure_finders_plus",
  "subscriptionInformation": {
    "subscriptionPaymentFrequency": "MONTHLY",
    "subscriptionTrialPeriodDays": 7
  },
  "publishingInformation": {
    "locales": {
      "ja-JP": {
        "name": "宝探しプラス",
        "smallIconUri": "small-icon-uri",
        "largeIconUri": "large-icon-uri",
        "summary": "新しい会員専用アドベンチャーが毎月1つと、10個以上のリリース済みアドベンチャーです。",
        "description": "会員専用の新しいアドベンチャーに毎月アクセスしましょう。リリース済み会員専用アドベンチャーのコレクションも10個以上で今後ますます増えていきます。クリスタルキャッチャー、光の石、ほの暗い水辺で、洞窟に潜むもの、下へ下へなどをお楽しみください。",
        "examplePhrases": [
          "アレクサ、宝探しプラスを開いて",
          "アレクサ、宝探しプラスで遊びたい"
        ],
        "keywords": [
          "ゲーム"
        ],
        "customProductPrompts": {
          "purchasePromptDescription": "{PREMIUM_CONTENT_TITLE}では、現在リリースされているすべてのアドベンチャーにアクセスできるほか、毎月新しいものが1つ追加されます。",
          "boughtCardDescription": "{PREMIUM_CONTENT_TITLE}をお楽しみください。 購入したものについての詳細は、アドベンチャーのリストを頼んでください.."
        }
      }
    },
    "distributionCountries": [
      "JP"
    ],
    "pricing": {
      "amazon.co.jp": {
        "releaseDate": "2018-12-28T01:25Z",
        "defaultPriceListing": {
          "price": 199,
          "currency": "JPY"
        }
      }
    },
    "taxInformation": {
      "category": "SOFTWARE"
    }
  },
  "privacyAndCompliance": {
    "locales": {
      "ja-JP": {
        "privacyPolicyUrl": "url-to-privacy-policy"
      }
    }
  },
  "testingInstructions": "サンプルのテスト手順です。",
  "purchasableState": "PURCHASABLE"
}

買い切り型スキーマ

以下に買い切り型商品のスキーマを示します。

{
  "version": "1.0",
  "type": "ENTITLEMENT",
  "referenceName": "cave_quest",
  "publishingInformation": {
    "locales": {
      "ja-JP": {
        "name": "洞窟探検",
        "smallIconUri": "small-icon-uri",
        "largeIconUri": "large-icon-uri",
        "summary": "  コレクションに5つの新しい冒険を",
        "description": "洞窟探検拡張パックには、コレクションに追加できる5つの新登場のアドベンチャーが含まれています。エメラルドとその仲間たちと一緒に、もっと深く暗い洞窟を探検して、最大30個のユニークな宝物を集めましょう。購入が完了すると、アドベンチャーは自動的にプレイできるようになります。また、何回でもプレイできます。",
        "examplePhrases": [
          "アレクサ、洞窟探検をプレイしたい",
          "アレクサ、洞窟探検を買って"
        ],
        "keywords": [
          "ゲーム"
        ],
        "customProductPrompts": {
          "purchasePromptDescription": "{PREMIUM_CONTENT_TITLE}には、エメラルドと仲間たちの新しい冒険が5つ含まれています。",
          "boughtCardDescription": "アレクサに洞窟探検をプレイしたいと言って、{PREMIUM_CONTENT_TITLE}をお楽しみください。"
        }
      }
    },
    "distributionCountries": [
      "JP"
    ],
    "pricing": {
      "amazon.co.jp": {
        "releaseDate": "2018-01-28T01:25Z",
        "defaultPriceListing": {
          "price": 199,
          "currency": "JPY"
        }
      }
    },
    "taxInformation": {
      "category": "SOFTWARE"
    }
  },
  "privacyAndCompliance": {
    "locales": {
      "ja-JP": {
        "privacyPolicyUrl": "url-to-privacy-policy"
      }
    }
  },
  "testingInstructions": "新しい冒険があるかどうかアレクサにたずねてください",
  "purchasableState": "PURCHASABLE"
}

消費型スキーマ

以下に消費型商品のスキーマを示します。

{
  "version": "1.0",
  "type": "CONSUMABLE",
  "referenceName": "five_hint_pack",
  "publishingInformation": {
    "locales": {
      "ja-JP": {
        "name": "Five-hint pack",
        "smallIconUri": "small-icon-uri",
        "largeIconUri": "large-icon-uri",
        "summary": "問題に行き詰ったときに使用できる5個のヒントです。",
        "description": "ヒント5個パックは、問題に答えられないときにいつでも使用できる5回分のヒントです。ヒントはゲームのどのタイミングでも使用できます。",
        "examplePhrases": [
          "アレクサ、ヒントを買って",
          "アレクサ、ヒントをちょうだい"
        ],
        "keywords": [
          "ゲーム"
        ],
        "customProductPrompts": {
          "purchasePromptDescription": "{PREMIUM_CONTENT_TITLE}は、いつでも使える5回分のヒントです。",
          "boughtCardDescription": "答えがわからないときはいつでも、アレクサにヒントを使ってと言うことで、{PREMIUM_CONTENT_TITLE}のヒントを使用できます。"
        }
      }
    },
    "distributionCountries": [
      "JP"
    ],
    "pricing": {
      "amazon.co.jp": {
        "releaseDate": "2018-10-01T01:25Z",
        "defaultPriceListing": {
          "price": 99,
          "currency": "JPY"
        }
      }
    },
    "taxInformation": {
      "category": "SOFTWARE"
    }
  },
  "privacyAndCompliance": {
    "locales": {
      "ja-JP": {
        "privacyPolicyUrl": "url-to-privacy-policy"
      }
    }
  },
  "testingInstructions": "ゲームを開始します。問題が出されたら、アレクサにヒントを頼んでください。",
  "purchasableState": "PURCHASABLE"
}

商品スキーマの各部分

以下に、スキル内商品のスキーマの各部分を説明します。

Productオブジェクト

商品には以下のフィールドが含まれています。

フィールド 説明
version バージョンを表示します。 文字列です。有効値: 1.0
type スキル内商品の型です。 文字列です。有効値: CONSUMABLEENTITLEMENTSUBSCRIPTION
referenceName スキル内商品の正式名です。コード内で商品を参照する場合にこの名前を使用します。 3文字から50文字の文字列です。スペースは含めません。
publishingInformation 商品がエンドユーザーに提示される方法に関するロケール別の情報を含むオブジェクトです。 publishingInformationオブジェクト
privacyAndCompliance ロケール別のプライバシーポリシーのURLを指定するオブジェクトです。現在サポートされているロケールはen-US、ja-JPです。 privacyAndComplianceオブジェクト
testingInstructions テストアカウントの認証情報などのテスト手順です。 1~4,000文字(両端の値を含む)の文字列です。
purchasableState 商品が購入可能かどうかを示します。購入できない商品に関する詳細については、後で説明する無効化された商品を参照してください。 文字列の列挙値です。 PURCHASABLEまたはNOT_PURCHASABLEのいずれかです。
subscriptionInformaton サブスクリプション型でのみ必須です。サブスクリプション型の請求頻度および使用期間を説明します。 SubscriptionInformationオブジェクト
無効化された商品

purchasableStateNOT_PURCHASABLEの場合、商品は無効であるとみなされます。公開中のスキルでは、ユーザーはこの商品を購入できなくなります。ただし、既に購入済みのユーザーは引き続き商品にアクセスする権利があるため、スキルでこれらのユーザーのサポートを継続する必要があります。サブスクリプション型の場合は、既存のユーザーはサブスクリプションの残りの期間は引き続き商品にアクセスできます。無効化されたサブスクリプションは自動的に更新されません。

SubscriptionInformationオブジェクト

サブスクリプション型でのみ必須です。サブスクリプション型の請求頻度および使用期間を説明します。

フィールド 説明
subscriptionPaymentFrequency サブスクリプション型でのみ必須です。サブスクリプションの請求頻度を示します。 文字列です。有効値: MONTHLY、YEARLY
subscriptionTrialPeriodDays サブスクリプション型でのみ必須です。試用期間を日数で示します。 0~31までの整数(両端の値を含む)です。

スキル内商品のPublishingInformationオブジェクト

publishingInformationオブジェクトには以下のフィールドが含まれています。

フィールド 説明
locales サポートされる各ロケールに固有の情報を提供するlocaleオブジェクトのマップです。現在サポートされているロケールはen-US、ja-JPです。 localeオブジェクトのマップを含むオブジェクト
distributionCountries 配信する国や地域の文字列を指定する、ISO 3166-1 alpha-2形式のリストです。現在有効な値はUSのみです。 文字列のリスト
pricing 商品の価格に関する詳細を含みます。 pricingオブジェクト
taxInformation 商品の税に関する情報を提供します。 オブジェクト
taxInformation.category 商品の税金のカテゴリーです。 文字列です。有効値: INFORMATION_SERVICES、NEWSPAPERS、PERIODICALS、SOFTWARE、STREAMING_RADIO、VIDEO。これらのカテゴリーの意味について詳しくは、税金のカテゴリーフィールド(開発者コンソール)を参照してください。

公開情報のロケール

publishingInformationオブジェクトには、localeオブジェクトのマップが含まれており、そのロケールに固有の公開情報が説明されています。各ロケールは2文字の言語コード、ハイフン、それに続く2文字の国コード、またはリージョンコードで識別されます。現在サポートされているロケールは「en-USja-JP」です。

フィールド 説明
<locale> 2文字の言語コード、ハイフン、それに続く2文字の国コードまたはリージョンコードです。 文字列です。有効値:en-US、ja-JP
<locale>.name このロケールでの商品の名前です。この名前は購入確認プロンプト、Alexaアプリの購入カード、メールの領収書で使用されます。 2~50文字(両端の値を含む)の文字列です。
<locale>.summary 商品の簡単な説明です。 1~160文字(両端の値を含む)の文字列です。
<locale>.description 商品の機能や使用するための前提条件を説明した詳細な説明です。 1~4,000文字(両端の値を含む)の文字列です。
<locale>.smallIconUri 108 x 108の透過済みPNGファイルのURIです。スキル内商品を表します。画像は表示する際に丸く切り取られるため、四辺に75pxのパディングを取ることをお勧めします。スキルに関連付けられた小さいアイコンを再利用することも、スキル内商品を表すユーザー定義の画像を指定することもできます。 適切な形式のURL文字列
<locale>.largeIconUri 512 x 512の透過済みPNGファイルのURIです。スキル内商品を表します。画像は表示する際に丸く切り取られるため、四辺に75pxのパディングを取ることをお勧めします。スキルに関連付けられた大きいアイコンを再利用することも、スキル内商品を表すユーザー定義の画像を指定することもできます。 適切な形式のURL文字列
<locale>.examplePhrases ユーザーが商品についてどのように依頼するかを示したサンプルフレーズのリストです。これらのフレーズは音声モデルでサポートされている必要があります。 1~3個の項目を含む文字列リストです。リスト内の各文字列は2~200文字(両端の値を含む)です。
<locale>.keywords 商品の提供を説明するキーワードとなるフレーズです。 1~30個の項目を含む文字列リストです。リスト内の各文字列は1~150文字(両端の値を含む)です。
<locale>.customProductPrompts このロケール向けのこの商品のプロンプトと説明を含むオブジェクトです。 customProductPromptsオブジェクト

customProductPromptsオブジェクト

customProductPromptsオブジェクトには、ユーザーが購入を行った際に商品の説明を提供する2つのフィールドがあります。これらを指定されたロケールの言語に設定する必要があります。

フィールド 説明
purchasePromptDescription ユーザーがサブスクリプションを購入またはキャンセルするときに聞く商品の説明です。purchasePromptDescriptionは以下を満たす必要があります。
  • 商品名を含めます。nameフィールドのトークンには「{PREMIUM_CONTENT_TITLE}」を使用します。プロンプトのこれ以外の部分には「{」や「}」を使用しないでください。
  • この商品のセールスポイントを含めます。
  • できるだけ簡潔にしてください。
  • 価格情報は含めないでください。価格は購入フローでAmazonによって自動的に付け加えられます。
  • ユーザーが前のステップで既に聞いたものと同じフレーズは繰り返さないようにします。

オプションでプレースホルダー{PREMIUM_CONTENT_TITLE}を含む、1~160文字の文字列です。
boughtCardDescriptionAlexaアプリのスキルカードに表示される商品の説明です。オプションでプレースホルダー{PREMIUM_CONTENT_TITLE}を含む、1~160文字(両端の値を含む)の文字列です。

pricingオブジェクト

pricingオブジェクトには、marketplaceオブジェクトのマップが含まれています。これにはそのマーケットプレイス価格に関する詳細が含まれています。現在サポートされているマーケットプレイスは「amazon.com」「amazon.co.jp」です。

フィールド 説明
<marketplace> 商品が販売される場所を説明します。 文字列です。有効な値:amazon.com、amazon.co.jp
<marketplace>.releaseDate 商品の販売開始時間を示すUTC形式の未来の日付です。指定された日付にかかわらず、スキルが公開されるとこの日付は変更できないことに注意してください。 ISO 8601形式の日付と時刻です。例: yyyy-MM-dd'T'HH:mm'Z' or yyyy-MM-dd
<marketplace>.defaultPriceListing このマーケットプレイスの商品に割り当てられたデフォルトの定価と通貨です。 オブジェクト
defaultPriceListing.price 商品の定価です。 買い切り型とサブスクリプション型の場合は、99~9999まで(両端の値を含む)の数字(長さ)です。消費型の場合は、99~999まで(両端の値を含む)の数字(長さ)です。
defaultPriceListing.currency 指定された定価の通貨を示すISO 4217の3文字のアルファベットコードです。 文字列です。有効値: USD、JPY

商品スキーマの各部分に戻る

privacyAndComplianceオブジェクト

privacyAndComplianceオブジェクトには、localeオブジェクトのマップが含まれています。これには、そのロケールに固有のプライバシーに関する情報が含まれています。各ロケールは2文字の言語コード、ハイフン、それに続く2文字の国コード、またはリージョンコードで識別されます。現在サポートされているロケールは「en-US、ja-JP」です。publishingInformation objectで識別される各ロケールには、このマップのエントリと、そのロケールの有効なprivacyPolicyUrlが含まれている必要があります。

フィールド 説明
<locale> 2文字の言語コード、ハイフン、それに続く2文字の国コード、またはリージョンコードを含む言語タグです。 文字列です。有効値:en-US、ja-JP
<locale>.privacyPolicyUrl このロケールのプライバシーポリシーへのURLです。 適切な形式のURL文字列

商品スキーマの各部分に戻る