ショップ

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

財貨の購入

ユーザーがお金でゲーム内の様々な財貨を購入する場合、以下のメソッドを呼び出してください。

  • ユーザーがお金でジェムやダイヤなどのゲーム内財貨を獲得する場合、InAppPurchaseとGetCurrencyを呼び出してください。

    • ユーザーがリアルマネー（現金）を支払って購入する場合のみ、InAppPurchase メソッドを使用します。

    • from_category_slugには、有料購入商品の種類（例：イベント、パッケージ、財貨、消費アイテムなど）を入力してください。

    • 有料購入で財貨を獲得したことを表示するには、GetCurrency メソッドのfrom_entityにentity.InAppPurchaseと入力します。

    有料購入時には InAppPurchase メソッドの purchasable_slug の値とGetCurrencyのfrom_slugの値を同じものにしてください。次の表では120 ダイヤになっています。
    メソッド パラメータ データ型 必須 備考

    InAppPurchase

    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
    メソッド パラメータ データ型 必須 備考

    GetCurrency

    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ゴールドとゴールドになっています。
    メソッド パラメータ データ型 必須 備考

    UseCurrency

    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ゴールド
    メソッド パラメータ データ型 必須 備考

    GetCurrency

    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の値は同じでなければなりません。以下の表ではノーマル銃のガチャチケットがサンプルとして入っています。
    メソッド パラメータ データ型 必須 備考

    InAppPurchase

    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
    メソッド パラメータ データ型 必須 備考

    GetRandomBox

    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

    オプション

    ノーマル銃のガチャチケット
    メソッド パラメータ データ型 必須 備考

    OpenRandomBox

    player_uuid

    string

    必須

    character_uuid

    string

    必須

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    item_slug

    string

    必須

    ノーマル銃のガチャチケット

    item_quantity

    float

    必須

    1
    メソッド パラメータ データ型 必須 備考

    GetEquipment

    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 メソッドを呼び出します。
    メソッド パラメータ データ型 必須 備考

    InAppPurchase

    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
    メソッド パラメータ データ型 必須 備考

    GetRandomBox

    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獲得のメソッド名はGetEquipmentやGetCosmeticのように Get{ Object } 形式になっています。詳しくは オブジェクトをご覧ください。

例えばあるユーザーが2種類の財貨（「次元石」と「コスト」）とトークン1種類（「プレミアムチケット」）が含まれた「毎月召喚1」を購入した場合、次の表のようにInAppPurchaseおよびGetTokenを呼び出すと同時にGetCurrencyを2回呼び出す必要があります。

メソッド パラメータ データ型 必須 備考

InAppPurchase

player_uuid

string

必須

character_uuid

string

必須

TentuPlayKeyword._DUMMY_CHARACTER_ID_

purchasable_slug

string

必須

毎月召喚1

purchase_quantity

float

必須

1

purchase_unit_price

float

必須

29000

purchase_total_price

float

必須

purchase_currency_code

必須

currencyCode.KRW

is_ad_remove

boolean

オプション

FALSE

メソッド

パラメータ

データ型

必須

備考

財貨A

財貨B

GetCurrency

player_uuid

string

必須

character_uuid

string

必須

TentuPlayKeyword._DUMMY_CHARACTER_ID_

currency_slug

string

必須

次元石

コスモ

currency_quantity

float

必須

3300

50

currency_total_quantity

float

オプション

99990

9999

from_entity

オプション

entity.ShopPurchase

from_category_slug

string

オプション

毎月召喚

from_slug

string

オプション

毎月召喚パッケージ1
メソッド パラメータ データ型 必須 備考

GetToken

player_uuid

string

必須

character_uuid

string

必須

TentuPlayKeyword._DUMMY_CHARACTER_ID_

item_slug

string

必須

プレミアムチケット

item_quantity

float

必須

2

from_entity

オプション

entity.InAppPurchase

from_category_slug

string

オプション

毎月召喚

from_slug

string

オプション

毎月召喚パッケージ1

広告非表示商品の購入

ユーザーが有料の広告非表示商品を購入した場合、InAppPurchaseのメソッドを呼び出してください。

広告非表示商品を購入する場合、InAppPurchase メソッドの is_ad_remove をTRUEにしてください。
メソッド パラメータ データ型 必須 備考

InAppPurchase

player_uuid

string

必須

character_uuid

string

必須

purchasable_slug

string

必須

広告非表示アイテム名

purchase_quantity

float

必須

1

purchase_unit_price

float

必須

16000

purchase_total_price

float

必須

purchase_currency_code

必須

currencyCode.KRW

is_ad_remove

boolean

オプション

TRUE