ショップ
有料販売のダッシュボードを確認するためには、有料購入に関して以下のメソッドを呼び出してください。
財貨を購入
-
ユーザーがお金でゲームの財貨(ex.ジェム、ダイヤなど)を獲得した場合、以下のメソッドを呼び出してください。
ユーザーがお金(現金)で購入する場合にのみ「InAppPurchase」メソッドを使います。
有料購入時にInAppPurchaseメソッドのpurchasable_slug
とGetCurrencyのfrom_slug
は、以下と同じく入力してください。
from_category_slug
には、有料購入商品の種類(ex.イベント、パッケージ、財貨、消費アイテムなど)を入力してください。
有料購入で貨幣の財貨を獲得したことを表示するため、GetCurrencyメソッドのfrom_entity
をentity.InAppPurchaseで表記します。InAppPurchase purchasable_slug { 120ダイヤ } purchase_quantity 1 purchase_unit_price 3300 purchase_total_price 3300 purchase_currency_code currencyCode.KRW is_ad_remove { FALSE }
GetCurrency player_uuid { player_uuid } character_uuid { character_uuid } currency_slug { ダイヤ } currency_quantity 120 currency_total_quantity 9999 from_entity entity.InAppPurchase from_category_slug { 財貨 } from_slug { 120ダイヤ }
-
ユーザーがHard Currency(課金でのみ手に入れられる貨幣)を支払い、Soft Currency(ゲームをプレイして獲得できる貨幣)を獲得した場合、以下のメソッドを呼び出してください。
貨幣の使用や獲得は、ゲームのショップでの取り引きにより発生したため、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
は同一のカテゴリー名を入力してください。UseCurrency player_uuid { player_uuid } character_uuid { character_uuid }
currency_slug { ダイヤ } currency_quantity 50 currency_total_quantity 9999 where_to_entity entity.ShopPurchase where_to_category_slug { ゴールド } where_to_slug { 1000ゴールド }
GetCurrency player_uuid { player_uuid } character_uuid { character_uuid }
currency_slug { ゴールド } currency_quantity 1000 currency_total_quantity 9999 from_entity entity.ShopPurchase from_category_slug { ゴールド } from_slug { 1000ゴールド }
ランダムボックスを購入
ユーザーが有料のランダムボックスを購入した場合、以下のメソッドを呼び出してください。
有料での購入時にランダムボックスで獲得できるアイテムや財貨について入力する際に、InAppPurchaseメソッドの`purchasable_slug`とGetRandomBox及びGetEquipmentメソッドの`from_slug`と同一である必要があります。
-
ランダムボックスを購入する際に特定のアイテムを即時獲得する場合、以下のメソッドを呼び出します。
InAppPurchase purchasable_slug { ノーマル銃のガチャチケット } purchase_quantity 1 purchase_unit_price 3300 purchase_total_price 3300 purchase_currency_code currencyCode.KRW is_ad_remove FALSE
GetRandomBox player_uuid { player_uuid } character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID item_slug {ノーマル銃のガチャチケット} item_quantity 1 from_entity entity.InAppPurchase from_category_slug {武器ショップ}
from_slug {ノーマル銃のガチャチケット}
OpenRandomBox player_uuid { player_uuid } character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID item_slug {ノーマル銃のガチャチケット} item_quantity 1
GetEquipment player_uuid { player_uuid } character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID item_slug {A銃} item_quantity 1 from_entity entity.OpenRandomBox from_category_slug {ノーマル} from_slug {ノーマル銃のガチャチケット}
-
ランダムボックスを購入すると特定のランダムボックスを獲得し、ユーザーが開封するタイミングを選択できる場合、以下のメソッドを呼び出します。
今後、ユーザーがランダムボックスを開封して特定のObjectを獲得する際にOpenRandomBox及びGetRandomBoxメソッドを呼び出します。InAppPurchase purchasable_slug {アレゴリアのボックス} purchase_quantity 1 purchase_unit_price 3300 purchase_total_price 3300 purchase_currency_code currencyCode.KRW is_ad_remove FALSE
GetRandomBox player_uuid { player_uuid } character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID item_slug {アレゴリアのボックス} item_quantity* 1 from_entity entity.InAppPurchase from_category_slug {ダイヤディウム(ショップの名前)}
from_slug {アレゴリアのボックスX1}
パッケージ商品を購入
ユーザーが様々なアイテムが含まれている有料のパッケージを購入した場合、InAppPurchaseメソッドと同時に獲得した各Object(ex.キャラクター、アイテム)に合わせてGet{Object Type}メソッドを呼び出してください。
TENTUPLAYは、ゲームのObjectをCharacter、Currency、Equipmentなど、10個のObjectとして区分けしています。
Object獲得のメソッド名は、GetEquipmentやGetCosmeticのようにGet{Object Type}形式になっています。
詳細については Entities をご参考ください。
Object獲得のメソッド名は、GetEquipmentやGetCosmeticのようにGet{Object Type}形式になっています。
詳細については Entities をご参考ください。
player_uuid | { player_uuid } |
---|---|
character_uuid | TentuPlayKeyword.DUMMY_CHARACTER_ID |
purchasable_slug
{毎月召喚パッケージ1} |
|
purchase_quantity | 1 |
purchase_unit_price
29000 |
|
purchase_total_price | 29000 |
purchase_currency_code | currencyCode.KRW |
is_ad_remove | FALSE |
player_uuid | { player_uuid } | { player_uuid } |
---|---|---|
character_uuid | TentuPlayKeyword.DUMMY_CHARACTER_ID | TentuPlayKeyword.DUMMY_CHARACTER_ID |
currency_slug | {次元石} | {コスモ} |
currency_quantity | 3300 | 50 |
currency_total_price | 99999 | 9999 |
from_entity | entity.InAppPurchase | entity.InAppPurchase |
from_category_slug | {毎月召喚} | {毎月召喚} |
from_slug | {毎月召喚パッケージ1} | {毎月召喚パッケージ1} |
player_uuid | { player_uuid } |
---|---|
character_uuid | TentuPlayKeyword.DUMMY_CHARACTER_ID |
item_slug | {プレミアムチケット} |
item_quantity | 2 |
from_entity | entity.InAppPurchase |
from_category_slug | {毎月召喚} |
from_slug | {毎月召喚パッケージ1} |
広告非表示商品を購入
ユーザーが有料の広告非表示の商品を購入した場合、InAppPurchaseのメソッドを呼び出してください。
広告非表示商品を購入する場合、InAppPurchaseメソッドの
is_ad_remove
をTRUEで入力してください。
player_uuid | { player_uuid } |
---|---|
character_uuid | |
purchasable_slug* | {広告非表示アイテム} |
purchase_quantity | 1 |
purchase_unit_price | 16000 |
purchase_total_price | 16000 |
purchase_currency_code | currencyCode.KRW |
is_ad_remove | TRUE |