상점
유료 판매 관련 정보를 대시보드에서 보려면 유료 구매와 관련된 메소드를 호출하세요.
화폐 구매
유저가 현금을 지불하여 게임 내 여러 재화를 획득하는 경우 다음 메소드를 호출하세요.
-
유저가 현금을 지불하여 젬이나 다이아 같은 게임 내 화폐를 획득하는 경우
InAppPurchase
와GetCurrency
를 호출하세요.-
유저가 현실의 화폐(현금)를 지불하고 구매하는 경우에만
InAppPurchase
메소드를 사용합니다. -
from_category_slug
에는 해당 유료 구매 상품의 종류(ex. 이벤트, 패키지, 재화, 소모품 등)를 입력합니다. -
유료구매로부터 화폐 재화를 획득하였음을 표시하기 위하여
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
메소드와 함께 획득한 각 오브젝트(예: 캐릭터, 아이템)에 맞는 Get{ 오브젝트 }
메소드를 호출하세요.
텐투플레이는 게임 내 오브젝트를 Character, Currency, Equipment 등 10개로 구분하고 있습니다. 오브젝트 획득 메소드 명은 |
가령 어떤 유저가 화페 2종("차원석"과 "코스모")과 토큰 1종("프리미엄 티켓")이 포함되어 있는 "월소환 패키지 1"을 구입했다면 아래 표와 같이 InAppPurchase
및 GetToken
의 호출과 함께 GetCurrency
를 두 번 호출해야 합니다.
메소드 | 파라미터 | 자료형 | 필수여부 | 비고 |
---|---|---|---|---|
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 |
선택 |
|