広告視聴
アプリ内で広告を露出させる場合、以下のような広告関連メソッドを呼び出してください。
全面広告
全面広告を表示する場合、以下のようにWatchAdメソッドを呼び出してください。
|
|
メソッド |
パラメータ |
データ型 |
必須 |
備考 |
|
---|---|---|---|---|---|
1. 広告露出 |
2. 広告視聴開始 |
||||
player_uuid |
string |
必須 |
|||
character_uuid |
string |
必須 |
|
||
ad_slug |
string |
必須 |
広告ID |
||
ad_type |
必須 |
|
|||
placed_at |
必須 |
|
|||
ad_status |
必須 |
|
|
||
placed_at_slug |
string |
オプション |
|
メソッド |
パラメータ |
データ型 |
必須 |
備考 |
|
---|---|---|---|---|---|
3. 広告視聴完了 |
4. 広告視聴終了 |
||||
player_uuid |
string |
必須 |
|||
character_uuid |
string |
必須 |
|
||
ad_slug |
string |
必須 |
広告ID |
||
ad_type |
必須 |
|
|||
placed_at |
必須 |
|
|||
ad_status |
必須 |
|
|
||
placed_at_slug |
string |
オプション |
|
報酬付き広告
報酬付き広告を表示させるには以下のように関連メソッドを呼び出してください。
-
広告視聴の段階別に
WatchAd
メソッドを呼び出してください。ad_type
パラメータとしてadType.Reward
を入力してください。メソッド
パラメータ
データ型
必須
備考
1. 広告露出
(クールタイムの終了)2. 広告視聴開始
player_uuid
string
必須
character_uuid
string
必須
TentuPlayKeyword._DUMMY_CHARACTER_ID_
ad_slug
string
必須
広告ID
ad_type
必須
adType.Reward
placed_at
必須
entity:StageStart
ad_status
必須
adStatus.Ready
adStatus.Start
placed_at_slug
string
オプション
プレイ
メソッド
パラメータ
データ型
必須
備考
3. 広告視聴完了
4. 広告視聴終了
または中断player_uuid
string
必須
character_uuid
string
必須
TentuPlayKeyword._DUMMY_CHARACTER_ID_
ad_slug
string
必須
広告ID
ad_type
必須
adType.Reward
placed_at
必須
entity:StageStart
ad_status
必須
adStatus.End
adStatus.Quit
placed_at_slug
string
オプション
プレイ
-
ゲームプレイとは関係のない広告視聴を通じて報酬を獲得する場合、
GetBonus
を呼び出してください。メソッド パラメータ データ型 必須 備考 player_uuid
string
必須
character_uuid
string
必須
TentuPlayKeyword._DUMMY_CHARACTER_ID_
bonus_slug
string
必須
無料ゴールド広告
bonus_category_slug
string
必須
無料ゴールド広告
is_automated
boolean
オプション
FALSE
-
広告視聴で受け取った報酬の種類に応じて関連メソッドを呼び出してください。
-
広告視聴の報酬として財貨を獲得する場合、
GetCurrency
メソッドを呼び出してください。 -
広告視聴の報酬としてトークンや材料などのオブジェクトを獲得する場合、
Get{ Object }
を呼び出してください(例:GetToken
、GetMateria
)。メソッド パラメータ データ型 必須 備考 player_uuid
string
必須
character_uuid
string
必須
TentuPlayKeyword._DUMMY_CHARACTER_ID_
currency_slug
string
必須
gold
currency_quantity
float
必須
30
currency_total_quantity
float
オプション
215
from_entity
オプション
entity.Bonuses
from_category_slug
string
オプション
無料ゴールド広告
from_slug
string
オプション
無料ゴールド広告
-