コンソール画面

ショップ

有料販売のダッシュボードを確認するためには、有料購入に関して以下のメソッドを呼び出してください。

財貨を購入

  • ユーザーがお金でゲームの財貨(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 をご参考ください。

InAppPurchase
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


GetCurrency
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}

GetToken
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で入力してください。
InAppPurchase
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