ショップ
有料販売情報をダッシュボードで確認するには、有料購入に関するメソッドを呼び出してください。
財貨の購入
ユーザーがお金でゲーム内の様々な財貨を購入する場合、以下のメソッドを呼び出してください。
-
ユーザーがお金でジェムやダイヤなどのゲーム内財貨を獲得する場合、
InAppPurchase
とGetCurrency
を呼び出してください。-
ユーザーがリアルマネー(現金)を支払って購入する場合のみ、
InAppPurchase
メソッドを使用します。 -
from_category_slug
には、有料購入商品の種類(例:イベント、パッケージ、財貨、消費アイテムなど)を入力してください。 -
有料購入で財貨を獲得したことを表示するには、
GetCurrency
メソッドのfrom_entity
にentity.InAppPurchase
と入力します。
有料購入時には
InAppPurchase
メソッドのpurchasable_slug
の値とGetCurrency
のfrom_slug
の値を同じものにしてください。次の表では120 ダイヤ
になっています。メソッド パラメータ データ型 必須 備考 player_uuid
string
必須
character_uuid
string
必須
purchasable_slug
string
必須
120ダイヤ
purchase_quantity
float
必須
1
purchase_unit_price
float
必須
3300
purchase_total_price
float
必須
purchase_currency_code
必須
currencyCode.KRW
is_ad_remove
boolean
オプション
FALSE
メソッド パラメータ データ型 必須 備考 player_uuid
string
必須
character_uuid
string
必須
currency_slug
string
必須
ダイヤ
currency_quantity
float
必須
120
currency_total_quantity
float
オプション
9999
from_entity
オプション
entity.InAppPurchase
from_category_slug
string
オプション
財貨
from_slug
string
オプション
120ダイヤ
-
-
ユーザーがHard Currency(課金でのみ手に入れられる財貨)を支払い、Soft Currency(ゲームをプレイして獲得できる財貨)を獲得した場合、
UseCurrency
とGetCurrency
を呼び出してください。財貨の使用や獲得はゲーム内ショップの取り引きによって発生するため、
UseCurrency
のwhere_to_entity
とGetCurrency
メソッドのfrom_entity
をentity.ShopPurchase
と表記します。特定の商品を購入するために財貨を使い、その商品から財貨を獲得したため、
UseCurrency
メソッドのwhere_to_slug
とGetCurrency
のfrom_slug
には同じ商品名を、UseCurrency
メソッドのwhere_to_category_slug
とGetCurrency
のfrom_category_slug
には同じカテゴリー名を入力してください。次の表では1000ゴールド
とゴールド
になっています。メソッド パラメータ データ型 必須 備考 player_uuid
string
必須
character_uuid
string
必須
currency_slug
string
必須
ダイヤ
currency_quantity
float
必須
50
currency_total_quantity
float
オプション
9999
where_to_entity
オプション
entity.ShopPurchase
where_to_category_slug
string
オプション
ゴールド
where_to_slug
string
オプション
1000ゴールド
メソッド パラメータ データ型 必須 備考 player_uuid
string
必須
character_uuid
string
必須
currency_slug
string
必須
ゴールド
currency_quantity
float
必須
1000
currency_total_quantity
float
オプション
9999
from_entity
オプション
entity.ShopPurchase
from_category_slug
string
オプション
ゴールド
from_slug
string
オプション
1000ゴールド
ランダムボックスの購入
ユーザーがお金(現金)でランダムボックスを購入する場合、以下のメソッドを呼び出します。
-
ランダムボックスの購入で特定のアイテムを即時獲得する場合、以下のメソッドを呼び出します。
有料購入時にランダムボックスで獲得できるアイテムや財貨を入力する場合、
InAppPurchase
メソッドのpurchasable_slug
とGetRandomBox
およびGetEquipment
メソッドのfrom_slug
の値は同じでなければなりません。以下の表ではノーマル銃のガチャチケット
がサンプルとして入っています。メソッド パラメータ データ型 必須 備考 player_uuid
string
必須
character_uuid
string
必須
purchasable_slug
string
必須
ノーマル銃のガチャチケット
purchase_quantity
float
必須
1
purchase_unit_price
float
必須
3300
purchase_total_price
float
必須
purchase_currency_code
必須
currencyCode.KRW
is_ad_remove
boolean
オプション
FALSE
メソッド パラメータ データ型 必須 備考 player_uuid
string
必須
character_uuid
string
必須
TentuPlayKeyword._DUMMY_CHARACTER_ID_
item_slug
string
必須
ノーマル銃のガチャチケット
item_quantity
float
必須
1
from_entity
オプション
entity.InAppPurchase
from_category_slug
string
オプション
武器ショップ
from_slug
string
オプション
ノーマル銃のガチャチケット
メソッド パラメータ データ型 必須 備考 player_uuid
string
必須
character_uuid
string
必須
TentuPlayKeyword._DUMMY_CHARACTER_ID_
item_slug
string
必須
ノーマル銃のガチャチケット
item_quantity
float
必須
1
メソッド パラメータ データ型 必須 備考 player_uuid
string
必須
character_uuid
string
必須
TentuPlayKeyword._DUMMY_CHARACTER_ID_
item_slug
string
必須
銃
item_quantity
float
必須
1
from_entity
オプション
entity.OpenRandomBox
from_category_slug
string
オプション
一般
from_slug
string
オプション
ノーマル銃のガチャチケット
-
ランダムボックスの購入時に特定のランダムボックスを獲得し、ユーザーがその開封時期を選べる場合は
InAppPurchase
とGetRandomBox
メソッドを呼び出します。以後ユーザーがランダムボックスを開封して特定のObjectを獲得する際に
OpenRandomBox
およびGetRandomBox
メソッドを呼び出します。メソッド パラメータ データ型 必須 備考 player_uuid
string
必須
character_uuid
string
必須
purchasable_slug
string
必須
アレゴリアのボックス
purchase_quantity
float
必須
1
purchase_unit_price
float
必須
3300
purchase_total_price
float
必須
purchase_currency_code
必須
currencyCode.KRW
is_ad_remove
boolean
オプション
FALSE
メソッド パラメータ データ型 必須 備考 player_uuid
string
必須
character_uuid
string
必須
TentuPlayKeyword._DUMMY_CHARACTER_ID_
item_slug
string
必須
アレゴリアのボックス
item_quantity
float
必須
1
from_entity
オプション
entity.InAppPurchase
from_category_slug
string
オプション
ダイヤディウム
(ショップ名)from_slug
string
オプション
アレゴリアのボックス×1
パッケージ商品を購入
ユーザーが様々なアイテムが含まれている有料パッケージを購入した場合、InAppPurchase
メソッドと同時に獲得した各Object(例:キャラクター、アイテム)に応じて Get{ Object Type }
メソッドを呼び出してください。
TentuPlayはゲームObjectをCharacter、Currency、Equipmentなどの10種類に分けています。Object獲得のメソッド名は |
例えばあるユーザーが2種類の財貨(「次元石」と「コスト」)とトークン1種類(「プレミアムチケット」)が含まれた「毎月召喚1」を購入した場合、次の表のようにInAppPurchase
およびGetToken
を呼び出すと同時にGetCurrency
を2回呼び出す必要があります。
メソッド | パラメータ | データ型 | 必須 | 備考 |
---|---|---|---|---|
player_uuid |
string |
必須 |
||
character_uuid |
string |
必須 |
|
|
purchasable_slug |
string |
必須 |
|
|
purchase_quantity |
float |
必須 |
|
|
purchase_unit_price |
float |
必須 |
|
|
purchase_total_price |
float |
必須 |
||
purchase_currency_code |
必須 |
|
||
is_ad_remove |
boolean |
オプション |
|
メソッド |
パラメータ |
データ型 |
必須 |
備考 |
|
---|---|---|---|---|---|
財貨A |
財貨B |
||||
player_uuid |
string |
必須 |
|||
character_uuid |
string |
必須 |
|
||
currency_slug |
string |
必須 |
|
|
|
currency_quantity |
float |
必須 |
|
|
|
currency_total_quantity |
float |
オプション |
|
|
|
from_entity |
オプション |
|
|||
from_category_slug |
string |
オプション |
|
||
from_slug |
string |
オプション |
|
メソッド | パラメータ | データ型 | 必須 | 備考 |
---|---|---|---|---|
player_uuid |
string |
必須 |
||
character_uuid |
string |
必須 |
|
|
item_slug |
string |
必須 |
|
|
item_quantity |
float |
必須 |
|
|
from_entity |
オプション |
|
||
from_category_slug |
string |
オプション |
|
|
from_slug |
string |
オプション |
|
広告非表示商品の購入
ユーザーが有料の広告非表示商品を購入した場合、InAppPurchase
のメソッドを呼び出してください。
広告非表示商品を購入する場合、 |
メソッド | パラメータ | データ型 | 必須 | 備考 |
---|---|---|---|---|
player_uuid |
string |
必須 |
||
character_uuid |
string |
必須 |
||
purchasable_slug |
string |
必須 |
広告非表示アイテム名 |
|
purchase_quantity |
float |
必須 |
|
|
purchase_unit_price |
float |
必須 |
|
|
purchase_total_price |
float |
必須 |
||
purchase_currency_code |
必須 |
|
||
is_ad_remove |
boolean |
オプション |
|