광고 시청

게임 내 광고를 노출하는 경우 아래와 같이 광고 관련 메소드를 호출하세요.

전면 광고

전면광고를 노출하는 경우 아래와 같이 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, GetMaterial).

      메소드 파라미터 자료형 필수여부 비고

      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

      선택

      무료 골드 광고