TPStashEvent.UseCurrency

TPStashEvent.UseCurrency(
    userId,
    character_uuid,
    currency_slug,
    currency_quantity,
    currency_total_quantity,
    where_to_entity,
    where_to_category_slug,
    where_to_slug
)

Description

UseCurrency collects the data of the character’s spending of in-game currency. It needs to be called when an event of currency consumption occurs in the middle of the game. It can be used for the analysis of personas about currency consumption.

Parameters

Name Description Required

UserId

Player’s unique user ID (not a character’s ID) that is given by Roblox: Player.UserId

Required

character_uuid

Player’s character’s unique lD

If there is no character in the game or If you want to use it for the player, not a character, set character_uuid to TentuPlayKeyword._DUMMY_CHARACTER_ID_.

Required

currency_slug

Unique identifier of currency such as "gold", "diamond", and "crystal"

Required

currency_quantity

The number or amount of currency used

Required

currency_total_quantity

The total number or amount of reserved currency after currency usage

This parameter is not mandatory but highly recommended as it helps create more accurate currency reserve status.

Optional

where_to_entity

The entity type where the character gets to by using the currency

Entities

TPStashEvent.Entity.None
TPStashEvent.Entity.Etc
TPStashEvent.Entity.Join
TPStashEvent.Entity.Login
TPStashEvent.Entity.LoginAsCharacter
TPStashEvent.Entity.InAppPurchase
TPStashEvent.Entity.ShopPurchase
TPStashEvent.Entity.Trade
TPStashEvent.Entity.PlayQuest
TPStashEvent.Entity.GetBonus
TPStashEvent.Entity.ChangeCharacterArchetype
TPStashEvent.Entity.ChangeStat
TPStashEvent.Entity.ChangeCustomAbility
TPStashEvent.Entity.PlayStage
TPStashEvent.Entity.GetCharacter
TPStashEvent.Entity.GetCurrency
TPStashEvent.Entity.GetInfrastructure
TPStashEvent.Entity.GetPet
TPStashEvent.Entity.GetToken
TPStashEvent.Entity.GetConsumable
TPStashEvent.Entity.GetMaterial
TPStashEvent.Entity.GetEquipment
TPStashEvent.Entity.GetCostume
TPStashEvent.Entity.GetRandomBox
TPStashEvent.Entity.UseCurrency
TPStashEvent.Entity.EquipInfrastructure
TPStashEvent.Entity.EquipPet
TPStashEvent.Entity.UseToken
TPStashEvent.Entity.UseConsumable
TPStashEvent.Entity.UseMaterial
TPStashEvent.Entity.EquipEquipment
TPStashEvent.Entity.EquipCostume
TPStashEvent.Entity.OpenRandomBox
TPStashEvent.Entity.EquipSkill
TPStashEvent.Entity.DismissCharacter
TPStashEvent.Entity.DismissPet
TPStashEvent.Entity.DismissToken
TPStashEvent.Entity.DismissConsumable
TPStashEvent.Entity.DismissMaterial
TPStashEvent.Entity.DismissEquipment
TPStashEvent.Entity.DismissCostume
TPStashEvent.Entity.DismissRandomBox
TPStashEvent.Entity.LevelUpCharacter
TPStashEvent.Entity.LevelUpInfrastructure
TPStashEvent.Entity.LevelUpPet
TPStashEvent.Entity.LevelUpConsumable
TPStashEvent.Entity.LevelUpMaterial
TPStashEvent.Entity.LevelUpEquipment
TPStashEvent.Entity.LevelUpCostume
TPStashEvent.Entity.LevelUpSkill
TPStashEvent.Entity.Deposit
TPStashEvent.Entity.Withdraw
TPStashEvent.Entity.FinishedTutorial

Optional

where_to_category_slug

The category of place, situation, or outcome to which the player gets by using the currency

Optional

where_to_slug

The name of place, situation, or outcome to which the player gets by using the currency

Optional

«GetRandomBox

EquipInfrastructure»