Advertisement
Call the following methods if you want to show ads in your game,
Interstitial ads
To show an interstitial ad, call WatchAd
.
Put |
|
Method |
Parameter |
Type |
Required |
Notes |
|
---|---|---|---|---|---|
1. Show ad |
2. Start ad watch |
||||
player_uuid |
string |
Required |
|||
character_uuid |
string |
Required |
|
||
ad_slug |
string |
Required |
Ad ID |
||
ad_type |
Required |
|
|||
placed_at |
Required |
|
|||
ad_status |
Required |
|
|
||
placed_at_slug |
string |
Optional |
|
Method |
Parameter |
Type |
Required |
Notes |
|
---|---|---|---|---|---|
3. Finished watching ad |
4. Quit out of ad |
||||
player_uuid |
string |
Required |
|||
character_uuid |
string |
Required |
|
||
ad_slug |
string |
Required |
Ad ID |
||
ad_type |
Required |
|
|||
placed_at |
Required |
|
|||
ad_status |
Required |
|
|
||
placed_at_slug |
string |
Optional |
|
Rewarded ads
To show a rewarded ad, call the following methods.
-
Call the
WatchAd
methods by ad view stages.Put
adType.Reward
in thead_type
parameter.Method
Parameter
Type
Required
Notes
1. Show ad
(After cool down)2. Start ad watch
player_uuid
string
Required
character_uuid
string
Required
TentuPlayKeyword._DUMMY_CHARACTER_ID_
ad_slug
string
Required
Ad ID
ad_type
Required
adType.Reward
placed_at
Required
entity:StageStart
ad_status
Required
adStatus.Ready
adStatus.Start
placed_at_slug
string
Optional
Play
Method
Parameter
Type
Required
Notes
3. Finished watching ad
4. Quit out of ad
player_uuid
string
Required
character_uuid
string
Required
TentuPlayKeyword._DUMMY_CHARACTER_ID_
ad_slug
string
Required
Ad ID
ad_type
Required
adType.Reward
placed_at
Required
entity:StageStart
ad_status
Required
adStatus.End
adStatus.Quit
placed_at_slug
string
Optional
Play
-
If a user is rewarded for ad view, call
GetBonus
because it is not acquired through in-game play.Method Parameter Type Required Notes player_uuid
string
Required
character_uuid
string
Required
TentuPlayKeyword._DUMMY_CHARACTER_ID_
bonus_slug
string
Required
Free Gold Ad
bonus_category_slug
string
Required
Free Gold Ad
is_automated
boolean
Optional
FALSE
-
Depending on the reward type, call the corresponding methods
-
If the reward for ad view is a currency, call
GetCurrency
. -
If the reward is not a currency but another object like Token or Material, call the
Get{ Object }
method (for example,GetToken
,GetMaterial
).
-
Method | Parameter | Type | Required | Notes |
---|---|---|---|---|
player_uuid |
string |
Required |
||
character_uuid |
string |
Required |
|
|
currency_slug |
string |
Required |
|
|
currency_quantity |
float |
Required |
|
|
currency_total_quantity |
float |
Optional |
|
|
from_entity |
Optional |
|
||
from_category_slug |
string |
Optional |
|
|
from_slug |
string |
Optional |
|