コンソール画面

広告視聴

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

全面広告

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

全面広告の場合、WatchAdメソッドの ad_typeにadType.Interstitialを入力してください。
WatchAdメソッドの placed_atは広告を露出するタイミングを記録します。
WatchAdメソッドの ad_statusは広告の状態や広告視聴の結果を記録します。
より詳しい情報は TPStashEvent.WatchAd をご覧ください。

WatchAd
広告露出(クールタイム終了) 広告視聴開始
player_uuid { player_uuid } { player_uuid }
character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID TentuPlayKeyword.DUMMY_CHARACTER_ID
ad_slug { 広告ID } { 広告ID }
ad_type adType.Interstitial adType.Interstitial
placed_at entity:StageStart entity:StageStart
ad_status adStatus.Ready adStatus.Start
placed_at_slug { プレイ } { プレイ }
placed_at_slug { プレイ } { プレイ }
広告視聴終了 広告視聴の終了・中断
player_uuid { player_uuid } { player_uuid }
character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID TentuPlayKeyword.DUMMY_CHARACTER_ID
ad_slug { 広告ID } { 広告ID }
ad_type adType.Interstitial adType.Interstitial
placed_at entity:StageStart entity:StageStart
ad_status adStatus.End adStatus.Quit
placed_at_slug { プレイ } { プレイ }
placed_at_slug { プレイ } { プレイ }

報酬付き広告

報酬付き広告を露出させる場合、以下のようにWatchAdおよびGetBonus、GetCurrencyメソッドを呼び出してください。

  • 報酬付き広告の場合、WatchAdメソッドの ad_typeにadType.Rewardを入力し、WatchAdを呼び出してください。


    WatchAd
    広告露出(クールタイム終了) 広告視聴開始
    player_uuid { player_uuid } { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID TentuPlayKeyword.DUMMY_CHARACTER_ID
    ad_slug { 広告ID } { 広告ID }
    ad_type adType.Reward adType.Reward
    placed_at entity:StageStart entity:StageStart
    ad_status adStatus.Ready adStatus.Start
    placed_at_slug { プレイ } { プレイ }
    placed_at_slug { プレイ } { プレイ }
    広告視聴終了 広告視聴の終了・中断
    player_uuid { player_uuid } { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID TentuPlayKeyword.DUMMY_CHARACTER_ID
    ad_slug { 広告ID } { 広告ID }
    ad_type adType.Reward adType.Reward
    placed_at entity:StageStart entity:StageStart
    ad_status adStatus.End adStatus.Quit
    placed_at_slug { プレイ } { プレイ }
    placed_at_slug { プレイ } { プレイ }

  • ゲームプレイとは関係ない報酬付き広告を通じて財貨などを獲得する場合、GetBonusメソッドを呼び出してください。

    GetBonus
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    bonus_slug { 無料ゴールド広告 }
    bonus_category_slug { 無料ゴールド広告 }
    is_automated FALSE

  • 広告視聴のリワードとして財貨を獲得する場合、以下のようにGetCurrencyメソッドを呼び出してください。

    広告視聴のリワードとして財貨以外のObject(ex.Token、Material)を獲得する場合、Get{Object Type}メソッドを呼び出してください。
    GetCurrency
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    currency_slug GOLD
    currency_quantity 30
    currency_total_quantity 215
    from_entity entity.Bonuses
    from_category_slug { 無料ゴールド広告 }
    from_slug { 無料ゴールド広告 }