상점
유료 판매 관련 대시보드를 확인하시려면 유료 구매와 관련하여 아래와 같이 메소드를 호출하세요.
화폐 구매
-
유저가 현금을 지불하여 게임 내 화폐 (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