商品構成¶
このページでは、XGのサブスクリプション商品マスタについて説明します。
ストア商品構成¶
各ストアに登録するサブスクリプション商品の構成について説明します。
App Store¶
サブスクリプションごとに商品ID(productId)を登録するため、月額と年額で商品IDが異なります。 サブスクリプショングループ単位でユーザーが加入できるサブスクリプションは1つのみです。
注釈
App Storeのサブスクリプショングループは、XGに登録するサブスクリプショングループIDとは異なります。
サブスクリプショングループ |
productId |
期間 |
|---|---|---|
com.exnoa.xg.sample.group01 |
com.exnoa.xg.sample.appstore01_monthly |
1ヶ月 |
com.exnoa.xg.sample.group01 |
com.exnoa.xg.sample.appstore01_yearly |
1年 |
com.exnoa.xg.sample.group02 |
com.exnoa.xg.sample.appstore02_monthly |
1ヶ月 |
com.exnoa.xg.sample.group02 |
com.exnoa.xg.sample.appstore02_yearly |
1年 |
Google Play¶
商品ごとに商品ID(productId)を設定し、プランにはプランID(basePlanId)を設定します。 同一商品は同時に1つしか有効にできません。
productId |
basePlanId |
期間 |
|---|---|---|
com.exnoa.xg.sample.googleplay01 |
googleplay01-monthly |
1ヶ月 |
com.exnoa.xg.sample.googleplay01 |
googleplay01-yearly |
1年 |
com.exnoa.xg.sample.googleplay02 |
googleplay02-monthly |
1ヶ月 |
com.exnoa.xg.sample.googleplay02 |
googleplay02-yearly |
1年 |
DMM GAMES¶
商品構成はGoogle Playと同様で、商品ID(productId)とプランID(planId)で構成されます。
注釈
期間は1ヶ月、1週間の2種類のみ対応しています(年額は未対応)
プランIDは全商品でユニークにする必要があります
productId |
planId |
期間 |
|---|---|---|
com.exnoa.xg.sample.dmmgames01 |
dmmgames01_monthly |
1ヶ月 |
com.exnoa.xg.sample.dmmgames01 |
dmmgames01_weekly |
1週間 |
com.exnoa.xg.sample.dmmgames02 |
dmmgames02_monthly |
1ヶ月 |
com.exnoa.xg.sample.dmmgames02 |
dmmgames02_weekly |
1週間 |
XG商品マスタ¶
XG商品マスタに登録する項目の一覧です。
項目 |
例 |
説明 |
|---|---|---|
商品ID |
com.exnoa.xg.sample.appstore01_monthly |
各ストアに登録した商品ID(productId)を指定。ストアごとの商品構成は上記を参照 |
プランID |
appstore01_monthly |
App Store: 任意の文字列、Google Play: basePlanId、DMM GAMES: planId |
販売価格 |
1000 |
商品の販売価格 |
サブスクリプショングループID |
sub-product0001 |
ストア横断で同一商品を管理するためのXG側のID。同一ユーザーが同一グループのサブスクリプションを複数有効にすることを防止 |
オファータイプ |
first_free |
各ストアのオファー(初回無料・割引等)をXGで統一的に扱うための分類 |
オファーID |
sub-product0001-monthly-first_free |
App Store: 任意の文字列(offerIdentifierとは異なる)、Google Play / DMM GAMES: ストアで発行されたofferId |
オファー価格 |
0 |
オファーを適用した時の価格。購入検証で使用 |
サブスクリプションタグ |
initial |
継続回数や初回購入時などでゲーム内通貨発行数を切り替えるためのタグ |
ゲーム内通貨発行設定 |
有償通貨 gem 500、無償通貨 gem 500 |
サブスクリプションタグごとに発行するゲーム内通貨の種類・数量 |
プラン設定¶
プランID¶
プランの識別子です。月額・年額など、同一商品内の異なる期間プランを識別します
詳細は 用語集 の「プランID」を参照してください。
オファー設定¶
各ストアで提供されているオファー機能をXGで統一的に扱います。 DMM GAMESは初回割引・初回無料のみ対応しているため、App StoreとGoogle Playも同様の範囲で対応しています。
オファーID¶
初回無料・割引等のオファーの識別子です。オファーを適用した購入を判定するために使用します
詳細は 用語集 の「オファーID」を参照してください。
オファータイプ¶
オファーの分類です。初回購入時に割引や無料期間を提供する際に使用します
詳細は 用語集 の「オファータイプ」を参照してください。
オファー価格¶
オファーを適用した時の価格を登録します。購入時の購入検証で価格が一致するか検証されます。
ストア |
検証方法 |
|---|---|
App Store |
GetTransactionInfoのpriceと比較 |
Google Play |
検証なし ※今後追加予定 |
DMM GAMES |
検証なし |