商品構成

このページでは、XGのサブスクリプション商品マスタについて説明します。

ストア商品構成

各ストアに登録するサブスクリプション商品の構成について説明します。

App Store

サブスクリプションごとに商品ID(productId)を登録するため、月額と年額で商品IDが異なります。 サブスクリプショングループ単位でユーザーが加入できるサブスクリプションは1つのみです。

注釈

App Storeのサブスクリプショングループは、XGに登録するサブスクリプショングループIDとは異なります。

App Store 商品構成例

サブスクリプショングループ

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つしか有効にできません。

Google Play 商品構成例

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は全商品でユニークにする必要があります

DMM GAMES 商品構成例

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

検証なし