ショップ

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

財貨を購入

• ユーザーがお金でゲームの財貨（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	{ ノーマル銃のガチャチケット }
  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}メソッドを呼び出してください。

広告非表示商品を購入

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