콘솔로 이동

상점

유료 판매 관련 대시보드를 확인하시려면 유료 구매와 관련하여 아래와 같이 메소드를 호출하세요.

화폐 구매

  • 유저가 현금을 지불하여 게임 내 화폐 (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 { 알레고리아 상자 X 1 }


패키지상품 구매

유저가 현금을 지불하고 다양한 아이템이 포함된 패키지 상품을 구매한 경우 InAppPurchase 메소드와 함께 획득한 각 Object(ex. 캐릭터, 아이템)에 맞는 Get{ Object 구문 } 메소드를 호출하세요.

텐투플레이는 게임 내 Object를 Character, Currency, Equipment 등 10개로 구분하고 있습니다.
Object 획득 메소드 명은 GetEquipment 와 GetCosmetic 과 같이 Get{ Object 구문 } 형식으로 구현되어 있습니다.
자세한 설명은 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