広告視聴

アプリ内で広告を露出させる場合、以下のような広告関連メソッドを呼び出してください。

全面広告

全面広告を表示する場合、以下のようにWatchAdメソッドを呼び出してください。

ad_type パラメータとしてadType.Interstitialを入力してください。

  • placed_at パラメータは広告が表示されたタイミングを記録します。

  • ad_status パラメータは広告のステータスや広告視聴結果を記録します。

メソッド

パラメータ

データ型

必須

備考

1. 広告露出
（クールタイムの終了）

2. 広告視聴開始

WatchAdd

player_uuid

string

必須

character_uuid

string

必須

TentuPlayKeyword._DUMMY_CHARACTER_ID_

ad_slug

string

必須

広告ID

ad_type

必須

adType.Interstitial

placed_at

必須

entity:StageStart

ad_status

必須

adStatus.Ready

adStatus.Start

placed_at_slug

string

オプション

プレイ

メソッド

パラメータ

データ型

必須

備考

3. 広告視聴完了

4. 広告視聴終了
または中断

WatchAdd

player_uuid

string

必須

character_uuid

string

必須

TentuPlayKeyword._DUMMY_CHARACTER_ID_

ad_slug

string

必須

広告ID

ad_type

必須

adType.Interstitial

placed_at

必須

entity:StageStart

ad_status

必須

adStatus.End

adStatus.Quit

placed_at_slug

string

オプション

プレイ

報酬付き広告

報酬付き広告を表示させるには以下のように関連メソッドを呼び出してください。

  • 広告視聴の段階別に WatchAd メソッドを呼び出してください。

    ad_type パラメータとしてadType.Rewardを入力してください。

    メソッド

    パラメータ

    データ型

    必須

    備考

    1. 広告露出
    （クールタイムの終了）

    2. 広告視聴開始

    WatchAdd

    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. 広告視聴終了
    または中断

    WatchAdd

    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を呼び出してください。

    メソッド パラメータ データ型 必須 備考

    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）。

      メソッド パラメータ データ型 必須 備考

      GetCurrency

      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

      オプション

      無料ゴールド広告